navs.html 7.06 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
49
50
    <ul class="nav nav-tabs" role="tablist">
      <li class="nav-item active">
        <a href="#" class="nav-link">Active</a>
51
      </li>
52
53
      <li class="nav-item">
        <a href="#" class="nav-link">Link</a>
54
      </li>
55
56
      <li class="nav-item">
        <a href="#" class="nav-link">Another link</a>
57
      </li>
58
59
      <li class="nav-item disabled">
        <a href="#" class="nav-link">Disabled</a>
60
      </li>
Mark Otto's avatar
Mark Otto committed
61
62
63
    </ul>
  </div>
{% highlight html %}
64
65
66
<ul class="nav nav-tabs" role="tablist">
  <li class="nav-item active">
    <a href="#" class="nav-link">Active</a>
67
  </li>
68
69
  <li class="nav-item">
    <a href="#" class="nav-link">Link</a>
70
  </li>
71
72
  <li class="nav-item">
    <a href="#" class="nav-link">Another link</a>
73
  </li>
74
75
  <li class="nav-item disabled">
    <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
88
89
    <ul class="nav nav-pills" role="tablist">
      <li class="nav-item active">
        <a href="#" class="nav-link">Active</a>
90
      </li>
91
92
      <li class="nav-item">
        <a href="#" class="nav-link">Link</a>
93
      </li>
94
95
      <li class="nav-item">
        <a href="#" class="nav-link">Another link</a>
96
      </li>
97
98
      <li class="nav-item disabled">
        <a href="#" class="nav-link">Disabled</a>
99
      </li>
Mark Otto's avatar
Mark Otto committed
100
101
102
    </ul>
  </div>
{% highlight html %}
103
104
105
<ul class="nav nav-pills" role="tablist">
  <li class="nav-item active">
    <a href="#" class="nav-link">Active</a>
106
  </li>
107
108
  <li class="nav-item">
    <a href="#" class="nav-link">Link</a>
109
  </li>
110
111
  <li class="nav-item">
    <a href="#" class="nav-link">Another link</a>
112
  </li>
113
114
  <li class="nav-item disabled">
    <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
123
124
125
126
127
128
129
130
131
132
133
134
    <ul class="nav nav-pills nav-stacked" role="tablist">
      <li class="nav-item active">
        <a href="#" class="nav-link">Active</a>
      </li>
      <li class="nav-item">
        <a href="#" class="nav-link">Link</a>
      </li>
      <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
135
136
137
    </ul>
  </div>
{% highlight html %}
138
<ul class="nav nav-pills nav-stacked" role="tablist">
139
140
141
142
143
144
145
146
147
148
149
150
  <li class="nav-item active">
    <a href="#" class="nav-link">Active</a>
  </li>
  <li class="nav-item">
    <a href="#" class="nav-link">Link</a>
  </li>
  <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
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
162
163
164
165
      <li class="nav-item active">
        <a href="#" class="nav-link">Active</a>
      </li>
      <li class="nav-item">
        <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
175
176
177
178
179
      <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
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
186
  <li class="nav-item">
    <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
201
202
203
204
      <li class="nav-item active">
        <a href="#" class="nav-link">Active</a>
      </li>
      <li class="nav-item">
        <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
225
  <li class="nav-item">
    <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>