navs.html 7.68 KB
Newer Older
Mark Otto's avatar
Mark Otto committed
1
2
3
<div class="bs-docs-section">
  <h1 id="nav" class="page-header">Navs</h1>

4
  <p class="lead">Navigation available in Bootstrap share general markup and styles, from the base <code>.nav</code> class to the active and disabled states. Swap modifier classes to switch between each style.</p>
Mark Otto's avatar
Mark Otto committed
5

6
7
  <h2 id="nav-base">Base nav</h2>
  <p>Roll your own navigation style by extending the base <code>.nav</code> component. All Bootstrap's nav components are built on top of this. Includes styles for the disabled state, but <strong>not the active state</strong>.</p>
8
9

{% example html %}
10
11
12
13
14
15
16
17
18
19
20
21
22
23
<ul class="nav" role="tablist">
  <li class="nav-item">
    <a class="nav-link" href="#">Link</a>
  </li>
  <li class="nav-item">
    <a class="nav-link" href="#">Link</a>
  </li>
  <li class="nav-item">
    <a class="nav-link" href="#">Another link</a>
  </li>
  <li class="nav-item disabled">
    <a class="nav-link" href="#">Disabled</a>
  </li>
</ul>
24
{% endexample %}
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

  <p>Classes are used so your markup can be super flexible.</p>
  <div class="bs-example">
    <nav class="nav" role="tablist">
      <a class="nav-link active" href="#">Active</a>
      <a class="nav-link" href="#">Link</a>
      <a class="nav-link" href="#">Another link</a>
      <a class="nav-link disabled" href="#">Disabled</a>
    </nav>
  </div>
{% highlight html %}
<nav class="nav" role="tablist">
  <a class="nav-link active" href="#">Active</a>
  <a class="nav-link" href="#">Link</a>
  <a class="nav-link" href="#">Another link</a>
  <a class="nav-link disabled" href="#">Disabled</a>
</nav>
{% endhighlight %}

44

Mark Otto's avatar
Mark Otto committed
45
  <h2 id="nav-tabs">Tabs</h2>
46
  <p>Takes the basic nav from above and adds the <code>.nav-tabs</code> class to generate a tabbed interface.</p>
Mark Otto's avatar
Mark Otto committed
47
  <div class="bs-example">
48
    <ul class="nav nav-tabs" role="tablist">
Mark Otto's avatar
Mark Otto committed
49
      <li role="presentation" class="nav-item active">
50
        <a href="#" class="nav-link">Active</a>
51
      </li>
Mark Otto's avatar
Mark Otto committed
52
      <li role="presentation" class="nav-item">
53
        <a href="#" class="nav-link">Link</a>
54
      </li>
Mark Otto's avatar
Mark Otto committed
55
      <li role="presentation" class="nav-item">
56
        <a href="#" class="nav-link">Another link</a>
57
      </li>
Mark Otto's avatar
Mark Otto committed
58
      <li role="presentation" class="nav-item disabled">
59
        <a href="#" class="nav-link">Disabled</a>
60
      </li>
Mark Otto's avatar
Mark Otto committed
61
62
63
    </ul>
  </div>
{% highlight html %}
64
<ul class="nav nav-tabs" role="tablist">
Mark Otto's avatar
Mark Otto committed
65
  <li role="presentation" class="nav-item active">
66
    <a href="#" class="nav-link">Active</a>
67
  </li>
Mark Otto's avatar
Mark Otto committed
68
  <li role="presentation" class="nav-item">
69
    <a href="#" class="nav-link">Link</a>
70
  </li>
Mark Otto's avatar
Mark Otto committed
71
  <li role="presentation" class="nav-item">
72
    <a href="#" class="nav-link">Another link</a>
73
  </li>
Mark Otto's avatar
Mark Otto committed
74
  <li role="presentation" class="nav-item disabled">
75
    <a href="#" class="nav-link">Disabled</a>
76
  </li>
Mark Otto's avatar
Mark Otto committed
77
78
79
80
81
82
83
84
85
86
</ul>
{% endhighlight %}
  <div class="bs-callout bs-callout-info">
    <h4>Requires JavaScript tabs plugin</h4>
    <p>For tabs with tabbable areas, you must use the <a href="../javascript/#tabs">tabs JavaScript plugin</a>.</p>
  </div>

  <h2 id="nav-pills">Pills</h2>
  <p>Take that same HTML, but use <code>.nav-pills</code> instead:</p>
  <div class="bs-example">
