diff --git a/docs/_data/nav.yml b/docs/_data/nav.yml index 4712fc5c97..3be2479ea5 100644 --- a/docs/_data/nav.yml +++ b/docs/_data/nav.yml @@ -132,6 +132,18 @@ - title: Carousel - title: Responsive embed - title: Utilities + sections: + - title: Text alignment + - title: Text transform + - title: Contextual colors + - title: Contextual backgrounds + - title: Close icon + - title: Floats + - title: Center content + - title: Hidden content + - title: Invisible content + - title: Screen readers + - title: Image replacement - title: Examples pages: diff --git a/docs/components/utilities.md b/docs/components/utilities.md index e6d79db8f8..0d6fe2595a 100644 --- a/docs/components/utilities.md +++ b/docs/components/utilities.md @@ -3,6 +3,30 @@ layout: page title: Utility classes --- +Bootstrap includes dozens of utilities—classes with a single purpose. They're designed to keep the number of declarations in your CSS down while allowing for quick and easy development. + +### Text alignment + +Easily realign text to components with text alignment classes. + +{% example html %} +

Left aligned text.

+

Center aligned text.

+

Right aligned text.

+

Justified text.

+

No wrap text.

+{% endexample %} + +### Text transform + +Transform text in components with text capitalization classes. + +{% example html %} +

Lowercased text.

+

Uppercased text.

+

Capitalized text.

+{% endexample %} + ### Contextual colors Convey meaning through color with a handful of emphasis utility classes. These may also be applied to links and will darken on hover just like our default link styles. @@ -63,7 +87,7 @@ Use a generic close icon for dismissing content like modals and alerts. **Be sur {% endexample %} -### Quick floats +### Floats Float an element to the left or right with a class. `!important` is included to avoid specificity issues. Classes can also be used as mixins. @@ -90,7 +114,7 @@ Float an element to the left or right with a class. `!important` is included to } {% endhighlight %} -### Center content blocks +### Center content Set an element to `display: block;` and center via `margin`. Available as a mixin and class. @@ -167,7 +191,7 @@ The `.invisible` class can be used to toggle only the visibility of an element, } {% endhighlight %} -### Screen readers and keyboard navigation +### Screen readers Hide an element to all devices **except screen readers** with `.sr-only`. Combine `.sr-only` with `.sr-only-focusable` to show the element again when it's focused (e.g. by a keyboard-only user). Necessary for following [accessibility best practices](../getting-started/#accessibility). Can also be used as mixins. diff --git a/docs/content/typography.md b/docs/content/typography.md index 6f2db81533..ece703adc5 100644 --- a/docs/content/typography.md +++ b/docs/content/typography.md @@ -133,28 +133,6 @@ Styling for common inline HTML5 elements. While not shown above, feel free to use `` and `` in HTML5. `` is meant to highlight words or phrases without conveying additional importance while `` is mostly for voice, technical terms, etc. -## Alignment classes - -Easily realign text to components with text alignment classes. - -{% example html %} -

Left aligned text.

-

Center aligned text.

-

Right aligned text.

-

Justified text.

-

No wrap text.

-{% endexample %} - -## Transformation classes - -Transform text in components with text capitalization classes. - -{% example html %} -

Lowercased text.

-

Uppercased text.

-

Capitalized text.

-{% endexample %} - ## Abbreviations Stylized implementation of HTML's `` element for abbreviations and acronyms to show the expanded version on hover. Abbreviations with a `title` attribute have a light dotted bottom border and a help cursor on hover, providing additional context on hover and to users of assistive technologies.