From 62a129184d144de67349ff300a315c42dadc8712 Mon Sep 17 00:00:00 2001
From: Mark Otto <markdotto@gmail.com>
Date: Tue, 18 Oct 2016 19:15:58 -0700
Subject: [PATCH] Add vertical-align utilities

- Adds six new utils for vertical-align property
- Documents the additional classes in the utils docs
---
 docs/_data/nav.yml               |  1 +
 docs/utilities/vertical-align.md | 33 ++++++++++++++++++++++++++++++++
 scss/_utilities.scss             |  1 +
 scss/utilities/_align.scss       |  6 ++++++
 4 files changed, 41 insertions(+)
 create mode 100644 docs/utilities/vertical-align.md
 create mode 100644 scss/utilities/_align.scss

diff --git a/docs/_data/nav.yml b/docs/_data/nav.yml
index 9e3e553679..f89a136f8c 100644
--- 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
index 0000000000..8e03e58a61
--- /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 aef99aeba6..c63e50600d 100644
--- 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
index 0000000000..4886e059fe
--- /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; }