87
    <ul class="nav nav-pills" role="tablist">
Mark Otto's avatar
Mark Otto committed
88
      <li role="presentation" class="nav-item active">
89
        <a href="#" class="nav-link">Active</a>
90
      </li>
Mark Otto's avatar
Mark Otto committed
91
      <li role="presentation" class="nav-item">
92
        <a href="#" class="nav-link">Link</a>
93
      </li>
Mark Otto's avatar
Mark Otto committed
94
      <li role="presentation" class="nav-item">
95
        <a href="#" class="nav-link">Another link</a>
96
      </li>
Mark Otto's avatar
Mark Otto committed
97
      <li role="presentation" class="nav-item disabled">
98
        <a href="#" class="nav-link">Disabled</a>
99
      </li>
Mark Otto's avatar
Mark Otto committed
100
101
102
    </ul>
  </div>
{% highlight html %}
103
<ul class="nav nav-pills" role="tablist">
Mark Otto's avatar
Mark Otto committed
104
  <li role="presentation" class="nav-item active">
105
    <a href="#" class="nav-link">Active</a>
106
  </li>
Mark Otto's avatar
Mark Otto committed
107
  <li role="presentation" class="nav-item">
108
    <a href="#" class="nav-link">Link</a>
109
  </li>
Mark Otto's avatar
Mark Otto committed
110
  <li role="presentation" class="nav-item">
111
    <a href="#" class="nav-link">Another link</a>
112
  </li>
Mark Otto's avatar
Mark Otto committed
113
  <li role="presentation" class="nav-item disabled">
114
    <a href="#" class="nav-link">Disabled</a>
115
  </li>
Mark Otto's avatar
Mark Otto committed
116
117
</ul>
{% endhighlight %}
118

119
120
  <h2 id="nav-pills-stacked">Stacked pills</h2>
  <p>Just add <code>.nav-stacked</code>.</p>
Mark Otto's avatar
Mark Otto committed
121
  <div class="bs-example">
122
    <ul class="nav nav-pills nav-stacked" role="tablist">
Mark Otto's avatar
Mark Otto committed
123
      <li role="presentation" class="nav-item active">
124
125
        <a href="#" class="nav-link">Active</a>
      </li>
Mark Otto's avatar
Mark Otto committed
126
      <li role="presentation" class="nav-item">
127
128
        <a href="#" class="nav-link">Link</a>
      </li>
Mark Otto's avatar
Mark Otto committed
129
      <li role="presentation" class="nav-item">
130
131
        <a href="#" class="nav-link">Another link</a>
      </li>
Mark Otto's avatar
Mark Otto committed
132
      <li role="presentation" class="nav-item disabled">
133
134
        <a href="#" class="nav-link">Disabled</a>
      </li>
Mark Otto's avatar
Mark Otto committed
135
136
137
    </ul>
  </div>
{% highlight html %}
138
<ul class="nav nav-pills nav-stacked" role="tablist">
Mark Otto's avatar
Mark Otto committed
139
  <li role="presentation" class="nav-item active">
140
141
    <a href="#" class="nav-link">Active</a>
  </li>
Mark Otto's avatar
Mark Otto committed
142
  <li role="presentation" class="nav-item">
143
144
    <a href="#" class="nav-link">Link</a>
  </li>
Mark Otto's avatar
Mark Otto committed
145
  <li role="presentation" class="nav-item">
146
147
    <a href="#" class="nav-link">Another link</a>
  </li>
Mark Otto's avatar
Mark Otto committed
148
  <li role="presentation" class="nav-item disabled">
149
150
    <a href="#" class="nav-link">Disabled</a>
  </li>
Mark Otto's avatar
Mark Otto committed
151
152
153
154
155
156
157
158
159
</ul>
{% endhighlight %}


  <h2 id="nav-dropdowns">Using dropdowns</h2>
  <p>Add dropdown menus with a little extra HTML and the <a href="../javascript/#dropdowns">dropdowns JavaScript plugin</a>.</p>

  <h3>Tabs with dropdowns</h3>
  <div class="bs-example">
160
    <ul class="nav nav-tabs" role="tablist">
