diff options
Diffstat (limited to 'site/content/docs/5.0/utilities/text.md')
-rw-r--r-- | site/content/docs/5.0/utilities/text.md | 117 |
1 files changed, 117 insertions, 0 deletions
diff --git a/site/content/docs/5.0/utilities/text.md b/site/content/docs/5.0/utilities/text.md new file mode 100644 index 0000000000..d7a8e97b09 --- /dev/null +++ b/site/content/docs/5.0/utilities/text.md @@ -0,0 +1,117 @@ +--- +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. For left, right, and center alignment, responsive classes are available that use the same viewport width breakpoints as the grid system. + +{{< 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> +{{< /example >}} + +{{< callout info >}} +Note that we don't provide utility classes for justified text. While, aesthetically, justified text might look more appealing, it does make word-spacing more random and therefore harder to read. +{{< /callout >}} + +## Text wrapping and overflow + +Wrap text with a `.text-wrap` class. + +{{< example >}} +<div class="badge bg-primary text-wrap" style="width: 6rem;"> + This text should wrap. +</div> +{{< /example >}} + +Prevent text from wrapping with a `.text-nowrap` class. + +{{< example >}} +<div class="text-nowrap bd-highlight" style="width: 8rem;"> + This text should overflow the parent. +</div> +{{< /example >}} + +## Word break + +Prevent long strings of text from breaking your components' layout by using `.text-break` to set `word-wrap: break-word`. We use `word-wrap` instead of the more common `overflow-wrap` for wider browser support. + +{{< example >}} +<p class="text-break">mmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmm</p> +{{< /example >}} + +## Text transform + +Transform text in components with text capitalization classes. + +{{< example >}} +<p class="text-lowercase">Lowercased text.</p> +<p class="text-uppercase">Uppercased text.</p> +<p class="text-capitalize">CapiTaliZed text.</p> +{{< /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. + +{{< 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> +<p class="font-normal">Text without font style</p> +{{< /example >}} + +## Line height + +Change the line height with `.lh-*` utilities. + +{{< example >}} +<p class="lh-1">Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Donec sed odio dui. Cras mattis pannenkoek purus sit amet fermentum. Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Nullam id dolor id nibh ultricies vehicula ut id elit. Cras mattis consectetur purus sit amet fermentum.</p> +<p class="lh-sm">Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Donec sed odio dui. Cras mattis pannenkoek purus sit amet fermentum. Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Nullam id dolor id nibh ultricies vehicula ut id elit. Cras mattis consectetur purus sit amet fermentum.</p> +<p class="lh-base">Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Donec sed odio dui. Cras mattis pannenkoek purus sit amet fermentum. Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Nullam id dolor id nibh ultricies vehicula ut id elit. Cras mattis consectetur purus sit amet fermentum.</p> +<p class="lh-lg">Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Donec sed odio dui. Cras mattis pannenkoek purus sit amet fermentum. Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Nullam id dolor id nibh ultricies vehicula ut id elit. Cras mattis consectetur purus sit amet fermentum.</p> +{{< /example >}} + +## Monospace + +Change a selection to our monospace font stack with `.font-monospace`. + +{{< example >}} +<p class="font-monospace">This is in monospace</p> +{{< /example >}} + +## Reset color + +Reset a text or link's color with `.text-reset`, so that it inherits the color from its parent. + +{{< example >}} +<p class="text-muted"> + Muted text with a <a href="#" class="text-reset">reset link</a>. +</p> +{{< /example >}} + +## Text decoration + +Decorate text in components with text decoration classes. + +{{< example >}} +<p class="text-decoration-underline">This text has a line underneath it.</p> +<p class="text-decoration-line-through">This text has a line going through it.</p> +<a href="#" class="text-decoration-none">This link has its text decoration removed</a> +{{< /example >}} |