Add vertical-align utilities

- Adds six new utils for vertical-align property
- Documents the additional classes in the utils docs

diff --git a/docs/_data/nav.yml b/docs/_data/nav.yml
index 9e3e5536799d17b5b46f8eef3bc43fd2cca4a2e5..f89a136f8c9745af678eca90d8f8d7eaf5434c09 100644 (file)
--- a/docs/_data/nav.yml
+++ b/docs/_data/nav.yml
@@ -66,6 +66,7 @@
     - title: Sizing and positioning
     - title: Spacing
     - title: Typography
+    - title: Vertical align
 
 # - title: Extend
 #   pages:

diff --git a/docs/utilities/vertical-align.md b/docs/utilities/vertical-align.md
new file mode 100644 (file)
index 0000000..8e03e58
--- /dev/null
+++ b/docs/utilities/vertical-align.md
@@ -0,0 +1,33 @@
+---
+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;">
+  <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>
+</table>
+{% endexample %}

diff --git a/scss/_utilities.scss b/scss/_utilities.scss
index aef99aeba68f062682ac49eb0a2d7f9115969b28..c63e50600dd8d1d073153694f3797f9ea8d3491e 100644 (file)
--- a/scss/_utilities.scss
+++ b/scss/_utilities.scss
@@ -1,3 +1,4 @@
+@import "utilities/align";
 @import "utilities/background";
 @import "utilities/borders";
 @import "utilities/clearfix";

diff --git a/scss/utilities/_align.scss b/scss/utilities/_align.scss
new file mode 100644 (file)
index 0000000..4886e05
--- /dev/null
+++ b/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; }