mirror of
https://github.com/twbs/bootstrap.git
synced 2024-12-12 00:08:59 +01:00
4c7a3e8adf
* WIP: Mention variables, mixins, and loops in docs * Add Sass sections to component pages * add sass docs for forms and content * Update buttons.md * Remove empty mixins sections * Massive update to utilities and some consistency changes Co-authored-by: XhmikosR <xhmikosr@gmail.com>
155 lines
6.8 KiB
Markdown
155 lines
6.8 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. For start, end, and center alignment, responsive classes are available that use the same viewport width breakpoints as the grid system.
|
||
|
||
{{< example >}}
|
||
<p class="text-start">Start aligned text on all viewport sizes.</p>
|
||
<p class="text-center">Center aligned text on all viewport sizes.</p>
|
||
<p class="text-end">End aligned text on all viewport sizes.</p>
|
||
|
||
<p class="text-sm-start">Start aligned text on viewports sized SM (small) or wider.</p>
|
||
<p class="text-md-start">Start aligned text on viewports sized MD (medium) or wider.</p>
|
||
<p class="text-lg-start">Start aligned text on viewports sized LG (large) or wider.</p>
|
||
<p class="text-xl-start">Start 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` 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.
|
||
|
||
{{< example >}}
|
||
<p class="text-break">mmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmm</p>
|
||
{{< /example >}}
|
||
|
||
{{< callout warning >}}
|
||
Note that [breaking words isn't possible in Arabic](https://rtlstyling.com/posts/rtl-styling#3.-line-break), which is the most used RTL language. Therefore `.text-break` is removed from our RTL compiled CSS.
|
||
{{< /callout >}}
|
||
|
||
## 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 size
|
||
|
||
Quickly change the `font-size` of text. While our heading classes (e.g., `.h1`–`.h6`) apply `font-size`, `font-weight`, and `line-height`, these utilities _only_ apply `font-size`. Sizing for these utilities matches HTML's heading elements, so as the number increases, their size decreases.
|
||
|
||
{{< example >}}
|
||
<p class="fs-1">.fs-1 text</p>
|
||
<p class="fs-2">.fs-2 text</p>
|
||
<p class="fs-3">.fs-3 text</p>
|
||
<p class="fs-4">.fs-4 text</p>
|
||
<p class="fs-5">.fs-5 text</p>
|
||
<p class="fs-6">.fs-6 text</p>
|
||
{{< /example >}}
|
||
|
||
Customize your available `font-size`s by modifying the `$font-sizes` Sass map.
|
||
|
||
## Font weight and italics
|
||
|
||
Quickly change the `font-weight` or `font-style` of text with these utilities. `font-style` utilities are abbreviated as `.fst-*` and `font-weight` utilities are abbreviated as `.fw-*`.
|
||
|
||
{{< example >}}
|
||
<p class="fw-bold">Bold text.</p>
|
||
<p class="fw-bolder">Bolder weight text (relative to the parent element).</p>
|
||
<p class="fw-normal">Normal weight text.</p>
|
||
<p class="fw-light">Light weight text.</p>
|
||
<p class="fw-lighter">Lighter weight text (relative to the parent element).</p>
|
||
<p class="fst-italic">Italic text.</p>
|
||
<p class="fst-normal">Text with normal font style</p>
|
||
{{< /example >}}
|
||
|
||
## Line height
|
||
|
||
Change the line height with `.lh-*` utilities.
|
||
|
||
{{< example >}}
|
||
<p class="lh-1">Some placeholder content to show off the line height utilities. Happy birthday. You could've been the greatest. She ride me like a roller coaster. I messed around and got addicted. You just gotta ignite the light and let it shine! I'm intrigued, for a peek, heard it's fascinating. Catch her if you can. I should've told you what you meant to me 'Cause now I pay the price. Do you ever feel, feel so paper thin.</p>
|
||
<p class="lh-sm">But you better choose carefully. Yo, shout out to all you kids, buying bottle service, with your rent money. She's sweet as pie but if you break her heart. Just own the night like the 4th of July! In another life I would be your girl. Playing ping pong all night long, everything's all neon and hazy. Shorty so bad, I’m sprung and I don’t care.</p>
|
||
<p class="lh-base">I can feel a phoenix inside of me. Maybe a reason why all the doors are closed. We go higher and higher. Passport stamps, she's cosmopolitan. Someone said you had your tattoo removed. All my girls vintage Chanel baby. Someone said you had your tattoo removed.</p>
|
||
<p class="lh-lg">But I will get there. This is real so take a chance and don't ever look back, don't ever look back. You could travel the world but nothing comes close to the golden coast. Of anything and everything. Venice beach and Palm Springs, summertime is everything. Do you ever feel already buried deep six feet under? It's time to bring out the big balloons. So cover your eyes, I have a surprise. So I don't have to say you were the one that got away.</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 >}}
|
||
|
||
## Sass
|
||
|
||
### Variables
|
||
|
||
{{< scss-docs name="font-variables" file="scss/_variables.scss" >}}
|
||
|
||
### Maps
|
||
|
||
Font-size utilities are generated from this map, in combination with our utilities API.
|
||
|
||
{{< scss-docs name="font-sizes" file="scss/_variables.scss" >}}
|
||
|
||
### Utilities API
|
||
|
||
Font and text utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
|
||
|
||
{{< scss-docs name="utils-text" file="scss/_utilities.scss" >}}
|