1 <div class="bs-docs-section">
2 <h1 id="responsive-utilities" class="page-header">Responsive utilities</h1>
4 <p class="lead">For faster mobile-friendly development, use these utility classes for showing and hiding content by device via media query. Also included are utility classes for toggling content when printed.</p>
5 <p>Try to use these on a limited basis and avoid creating entirely different versions of the same site. Instead, use them to complement each device's presentation.</p>
8 <h2 id="responsive-utilities-classes">Available classes</h2>
9 <p>Use a single or combination of the available classes for toggling content across viewport breakpoints.</p>
10 <div class="table-responsive">
11 <table class="table table-bordered table-striped responsive-utilities">
17 <small>Phones (<768px)</small>
21 <small>Tablets (≥768px)</small>
25 <small>Desktops (≥992px)</small>
29 <small>Desktops (≥1200px)</small>
35 <th scope="row"><code>.visible-xs-*</code></th>
36 <td class="is-visible">Visible</td>
37 <td class="is-hidden">Hidden</td>
38 <td class="is-hidden">Hidden</td>
39 <td class="is-hidden">Hidden</td>
42 <th scope="row"><code>.visible-sm-*</code></th>
43 <td class="is-hidden">Hidden</td>
44 <td class="is-visible">Visible</td>
45 <td class="is-hidden">Hidden</td>
46 <td class="is-hidden">Hidden</td>
49 <th scope="row"><code>.visible-md-*</code></th>
50 <td class="is-hidden">Hidden</td>
51 <td class="is-hidden">Hidden</td>
52 <td class="is-visible">Visible</td>
53 <td class="is-hidden">Hidden</td>
56 <th scope="row"><code>.visible-lg-*</code></th>
57 <td class="is-hidden">Hidden</td>
58 <td class="is-hidden">Hidden</td>
59 <td class="is-hidden">Hidden</td>
60 <td class="is-visible">Visible</td>
65 <th scope="row"><code>.hidden-xs</code></th>
66 <td class="is-hidden">Hidden</td>
67 <td class="is-visible">Visible</td>
68 <td class="is-visible">Visible</td>
69 <td class="is-visible">Visible</td>
72 <th scope="row"><code>.hidden-sm</code></th>
73 <td class="is-visible">Visible</td>
74 <td class="is-hidden">Hidden</td>
75 <td class="is-visible">Visible</td>
76 <td class="is-visible">Visible</td>
79 <th scope="row"><code>.hidden-md</code></th>
80 <td class="is-visible">Visible</td>
81 <td class="is-visible">Visible</td>
82 <td class="is-hidden">Hidden</td>
83 <td class="is-visible">Visible</td>
86 <th scope="row"><code>.hidden-lg</code></th>
87 <td class="is-visible">Visible</td>
88 <td class="is-visible">Visible</td>
89 <td class="is-visible">Visible</td>
90 <td class="is-hidden">Hidden</td>
96 <p>As of v3.2.0, the <code>.visible-*-*</code> classes for each breakpoint come in three variations, one for each CSS <code>display</code> property value listed below.</p>
97 <div class="table-responsive">
98 <table class="table table-bordered table-striped">
101 <th>Group of classes</th>
102 <th>CSS <code>display</code></th>
107 <th scope="row"><code>.visible-*-block</code></th>
108 <td><code>display: block;</code></td>
111 <th scope="row"><code>.visible-*-inline</code></th>
112 <td><code>display: inline;</code></td>
115 <th scope="row"><code>.visible-*-inline-block</code></th>
116 <td><code>display: inline-block;</code></td>
121 <p>So, for extra small (<code>xs</code>) screens for example, the available <code>.visible-*-*</code> classes are: <code>.visible-xs-block</code>, <code>.visible-xs-inline</code>, and <code>.visible-xs-inline-block</code>.</p>
122 <p>The classes <code>.visible-xs</code>, <code>.visible-sm</code>, <code>.visible-md</code>, and <code>.visible-lg</code> also exist, but are <strong>deprecated as of v3.2.0</strong>. They are approximately equivalent to <code>.visible-*-block</code>, except with additional special cases for toggling <code><table></code>-related elements.</p>
124 <h2 id="responsive-utilities-print">Print classes</h2>
125 <p>Similar to the regular responsive classes, use these for toggling content for print.</p>
126 <div class="table-responsive">
127 <table class="table table-bordered table-striped responsive-utilities">
138 <code>.visible-print-block</code><br>
139 <code>.visible-print-inline</code><br>
140 <code>.visible-print-inline-block</code>
142 <td class="is-hidden">Hidden</td>
143 <td class="is-visible">Visible</td>
146 <th scope="row"><code>.hidden-print</code></th>
147 <td class="is-visible">Visible</td>
148 <td class="is-hidden">Hidden</td>
153 <p>The class <code>.visible-print</code> also exists but is <strong>deprecated</strong> as of v3.2.0. It is approximately equivalent to <code>.visible-print-block</code>, except with additional special cases for <code><table></code>-related elements.</p>
156 <h2 id="responsive-utilities-tests">Test cases</h2>
157 <p>Resize your browser or load on different devices to test the responsive utility classes.</p>
159 <h3>Visible on...</h3>
160 <p>Green checkmarks indicate the element <strong>is visible</strong> in your current viewport.</p>
161 <div class="row responsive-utilities-test visible-on">
162 <div class="col-xs-6 col-sm-3">
163 <span class="hidden-xs">Extra small</span>
164 <span class="visible-xs-block">✔ Visible on x-small</span>
166 <div class="col-xs-6 col-sm-3">
167 <span class="hidden-sm">Small</span>
168 <span class="visible-sm-block">✔ Visible on small</span>
170 <div class="clearfix visible-xs-block"></div>
171 <div class="col-xs-6 col-sm-3">
172 <span class="hidden-md">Medium</span>
173 <span class="visible-md-block">✔ Visible on medium</span>
175 <div class="col-xs-6 col-sm-3">
176 <span class="hidden-lg">Large</span>
177 <span class="visible-lg-block">✔ Visible on large</span>
180 <div class="row responsive-utilities-test visible-on">
181 <div class="col-xs-6">
182 <span class="hidden-xs hidden-sm">Extra small and small</span>
183 <span class="visible-xs-block visible-sm-block">✔ Visible on x-small and small</span>
185 <div class="col-xs-6">
186 <span class="hidden-md hidden-lg">Medium and large</span>
187 <span class="visible-md-block visible-lg-block">✔ Visible on medium and large</span>
189 <div class="clearfix visible-xs-block"></div>
190 <div class="col-xs-6">
191 <span class="hidden-xs hidden-md">Extra small and medium</span>
192 <span class="visible-xs-block visible-md-block">✔ Visible on x-small and medium</span>
194 <div class="col-xs-6">
195 <span class="hidden-sm hidden-lg">Small and large</span>
196 <span class="visible-sm-block visible-lg-block">✔ Visible on small and large</span>
198 <div class="clearfix visible-xs-block"></div>
199 <div class="col-xs-6">
200 <span class="hidden-xs hidden-lg">Extra small and large</span>
201 <span class="visible-xs-block visible-lg-block">✔ Visible on x-small and large</span>
203 <div class="col-xs-6">
204 <span class="hidden-sm hidden-md">Small and medium</span>
205 <span class="visible-sm-block visible-md-block">✔ Visible on small and medium</span>
209 <h3>Hidden on...</h3>
210 <p>Here, green checkmarks also indicate the element <strong>is hidden</strong> in your current viewport.</p>
211 <div class="row responsive-utilities-test hidden-on">
212 <div class="col-xs-6 col-sm-3">
213 <span class="hidden-xs">Extra small</span>
214 <span class="visible-xs-block">✔ Hidden on x-small</span>
216 <div class="col-xs-6 col-sm-3">
217 <span class="hidden-sm">Small</span>
218 <span class="visible-sm-block">✔ Hidden on small</span>
220 <div class="clearfix visible-xs-block"></div>
221 <div class="col-xs-6 col-sm-3">
222 <span class="hidden-md">Medium</span>
223 <span class="visible-md-block">✔ Hidden on medium</span>
225 <div class="col-xs-6 col-sm-3">
226 <span class="hidden-lg">Large</span>
227 <span class="visible-lg-block">✔ Hidden on large</span>
230 <div class="row responsive-utilities-test hidden-on">
231 <div class="col-xs-6">
232 <span class="hidden-xs hidden-sm">Extra small and small</span>
233 <span class="visible-xs-block visible-sm-block">✔ Hidden on x-small and small</span>
235 <div class="col-xs-6">
236 <span class="hidden-md hidden-lg">Medium and large</span>
237 <span class="visible-md-block visible-lg-block">✔ Hidden on medium and large</span>
239 <div class="clearfix visible-xs-block"></div>
240 <div class="col-xs-6">
241 <span class="hidden-xs hidden-md">Extra small and medium</span>
242 <span class="visible-xs-block visible-md-block">✔ Hidden on x-small and medium</span>
244 <div class="col-xs-6">
245 <span class="hidden-sm hidden-lg">Small and large</span>
246 <span class="visible-sm-block visible-lg-block">✔ Hidden on small and large</span>
248 <div class="clearfix visible-xs-block"></div>
249 <div class="col-xs-6">
250 <span class="hidden-xs hidden-lg">Extra small and large</span>
251 <span class="visible-xs-block visible-lg-block">✔ Hidden on x-small and large</span>
253 <div class="col-xs-6">
254 <span class="hidden-sm hidden-md">Small and medium</span>
255 <span class="visible-sm-block visible-md-block">✔ Hidden on small and medium</span>