update responsive utility docs post-overhaul

diff --git a/docs/assets/scss/docs.scss b/docs/assets/scss/docs.scss
index 8d68e318796380cf449f4881a46fd375d796a083..bf16e82a5e9eb9d0dc57dd28a3ed88abcf2dcc0e 100644 (file)
--- a/docs/assets/scss/docs.scss
+++ b/docs/assets/scss/docs.scss
@@ -1244,10 +1244,7 @@ body {
 .visible-on,
 .hidden-on {
   .col-xs-6 {
-    .hidden-xs,
-    .hidden-sm,
-    .hidden-md,
-    .hidden-lg {
+    > .not-visible {
       color: #999;
       border: 1px solid #ddd;
     }
@@ -1256,10 +1253,7 @@ body {
 .visible-on,
 .hidden-on {
   .col-xs-6 {
-    .visible-xs-block,
-    .visible-sm-block,
-    .visible-md-block,
-    .visible-lg-block {
+    .visible {
       color: #468847;
       background-color: #dff0d8;
       border: 1px solid #d6e9c6;
@@ -1267,6 +1261,32 @@ body {
   }
 }
 
+@include media-breakpoint-only(xs) {
+  .hidden-xs-only {
+    display: none !important;
+  }
+}
+@include media-breakpoint-only(sm) {
+  .hidden-sm-only {
+    display: none !important;
+  }
+}
+@include media-breakpoint-only(md) {
+  .hidden-md-only {
+    display: none !important;
+  }
+}
+@include media-breakpoint-only(lg) {
+  .hidden-lg-only {
+    display: none !important;
+  }
+}
+@include media-breakpoint-only(xl) {
+  .hidden-xl-only {
+    display: none !important;
+  }
+}
+
 //
 // Brand guidelines
 //

diff --git a/docs/layout/media-queries.md b/docs/layout/media-queries.md
index f5d66a4173c512a64f66bb4bdbe900e94b88d24d..d628b4589f2c606deb1996d6e319f71d2b101e00 100644 (file)
--- a/docs/layout/media-queries.md
+++ b/docs/layout/media-queries.md
@@ -7,48 +7,64 @@ Since Bootstrap is designed to be mobile-first, we employ media queries in our C
 
 ### Common queries
 
-Bootstrap uses the following media query ranges in our source Sass files for key breakpoints in our layout, grid system, and components.
+Bootstrap mainly uses the following media query ranges in our source Sass files for key breakpoints in our layout, grid system, and components.
 
 {% highlight scss %}
-/* Extra small devices (phones, less than 768px) */
+/* Extra small devices (portrait phones, less than ???px) */
 /* No media query since this is the default in Bootstrap */
 
-/* Small devices (tablets, 768px and up) */
-@media (min-width: @screen-sm-min) { ... }
+/* Small devices (landscape phones, 34em and up) */
+@media (min-width: 34em) { ... }
 
-/* Medium devices (desktops, 992px and up) */
-@media (min-width: @screen-md-min) { ... }
+/* Medium devices (tablets, 48em and up) */
+@media (min-width: 48em) { ... }
 
-/* Large devices (large desktops, 1200px and up) */
-@media (min-width: @screen-lg-min) { ... }
-{% endhighlight %}
+/* Large devices (desktops, 62em and up) */
+@media (min-width: 62em) { ... }
 
-We occasionally expand on these media queries to include a <code>max-width</code> to limit CSS to a narrower set of devices.
+/* Extra large devices (large desktops, 75em and up) */
+@media (min-width: 75em) { ... }
+{% endhighlight %}
 
+These media queries are available via Sass mixins:
 {% highlight scss %}
-@media (max-width: @screen-xs-max) { ... }
-@media (min-width: @screen-sm-min) and (max-width: @screen-sm-max) { ... }
-@media (min-width: @screen-md-min) and (max-width: @screen-md-max) { ... }
-@media (min-width: @screen-lg-min) { ... }
+@include media-breakpoint-up(xs) { ... }
+@include media-breakpoint-up(sm) { ... }
+@include media-breakpoint-up(md) { ... }
+@include media-breakpoint-up(lg) { ... }
+@include media-breakpoint-up(lxl) { ... }
+
+// Example usage:
+@include media-breakpoint-up(sm) {
+  .some-class {
+    display: block;
+  }
+}
 {% endhighlight %}
 
-### Sass mixins
+We occasionally use media queries that go in the other direction (the given screen size *or smaller*):
+{% highlight scss %}
+/* Extra small devices (portrait phones, less than 34em) */
+@media (max-width: 33.9em) { ... }
+
+/* Small devices (landscape phones, less than 48em) */
+@media (max-width: 47.9em) { ... }
+
+/* Medium devices (tablets, less than 62em) */
+@media (max-width: 61.9em) { ... }
 
-The above media queries are also available via Sass mixins:
+/* Large devices (desktops, less than 75em) */
+@media (max-width: 74.9em) { ... }
+
+/* Extra large devices (large desktops) */
+/* No media query since the extra-large breakpoint has no upper bound on its width */
+{% endhighlight %}
 
+These media queries are available via Sass mixins:
 {% highlight scss %}
-// List of mixins
-@include media-xs { ... }
-@include media-sm { ... }
-@include media-sm-max { ... }
-@include media-md { ... }
-@include media-md-max { ... }
-@include media-lg { ... }
-
-// Usage
-@include media-xs {
-  .element {
-    display: block;
-  }
-}
+@include media-breakpoint-down(xs) { ... }
+@include media-breakpoint-down(sm) { ... }
+@include media-breakpoint-down(md) { ... }
+@include media-breakpoint-down(lg) { ... }
+@include media-breakpoint-down(lxl) { ... }
 {% endhighlight %}

diff --git a/docs/layout/responsive-utilities.md b/docs/layout/responsive-utilities.md
index 472682f6bfdb86bc84855a0da238378bcec26d83..a9dd4cdb0bc46fc793a049a3673a4e2d75749f30 100644 (file)
--- a/docs/layout/responsive-utilities.md
+++ b/docs/layout/responsive-utilities.md
@@ -9,7 +9,11 @@ Try to use these on a limited basis and avoid creating entirely different versio
 
 ##  Available classes
 
-Use a single or combination of the available classes for toggling content across viewport breakpoints.
+* The `.hidden-*-up` classes hide the element when the viewport is at the given breakpoint or wider. For example, `.hidden-md-up` hides an element on medium, large, and extra-large viewports.
+* The `.hidden-*-down` classes hide the element when the viewport is at the given breakpoint or smaller. For example, `.hidden-md-down` hides an element on extra-small, small, and medium viewports).
+* There are no explicit "visible"/"show" responsive utility classes; you make an element visible by simply not hiding it at that breakpoint size.
+* You can combine one `.hidden-*-up` class with one `.hidden-*-down` class to show an element only on a given interval of screen sizes. For example, `.hidden-sm-down.hidden-xl-up` shows the element only on medium and large viewports. Using multiple `.hidden-*-up` classes or multiple `.hidden-*-down` classes is redundant and pointless.
+* These classes don't attempt to accommodate less common cases where an element's visibility can't be expressed as a single contiguous range of viewport breakpoint sizes; you will instead need to use custom CSS in such cases.
 
 <div class="table-responsive">
   <table class="table table-bordered table-striped responsive-utilities">
@@ -18,112 +22,110 @@ Use a single or combination of the available classes for toggling content across
         <th></th>
         <th>
           Extra small devices
-          <small>Phones (&lt;768px)</small>
+          <small>Portrait phones (&lt;34em)</small>
         </th>
         <th>
           Small devices
-          <small>Tablets (&ge;768px)</small>
+          <small>Landscape phones (&ge;34em)</small>
         </th>
         <th>
           Medium devices
-          <small>Desktops (&ge;992px)</small>
+          <small>Tablets (&ge;48em)</small>
         </th>
         <th>
           Large devices
-          <small>Desktops (&ge;1200px)</small>
+          <small>Desktops (&ge;62em)</small>
+        </th>
+        <th>
+          Extra large devices
+          <small>Desktops (&ge;75em)</small>
         </th>
       </tr>
     </thead>
     <tbody>
       <tr>
-        <th scope="row"><code>.visible-xs-*</code></th>
-        <td class="is-visible">Visible</td>
+        <th scope="row"><code>.hidden-xs-down</code></th>
         <td class="is-hidden">Hidden</td>
+        <td class="is-visible">Visible</td>
+        <td class="is-visible">Visible</td>
+        <td class="is-visible">Visible</td>
+        <td class="is-visible">Visible</td>
+      </tr>
+      <tr>
+        <th scope="row"><code>.hidden-sm-down</code></th>
         <td class="is-hidden">Hidden</td>
         <td class="is-hidden">Hidden</td>
+        <td class="is-visible">Visible</td>
+        <td class="is-visible">Visible</td>
+        <td class="is-visible">Visible</td>
       </tr>
       <tr>
-        <th scope="row"><code>.visible-sm-*</code></th>
+        <th scope="row"><code>.hidden-md-down</code></th>
         <td class="is-hidden">Hidden</td>
-        <td class="is-visible">Visible</td>
         <td class="is-hidden">Hidden</td>
         <td class="is-hidden">Hidden</td>
+        <td class="is-visible">Visible</td>
+        <td class="is-visible">Visible</td>
       </tr>
       <tr>
-        <th scope="row"><code>.visible-md-*</code></th>
+        <th scope="row"><code>.hidden-lg-down</code></th>
+        <td class="is-hidden">Hidden</td>
         <td class="is-hidden">Hidden</td>
         <td class="is-hidden">Hidden</td>
-        <td class="is-visible">Visible</td>
         <td class="is-hidden">Hidden</td>
+        <td class="is-visible">Visible</td>
       </tr>
       <tr>
-        <th scope="row"><code>.visible-lg-*</code></th>
+        <th scope="row"><code>.hidden-xl-down</code></th>
+        <td class="is-hidden">Hidden</td>
+        <td class="is-hidden">Hidden</td>
         <td class="is-hidden">Hidden</td>
         <td class="is-hidden">Hidden</td>
         <td class="is-hidden">Hidden</td>
-        <td class="is-visible">Visible</td>
       </tr>
-    </tbody>
-    <tbody>
       <tr>
-        <th scope="row"><code>.hidden-xs</code></th>
+        <th scope="row"><code>.hidden-xs-up</code></th>
+        <td class="is-hidden">Hidden</td>
+        <td class="is-hidden">Hidden</td>
+        <td class="is-hidden">Hidden</td>
+        <td class="is-hidden">Hidden</td>
         <td class="is-hidden">Hidden</td>
-        <td class="is-visible">Visible</td>
-        <td class="is-visible">Visible</td>
-        <td class="is-visible">Visible</td>
       </tr>
       <tr>
-        <th scope="row"><code>.hidden-sm</code></th>
+        <th scope="row"><code>.hidden-sm-up</code></th>
         <td class="is-visible">Visible</td>
         <td class="is-hidden">Hidden</td>
-        <td class="is-visible">Visible</td>
-        <td class="is-visible">Visible</td>
+        <td class="is-hidden">Hidden</td>
+        <td class="is-hidden">Hidden</td>
+        <td class="is-hidden">Hidden</td>
       </tr>
       <tr>
-        <th scope="row"><code>.hidden-md</code></th>
+        <th scope="row"><code>.hidden-md-up</code></th>
         <td class="is-visible">Visible</td>
         <td class="is-visible">Visible</td>
         <td class="is-hidden">Hidden</td>
-        <td class="is-visible">Visible</td>
+        <td class="is-hidden">Hidden</td>
+        <td class="is-hidden">Hidden</td>
       </tr>
       <tr>
-        <th scope="row"><code>.hidden-lg</code></th>
+        <th scope="row"><code>.hidden-lg-up</code></th>
         <td class="is-visible">Visible</td>
         <td class="is-visible">Visible</td>
         <td class="is-visible">Visible</td>
         <td class="is-hidden">Hidden</td>
-      </tr>
-    </tbody>
-  </table>
-</div>
-
-As of v3.2.0, the `.visible-*-*` classes for each breakpoint come in three variations, one for each CSS `display` property value listed below.
-
-<div class="table-responsive">
-  <table class="table table-bordered table-striped">
-    <thead>
-      <tr>
-        <th>Group of classes</th>
-        <th>CSS <code>display</code></th>
-      </tr>
-    </thead>
-    <tbody>
-      <tr>
-        <td><code>.visible-*-block</code></td>
-        <td><code>display: block;</code></td>
-      </tr>
-      <tr>
-        <td><code>.visible-*-inline</code></td>
-        <td><code>display: inline;</code></td>
+        <td class="is-hidden">Hidden</td>
       </tr>
       <tr>
-        <td><code>.visible-*-inline-block</code></td>
-        <td><code>display: inline-block;</code></td>
+        <th scope="row"><code>.hidden-xl-up</code></th>
+        <td class="is-visible">Visible</td>
+        <td class="is-visible">Visible</td>
+        <td class="is-visible">Visible</td>
+        <td class="is-visible">Visible</td>
+        <td class="is-hidden">Hidden</td>
       </tr>
     </tbody>
   </table>
 </div>
-<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>
 
 <h2 id="responsive-utilities-print">Print classes</h2>
 <p>Similar to the regular responsive classes, use these for toggling content for print.</p>
@@ -131,20 +133,26 @@ As of v3.2.0, the `.visible-*-*` classes for each breakpoint come in three varia
   <table class="table table-bordered table-striped responsive-utilities">
     <thead>
       <tr>
-        <th>Classes</th>
+        <th>Class</th>
         <th>Browser</th>
         <th>Print</th>
       </tr>
     </thead>
     <tbody>
       <tr>
-        <th>
-          <code>.visible-print-block</code><br>
-          <code>.visible-print-inline</code><br>
-          <code>.visible-print-inline-block</code>
-        </th>
+        <th><code>.visible-print-block</code></th>
         <td class="is-hidden">Hidden</td>
-        <td class="is-visible">Visible</td>
+        <td class="is-visible">Visible<br>(as <code>display: block</code>)</td>
+      </tr>
+      <tr>
+        <th><code>.visible-print-inline</code></th>
+        <td class="is-hidden">Hidden</td>
+        <td class="is-visible">Visible<br>(as <code>display: inline</code>)</td>
+      </tr>
+      <tr>
+        <th><code>.visible-print-inline-block</code></th>
+        <td class="is-hidden">Hidden</td>
+        <td class="is-visible">Visible<br>(as <code>display: inline-block</code>)</td>
       </tr>
       <tr>
         <th><code>.hidden-print</code></th>
@@ -159,106 +167,63 @@ As of v3.2.0, the `.visible-*-*` classes for each breakpoint come in three varia
 
 Resize your browser or load on different devices to test the responsive utility classes.
 
-### Visible on...
-
 Green checkmarks indicate the element **is visible** in your current viewport.
 
 <div class="row responsive-utilities-test visible-on">
   <div class="col-xs-6 col-sm-3">
-    <span class="hidden-xs">Extra small</span>
-    <span class="visible-xs-block">&#10004; Visible on x-small</span>
+    <span class="hidden-sm-up visible">&#10004; Visible on extra small</span>
+    <span class="hidden-xs-down not-visible">Extra small</span>
   </div>
   <div class="col-xs-6 col-sm-3">
-    <span class="hidden-sm">Small</span>
-    <span class="visible-sm-block">&#10004; Visible on small</span>
+    <span class="hidden-md-up visible">&#10004; Visible on small or narrower</span>
+    <span class="hidden-sm-down not-visible">Small or narrower</span>
   </div>
-  <div class="clearfix visible-xs-block"></div>
   <div class="col-xs-6 col-sm-3">
-    <span class="hidden-md">Medium</span>
-    <span class="visible-md-block">&#10004; Visible on medium</span>
+    <span class="hidden-lg-up visible">&#10004; Visible on medium or narrower</span>
+    <span class="hidden-md-down not-visible">Medium or narrower</span>
   </div>
   <div class="col-xs-6 col-sm-3">
-    <span class="hidden-lg">Large</span>
-    <span class="visible-lg-block">&#10004; Visible on large</span>
+    <span class="hidden-xl-up visible">&#10004; Visible on large or narrower</span>
+    <span class="hidden-lg-down not-visible">Large or narrower</span>
   </div>
 </div>
 <div class="row responsive-utilities-test visible-on">
-  <div class="col-xs-6">
-    <span class="hidden-xs hidden-sm">Extra small and small</span>
-    <span class="visible-xs-block visible-sm-block">&#10004; Visible on x-small and small</span>
-  </div>
-  <div class="col-xs-6">
-    <span class="hidden-md hidden-lg">Medium and large</span>
-    <span class="visible-md-block visible-lg-block">&#10004; Visible on medium and large</span>
-  </div>
-  <div class="clearfix visible-xs-block"></div>
-  <div class="col-xs-6">
-    <span class="hidden-xs hidden-md">Extra small and medium</span>
-    <span class="visible-xs-block visible-md-block">&#10004; Visible on x-small and medium</span>
-  </div>
-  <div class="col-xs-6">
-    <span class="hidden-sm hidden-lg">Small and large</span>
-    <span class="visible-sm-block visible-lg-block">&#10004; Visible on small and large</span>
-  </div>
-  <div class="clearfix visible-xs-block"></div>
-  <div class="col-xs-6">
-    <span class="hidden-xs hidden-lg">Extra small and large</span>
-    <span class="visible-xs-block visible-lg-block">&#10004; Visible on x-small and large</span>
-  </div>
-  <div class="col-xs-6">
-    <span class="hidden-sm hidden-md">Small and medium</span>
-    <span class="visible-sm-block visible-md-block">&#10004; Visible on small and medium</span>
-  </div>
-</div>
-
-### Hidden on...
-
-Here, green checkmarks also indicate the element **is hidden** in your current viewport.
-
-<div class="row responsive-utilities-test hidden-on">
   <div class="col-xs-6 col-sm-3">
-    <span class="hidden-xs">Extra small</span>
-    <span class="visible-xs-block">&#10004; Hidden on x-small</span>
+    <span class="hidden-xs-down visible">&#10004; Visible on small or wider</span>
+    <span class="hidden-sm-up not-visible">Small or wider</span>
   </div>
   <div class="col-xs-6 col-sm-3">
-    <span class="hidden-sm">Small</span>
-    <span class="visible-sm-block">&#10004; Hidden on small</span>
+    <span class="hidden-sm-down visible">&#10004; Visible on medium or wider</span>
+    <span class="hidden-md-up not-visible">Medium or wider</span>
   </div>
-  <div class="clearfix visible-xs-block"></div>
   <div class="col-xs-6 col-sm-3">
-    <span class="hidden-md">Medium</span>
-    <span class="visible-md-block">&#10004; Hidden on medium</span>
+    <span class="hidden-md-down visible">&#10004; Visible on large or wider</span>
+    <span class="hidden-lg-up not-visible">Large or wider</span>
   </div>
   <div class="col-xs-6 col-sm-3">
-    <span class="hidden-lg">Large</span>
-    <span class="visible-lg-block">&#10004; Hidden on large</span>
+    <span class="hidden-lg-down visible">&#10004; Visible on extra large</span>
+    <span class="hidden-xl-up not-visible">Extra large</span>
   </div>
 </div>
-<div class="row responsive-utilities-test hidden-on">
-  <div class="col-xs-6">
-    <span class="hidden-xs hidden-sm">Extra small and small</span>
-    <span class="visible-xs-block visible-sm-block">&#10004; Hidden on x-small and small</span>
-  </div>
-  <div class="col-xs-6">
-    <span class="hidden-md hidden-lg">Medium and large</span>
-    <span class="visible-md-block visible-lg-block">&#10004; Hidden on medium and large</span>
+<div class="row responsive-utilities-test visible-on">
+  <div class="col-xs-6 col-sm-3">
+    <span class="hidden-sm-up visible">&#10004; Your viewport is exactly extra small</span>
+    <span class="hidden-xs-down not-visible">Your viewport is NOT exactly extra small</span>
   </div>
-  <div class="clearfix visible-xs-block"></div>
-  <div class="col-xs-6">
-    <span class="hidden-xs hidden-md">Extra small and medium</span>
-    <span class="visible-xs-block visible-md-block">&#10004; Hidden on x-small and medium</span>
+  <div class="col-xs-6 col-sm-3">
+    <span class="hidden-xs-down hidden-md-up visible">&#10004; Your viewport is exactly small</span>
+    <span class="hidden-sm-only not-visible">Your viewport is NOT exactly small</span>
   </div>
-  <div class="col-xs-6">
-    <span class="hidden-sm hidden-lg">Small and large</span>
-    <span class="visible-sm-block visible-lg-block">&#10004; Hidden on small and large</span>
+  <div class="col-xs-6 col-sm-3">
+    <span class="hidden-sm-down hidden-lg-up visible">&#10004; Your viewport is exactly medium</span>
+    <span class="hidden-md-only not-visible">Your viewport is NOT exactly medium</span>
   </div>
-  <div class="clearfix visible-xs-block"></div>
-  <div class="col-xs-6">
-    <span class="hidden-xs hidden-lg">Extra small and large</span>
-    <span class="visible-xs-block visible-lg-block">&#10004; Hidden on x-small and large</span>
+  <div class="col-xs-6 col-sm-3">
+    <span class="hidden-md-down hidden-xl-up visible">&#10004; Your viewport is exactly large</span>
+    <span class="hidden-lg-only not-visible">Your viewport is NOT exactly large</span>
   </div>
-  <div class="col-xs-6">
-    <span class="hidden-sm hidden-md">Small and medium</span>
-    <span class="visible-sm-block visible-md-block">&#10004; Hidden on small and medium</span>
+  <div class="col-xs-6 col-sm-3">
+    <span class="hidden-lg-down visible">&#10004; Your viewport is exactly extra large</span>
+    <span class="hidden-xl-only not-visible">Your viewport is NOT exactly extra large</span>
   </div>
 </div>

diff --git a/docs/migration.md b/docs/migration.md
index e1fff04e75acf7d9ea5a2328ecf3c274285c4d7e..a03be5dea66ac55716105a42d08746acafb68135 100644 (file)
--- a/docs/migration.md
+++ b/docs/migration.md
@@ -67,7 +67,7 @@ The following deprecated Less/SCSS variables have been removed in v4.0.0:
 * `@screen-xs`, `@screen-xs-min`. The extra small breakpoint has no lower bound, so these variables were logically absurd. Reformulate your expression in terms of `$screen-xs-max` instead.
 * `@grid-float-breakpoint`
 
-The responsive utility classes have been overhauled. The old classes (`.hidden-xs` `.hidden-sm` `.hidden-md` `.hidden-lg` `.visible-xs-block` `.visible-xs-inline` `.visible-xs-inline-block` `.visible-sm-block` `.visible-sm-inline` `.visible-sm-inline-block` `.visible-md-block` `.visible-md-inline` `.visible-md-inline-block` `.visible-lg-block` `.visible-lg-inline` `.visible-lg-inline-block`) are gone. They have been replaced by `.hidden-xs-up` `.hidden-xs-down` `.hidden-sm-up` `.hidden-sm-down` `.hidden-md-up` `.hidden-md-down` `.hidden-lg-up` `.hidden-lg-down`. The `.hidden-*-up` classes hide the element when the viewport is at the given breakpoint or wider (e.g. `.hidden-md-up` hides an element on medium, large, and extra-large devices). The `.hidden-*-down` classes hide the element when the viewport is at the given breakpoint or smaller (e.g. `.hidden-md-down` hides an element on extra-small, small, and medium devices). Rather than using explicit `.visible-*` classes, you make an element visible by simply not hiding it at that screen size. You can combine one `.hidden-*-up` class with one `.hidden-*-down` class to show an element only on a given interval of screen sizes (e.g. `.hidden-sm-down.hidden-xl-up` shows the element only on medium and large devices). Note that the changes to the grid breakpoints in v4 means that you'll need to go one breakpoint larger to achieve the same results (e.g. `.hidden-md` is more similar to `.hidden-lg-down` than to `.hidden-md-down`). .The new responsive utility classes don't attempt to accommodate less common cases where an element's visibility can't be expressed as a single contiguous range of viewport sizes; you will instead need to custom CSS in such cases.
+The responsive utility classes have been overhauled. The old classes (`.hidden-xs` `.hidden-sm` `.hidden-md` `.hidden-lg` `.visible-xs-block` `.visible-xs-inline` `.visible-xs-inline-block` `.visible-sm-block` `.visible-sm-inline` `.visible-sm-inline-block` `.visible-md-block` `.visible-md-inline` `.visible-md-inline-block` `.visible-lg-block` `.visible-lg-inline` `.visible-lg-inline-block`) are gone. They have been replaced by `.hidden-xs-up` `.hidden-xs-down` `.hidden-sm-up` `.hidden-sm-down` `.hidden-md-up` `.hidden-md-down` `.hidden-lg-up` `.hidden-lg-down`. The `.hidden-*-up` classes hide the element when the viewport is at the given breakpoint or wider (e.g. `.hidden-md-up` hides an element on medium, large, and extra-large devices). The `.hidden-*-down` classes hide the element when the viewport is at the given breakpoint or smaller (e.g. `.hidden-md-down` hides an element on extra-small, small, and medium devices). Rather than using explicit `.visible-*` classes, you make an element visible by simply not hiding it at that screen size. You can combine one `.hidden-*-up` class with one `.hidden-*-down` class to show an element only on a given interval of screen sizes (e.g. `.hidden-sm-down.hidden-xl-up` shows the element only on medium and large devices). Note that the changes to the grid breakpoints in v4 means that you'll need to go one breakpoint larger to achieve the same results (e.g. `.hidden-md` is more similar to `.hidden-lg-down` than to `.hidden-md-down`). .The new responsive utility classes don't attempt to accommodate less common cases where an element's visibility can't be expressed as a single contiguous range of viewport sizes; you will instead need to use custom CSS in such cases.
 
 ## Misc notes to prioritize