133 lines
4.7 KiB
Markdown
133 lines
4.7 KiB
Markdown
|
---
|
||
|
layout: docs
|
||
|
title: Text
|
||
|
description: Documentation and examples for common text utilities to control alignment, wrapping, weight, and more.
|
||
|
group: utilities
|
||
|
toc: true
|
||
|
---
|
||
|
|
||
|
## Text alignment
|
||
|
|
||
|
Easily realign text to components with text alignment classes.
|
||
|
|
||
|
{% capture example %}
|
||
|
<p class="text-justify">Ambitioni dedisse scripsisse iudicaretur. Cras mattis iudicium purus sit amet fermentum. Donec sed odio operae, eu vulputate felis rhoncus. Praeterea iter est quasdam res quas ex communi. At nos hinc posthac, sitientis piros Afros. Petierunt uti sibi concilium totius Galliae in diem certam indicere. Cras mattis iudicium purus sit amet fermentum.</p>
|
||
|
{% endcapture %}
|
||
|
{% include example.html content=example %}
|
||
|
|
||
|
For left, right, and center alignment, responsive classes are available that use the same viewport width breakpoints as the grid system.
|
||
|
|
||
|
{% capture example %}
|
||
|
<p class="text-left">Left aligned text on all viewport sizes.</p>
|
||
|
<p class="text-center">Center aligned text on all viewport sizes.</p>
|
||
|
<p class="text-right">Right aligned text on all viewport sizes.</p>
|
||
|
|
||
|
<p class="text-sm-left">Left aligned text on viewports sized SM (small) or wider.</p>
|
||
|
<p class="text-md-left">Left aligned text on viewports sized MD (medium) or wider.</p>
|
||
|
<p class="text-lg-left">Left aligned text on viewports sized LG (large) or wider.</p>
|
||
|
<p class="text-xl-left">Left aligned text on viewports sized XL (extra-large) or wider.</p>
|
||
|
{% endcapture %}
|
||
|
{% include example.html content=example %}
|
||
|
|
||
|
## Text wrapping and overflow
|
||
|
|
||
|
Wrap text with a `.text-wrap` class.
|
||
|
|
||
|
{% capture example %}
|
||
|
<div class="badge badge-primary text-wrap" style="width: 6rem;">
|
||
|
This text should wrap.
|
||
|
</div>
|
||
|
{% endcapture %}
|
||
|
{% include example.html content=example %}
|
||
|
|
||
|
Prevent text from wrapping with a `.text-nowrap` class.
|
||
|
|
||
|
{% capture example %}
|
||
|
<div class="text-nowrap bd-highlight" style="width: 8rem;">
|
||
|
This text should overflow the parent.
|
||
|
</div>
|
||
|
{% endcapture %}
|
||
|
{% include example.html content=example %}
|
||
|
|
||
|
For longer content, you can add a `.text-truncate` class to truncate the text with an ellipsis. **Requires `display: inline-block` or `display: block`.**
|
||
|
|
||
|
{% capture example %}
|
||
|
<!-- Block level -->
|
||
|
<div class="row">
|
||
|
<div class="col-2 text-truncate">
|
||
|
Praeterea iter est quasdam res quas ex communi.
|
||
|
</div>
|
||
|
</div>
|
||
|
|
||
|
<!-- Inline level -->
|
||
|
<span class="d-inline-block text-truncate" style="max-width: 150px;">
|
||
|
Praeterea iter est quasdam res quas ex communi.
|
||
|
</span>
|
||
|
{% endcapture %}
|
||
|
{% include example.html content=example %}
|
||
|
|
||
|
## Word break
|
||
|
|
||
|
Prevent long strings of text from breaking your components' layout by using `.text-break` to set `word-wrap: break-word` and `word-break: break-word`. We use `word-wrap` instead of the more common `overflow-wrap` for wider browser support, and add the deprecated `word-break: break-word` to avoid issues with flex containers.
|
||
|
|
||
|
{% capture example %}
|
||
|
<p class="text-break">mmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmm</p>
|
||
|
{% endcapture %}
|
||
|
{% include example.html content=example %}
|
||
|
|
||
|
## Text transform
|
||
|
|
||
|
Transform text in components with text capitalization classes.
|
||
|
|
||
|
{% capture example %}
|
||
|
<p class="text-lowercase">Lowercased text.</p>
|
||
|
<p class="text-uppercase">Uppercased text.</p>
|
||
|
<p class="text-capitalize">CapiTaliZed text.</p>
|
||
|
{% endcapture %}
|
||
|
{% include example.html content=example %}
|
||
|
|
||
|
Note how `.text-capitalize` only changes the first letter of each word, leaving the case of any other letters unaffected.
|
||
|
|
||
|
## Font weight and italics
|
||
|
|
||
|
Quickly change the weight (boldness) of text or italicize text.
|
||
|
|
||
|
{% capture example %}
|
||
|
<p class="font-weight-bold">Bold text.</p>
|
||
|
<p class="font-weight-bolder">Bolder weight text (relative to the parent element).</p>
|
||
|
<p class="font-weight-normal">Normal weight text.</p>
|
||
|
<p class="font-weight-light">Light weight text.</p>
|
||
|
<p class="font-weight-lighter">Lighter weight text (relative to the parent element).</p>
|
||
|
<p class="font-italic">Italic text.</p>
|
||
|
{% endcapture %}
|
||
|
{% include example.html content=example %}
|
||
|
|
||
|
## Monospace
|
||
|
|
||
|
Change a selection to our monospace font stack with `.text-monospace`.
|
||
|
|
||
|
{% capture example %}
|
||
|
<p class="text-monospace">This is in monospace</p>
|
||
|
{% endcapture %}
|
||
|
{% include example.html content=example %}
|
||
|
|
||
|
## Reset color
|
||
|
|
||
|
Reset a text or link's color with `.text-reset`, so that it inherits the color from its parent.
|
||
|
|
||
|
{% capture example %}
|
||
|
<p class="text-muted">
|
||
|
Muted text with a <a href="#" class="text-reset">reset link</a>.
|
||
|
</p>
|
||
|
{% endcapture %}
|
||
|
{% include example.html content=example %}
|
||
|
|
||
|
## Text decoration
|
||
|
|
||
|
Remove a text decoration with a `.text-decoration-none` class.
|
||
|
|
||
|
{% capture example %}
|
||
|
<a href="#" class="text-decoration-none">Non-underlined link</a>
|
||
|
{% endcapture %}
|
||
|
{% include example.html content=example %}
|