Mark Otto's avatar
Mark Otto committed
161
      <li role="presentation" class="nav-item active">
Mark Otto's avatar
Mark Otto committed
162
163
        <a href="#" class="nav-link">Active</a>
      </li>
Mark Otto's avatar
Mark Otto committed
164
      <li role="presentation" class="nav-item">
Mark Otto's avatar
Mark Otto committed
165
        <a class="nav-link dropdown-toggle" data-toggle="dropdown" href="#">Dropdown</a>
Mark Otto's avatar
Mark Otto committed
166
167
168
169
170
171
172
173
        <ul class="dropdown-menu" role="menu">
          <li><a href="#">Action</a></li>
          <li><a href="#">Another action</a></li>
          <li><a href="#">Something else here</a></li>
          <li class="divider"></li>
          <li><a href="#">Separated link</a></li>
        </ul>
      </li>
Mark Otto's avatar
Mark Otto committed
174
      <li role="presentation" class="nav-item">
Mark Otto's avatar
Mark Otto committed
175
176
        <a href="#" class="nav-link">Another link</a>
      </li>
Mark Otto's avatar
Mark Otto committed
177
      <li role="presentation" class="nav-item disabled">
Mark Otto's avatar
Mark Otto committed
178
179
        <a href="#" class="nav-link">Disabled</a>
      </li>
Mark Otto's avatar
Mark Otto committed
180
181
182
    </ul>
  </div>
{% highlight html %}
183
<ul class="nav nav-tabs" role="tablist">
Mark Otto's avatar
Mark Otto committed
184
  ...
Mark Otto's avatar
Mark Otto committed
185
  <li role="presentation" class="nav-item">
Mark Otto's avatar
Mark Otto committed
186
    <a class="nav-link dropdown-toggle" data-toggle="dropdown" href="#">
187
      Dropdown
Mark Otto's avatar
Mark Otto committed
188
    </a>
189
    <ul class="dropdown-menu" role="menu">
Mark Otto's avatar
Mark Otto committed
190
191
192
193
194
195
196
197
198
      ...
    </ul>
  </li>
  ...
</ul>
{% endhighlight %}

  <h3>Pills with dropdowns</h3>
  <div class="bs-example">
199
    <ul class="nav nav-pills" role="tablist">
Mark Otto's avatar
Mark Otto committed
200
      <li role="presentation" class="nav-item active">
Mark Otto's avatar
Mark Otto committed
201
202
        <a href="#" class="nav-link">Active</a>
      </li>
Mark Otto's avatar
Mark Otto committed
203
      <li role="presentation" class="nav-item">
Mark Otto's avatar
Mark Otto committed
204
        <a class="nav-link dropdown-toggle" data-toggle="dropdown" href="#">Dropdown</a>
Mark Otto's avatar
Mark Otto committed
205
206
207
208
209
210
211
212
        <ul class="dropdown-menu" role="menu">
          <li><a href="#">Action</a></li>
          <li><a href="#">Another action</a></li>
          <li><a href="#">Something else here</a></li>
          <li class="divider"></li>
          <li><a href="#">Separated link</a></li>
        </ul>
      </li>
Mark Otto's avatar
Mark Otto committed
213
214
215
216
217
218
      <li class="nav-item">
        <a href="#" class="nav-link">Another link</a>
      </li>
      <li class="nav-item disabled">
        <a href="#" class="nav-link">Disabled</a>
      </li>
Mark Otto's avatar
Mark Otto committed
219
    </ul>
Mark Otto's avatar
Mark Otto committed
220
  </div>
Mark Otto's avatar
Mark Otto committed
221
{% highlight html %}
222
<ul class="nav nav-pills" role="tablist">
Mark Otto's avatar
Mark Otto committed
223
  ...
Mark Otto's avatar
Mark Otto committed
224
  <li role="presentation" class="nav-item">
Mark Otto's avatar
Mark Otto committed
225
    <a class="nav-link dropdown-toggle" data-toggle="dropdown" href="#">
226
      Dropdown
Mark Otto's avatar
Mark Otto committed
227
    </a>
228
    <ul class="dropdown-menu" role="menu">
Mark Otto's avatar
Mark Otto committed
229
230
231
232
233
234
235
      ...
    </ul>
  </li>
  ...
</ul>
{% endhighlight %}
</div>