Merge pull request #20932 from twbs/align-utils

Add vertical-align utilities

docs/_data/nav.yml

@@ -66,6 +66,7 @@
     - title: Sizing and positioning
     - title: Spacing
     - title: Typography
+    - title: Vertical align
 
 # - title: Extend
 #   pages:

docs/utilities/vertical-align.md

@@ -0,0 +1,37 @@
+---
+layout: docs
+title: Vertical alignment
+group: utilities
+---
+
+Change the alignment of elements with the [`vertical-alignment`](https://developer.mozilla.org/en-US/docs/Web/CSS/vertical-align) utilities. Please note that vertical-align only affects inline, inline-block, inline-table, and table cell elements.
+
+Choose from  `.align-baseline`, `.align-top`, `.align-middle`, `.align-bottom`, `.align-text-bottom`, and `.align-text-top` as needed.
+
+With inline elements:
+
+{% example html %}
+<span class="align-baseline">baseline</span>
+<span class="align-top">top</span>
+<span class="align-middle">middle</span>
+<span class="align-bottom">bottom</span>
+<span class="align-text-top">text-top</span>
+<span class="align-text-bottom">text-bottom</span>
+{% endexample %}
+
+With table cells:
+
+{% example html %}
+<table style="height: 100px;">
+  <tbody>
+    <tr>
+      <td class="align-baseline">baseline</td>
+      <td class="align-top">top</td>
+      <td class="align-middle">middle</td>
+      <td class="align-bottom">bottom</td>
+      <td class="align-text-top">text-top</td>
+      <td class="align-text-bottom">text-bottom</td>
+    </tr>
+  </tbody>
+</table>
+{% endexample %}

scss/_utilities.scss

@@ -1,3 +1,4 @@
+@import "utilities/align";
 @import "utilities/background";
 @import "utilities/borders";
 @import "utilities/clearfix";

scss/utilities/_align.scss

@@ -0,0 +1,6 @@
+.align-baseline { vertical-align: baseline !important; } // Browser default
+.align-top { vertical-align: top !important; }
+.align-middle { vertical-align: middle !important; }
+.align-bottom { vertical-align: bottom !important; }
+.align-text-bottom { vertical-align: text-bottom !important; }
+.align-text-top { vertical-align: text-top !important; }