13 KiB
| layout | title | group |
|---|---|---|
| docs | Utility classes | components |
[//]: # DO NOT EDIT IT WILL BE OVERWRITTEN - copy of bootstrap documentation generated by grunt docs-copy-bootstrap-docs
{% callout info %} Bootstrap Reference Documentation This is reference documentation from Bootstrap. It is being rendered with Material Design for Bootstrap to demonstrate default styling. See addons(TODO: add link) for additional Material Design elements. {% endcallout %}
Bootstrap includes dozens of utilities—classes with a single purpose. They're designed to reduce the frequency of highly repetitive declarations in your CSS while allowing for quick and easy development.
Contents
- Will be replaced with the ToC, excluding the "Contents" header {:toc}
Spacing
Assign margin or padding to an element or a subset of its sides with shorthand classes. Includes support for individual properties, all properties, and vertical and horizontal properties. All classes are multiples on the global default value, 1rem.
Margin
{% highlight scss %} .m-a-0 { margin: 0 !important; } .m-t-0 { margin-top: 0 !important; } .m-r-0 { margin-right: 0 !important; } .m-b-0 { margin-bottom: 0 !important; } .m-l-0 { margin-left: 0 !important; } .m-x-0 { margin-right: 0 !important; margin-left: 0 !important; } .m-y-0 { margin-top: 0 !important; margin-bottom: 0 !important; }
.m-a { margin: $spacer !important; } .m-t { margin-top: $spacer-y !important; } .m-r { margin-right: $spacer-x !important; } .m-b { margin-bottom: $spacer-y !important; } .m-l { margin-left: $spacer-x !important; } .m-x { margin-right: $spacer-x !important; margin-left: $spacer-x !important; } .m-y { margin-top: $spacer-y !important; margin-bottom: $spacer-y !important; } .m-x-auto { margin-right: auto !important; margin-left: auto !important; }
.m-a-md { margin: ($spacer * 1.5) !important; } .m-t-md { margin-top: ($spacer-y * 1.5) !important; } .m-r-md { margin-right: ($spacer-y * 1.5) !important; } .m-b-md { margin-bottom: ($spacer-y * 1.5) !important; } .m-l-md { margin-left: ($spacer-y * 1.5) !important; } .m-x-md { margin-right: ($spacer-x * 1.5) !important; margin-left: ($spacer-x * 1.5) !important; } .m-y-md { margin-top: ($spacer-y * 1.5) !important; margin-bottom: ($spacer-y * 1.5) !important; }
.m-a-lg { margin: ($spacer * 3) !important; } .m-t-lg { margin-top: ($spacer-y * 3) !important; } .m-r-lg { margin-right: ($spacer-y * 3) !important; } .m-b-lg { margin-bottom: ($spacer-y * 3) !important; } .m-l-lg { margin-left: ($spacer-y * 3) !important; } .m-x-lg { margin-right: ($spacer-x * 3) !important; margin-left: ($spacer-x * 3) !important; } .m-y-lg { margin-top: ($spacer-y * 3) !important; margin-bottom: ($spacer-y * 3) !important; } {% endhighlight %}
Padding
{% highlight scss %} .p-a-0 { padding: 0 !important; } .p-t-0 { padding-top: 0 !important; } .p-r-0 { padding-right: 0 !important; } .p-b-0 { padding-bottom: 0 !important; } .p-l-0 { padding-left: 0 !important; } .p-x-0 { padding-left: 0 !important; padding-right: 0 !important; } .p-y-0 { padding-top: 0 !important; padding-bottom: 0 !important; }
.p-a { padding: $spacer !important; } .p-t { padding-top: $spacer-y !important; } .p-r { padding-right: $spacer-x !important; } .p-b { padding-bottom: $spacer-y !important; } .p-l { padding-left: $spacer-x !important; } .p-x { padding-right: $spacer-x !important; padding-left: $spacer-x !important; } .p-y { padding-top: $spacer-y !important; padding-bottom: $spacer-y !important; }
.p-a-md { padding: ($spacer * 1.5) !important; } .p-t-md { padding-top: ($spacer-y * 1.5) !important; } .p-r-md { padding-right: ($spacer-y * 1.5) !important; } .p-b-md { padding-bottom: ($spacer-y * 1.5) !important; } .p-l-md { padding-left: ($spacer-y * 1.5) !important; } .p-x-md { padding-right: ($spacer-x * 1.5) !important; padding-left: ($spacer-x * 1.5) !important; } .p-y-md { padding-top: ($spacer-y * 1.5) !important; padding-bottom: ($spacer-y * 1.5) !important; }
.p-a-lg { padding: ($spacer * 3) !important; } .p-t-lg { padding-top: ($spacer-y * 3) !important; } .p-r-lg { padding-right: ($spacer-y * 3) !important; } .p-b-lg { padding-bottom: ($spacer-y * 3) !important; } .p-l-lg { padding-left: ($spacer-y * 3) !important; } .p-x-lg { padding-right: ($spacer-x * 3) !important; padding-left: ($spacer-x * 3) !important; } .p-y-lg { padding-top: ($spacer-y * 3) !important; padding-bottom: ($spacer-y * 3) !important; } {% endhighlight %}
Text alignment
Easily realign text to components with text alignment classes.
{% example html %}
Justified text.
No wrap text.
{% endexample %}For left, right, and center alignment, responsive classes are available that use the same viewport width breakpoints as the grid system.
{% example html %}
Left aligned text on all viewport sizes.
Center aligned text on all viewport sizes.
Right aligned text on all viewport sizes.
Left aligned text on viewports sized SM (small) or wider.
Left aligned text on viewports sized MD (medium) or wider.
Left aligned text on viewports sized LG (large) or wider.
Left aligned text on viewports sized XL (extra-large) or wider.
{% endexample %}Text transform
Transform text in components with text capitalization classes.
{% example html %}
Lowercased text.
Uppercased text.
CapiTaliZed text.
{% endexample %}Contextual colors and backgrounds
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.
{% example html %}
Fusce dapibus, tellus ac cursus commodo, tortor mauris nibh.
Nullam id dolor id nibh ultricies vehicula ut id elit.
Duis mollis, est non commodo luctus, nisi erat porttitor ligula.
Maecenas sed diam eget risus varius blandit sit amet non magna.
Etiam porta sem malesuada magna mollis euismod.
Donec ullamcorper nulla non metus auctor fringilla.
{% endexample %}Contextual text classes also work well on anchors with the provided hover and focus states.
{% example html %} Muted link Primary link Success link Info link Warning link Danger link {% endexample %}
Similar to the contextual text color classes, easily set the background of an element to any contextual class. Anchor components will darken on hover, just like the text classes.
{% example html %}
{% callout info %}
Dealing with specificity
Sometimes contextual classes cannot be applied due to the specificity of another selector. In some cases, a sufficient workaround is to wrap your element's content in a <div> with the class.
{% endcallout %}
{% callout warning %}
Conveying meaning to assistive technologies
Ensure that any meaning conveyed through color is also conveyed in a format that is not purely presentational. {% endcallout %}
Close icon
Use a generic close icon for dismissing content like modals and alerts. Be sure to include text for screen readers, as we've done with aria-label.
{% example html %} {% endexample %}
Responsive floats
These utility classes float an element to the left or right, or disable floating, based on the current viewport size using the CSS float property. !important is included to avoid specificity issues. These use the same viewport width breakpoints as the grid system.
Two similar non-responsive mixins (pull-left and pull-right) are also available.
{% example html %}
{% highlight scss %} // Related simple non-responsive mixins .element { @include pull-left; } .another-element { @include pull-right; } {% endhighlight %}
Center content
Set an element to display: block; and center via margin. Available as a mixin and class.
{% example html %}
{% highlight scss %} // Class .center-block { display: block; margin-left: auto; margin-right: auto; }
// Usage as a mixin .element { @include center-block; } {% endhighlight %}
Easily clear floats by adding .clearfix to the parent element. Utilizes the micro clearfix as popularized by Nicolas Gallagher. Can also be used as a mixin.
{% highlight html %}
{% highlight scss %} // Mixin itself .clearfix() { &:before, &:after { content: " "; display: table; } &:after { clear: both; } }
// Usage as a mixin .element { @include clearfix; } {% endhighlight %}
Invisible content
The .invisible class can be used to toggle only the visibility of an element, meaning its display is not modified and the element can still affect the flow of the document.
{% highlight html %}
{% highlight scss %} // Class .invisible { visibility: hidden; }
// Usage as a mixin .element { .invisible(); } {% endhighlight %}
Screen readers and keyboard users
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). Can also be used as mixins.
{% comment %} Necessary for following accessibility best practices. {% endcomment %}
{% highlight html %} Skip to main content {% endhighlight %}
{% highlight scss %} // Usage as a mixin .skip-navigation { @include sr-only; @include sr-only-focusable; } {% endhighlight %}
Image replacement
Utilize the .text-hide class or mixin to help replace an element's text content with a background image.
{% highlight html %}
Custom heading
{% endhighlight %}{% highlight scss %} // Usage as a mixin .heading { @include text-hide; } {% endhighlight %}
Responsive embeds
Allow browsers to determine video or slideshow dimensions based on the width of their containing block by creating an intrinsic ratio that will properly scale on any device.
Rules are directly applied to <iframe>, <embed>, <video>, and <object> elements; optionally use an explicit descendant class .embed-responsive-item when you want to match the styling for other attributes.
Pro-Tip! You don't need to include frameborder="0" in your <iframe>s as we override that for you.
{% example html %}
Aspect ratios can be customized with modifier classes.
{% highlight html %}