mirror_css/bootstrap
1
0
Fork 0
mirror of https://github.com/twbs/bootstrap.git synced 2025-08-14 01:24:19 +02:00
Code Issues Releases Wiki Activity

Replace white-space utilities with text-wrap utilities, add new ones

Browse Source
This commit is contained in:
Mark Otto
2025-05-23 15:25:31 -07:00
parent 374c8a1e1f
commit 22134b3ecc
2 changed files with 25 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
scss/_utilities.scss
View File

@@ -557,20 +557,22 @@ $utilities: map-merge(
class: text, class: text,
values: lowercase uppercase capitalize values: lowercase uppercase capitalize
), ),
"white-space": (
property: white-space,
class: text,
values: (
wrap: normal,
nowrap: nowrap,
)
),
"word-wrap": ( "word-wrap": (
property: word-wrap word-break, property: word-wrap word-break,
class: text, class: text,
values: (break: break-word), values: (break: break-word),
rtl: false rtl: false
), ),
"text-wrap": (
property: text-wrap,
class: text,
values: (
balance: balance,
nowrap: nowrap,
pretty: pretty,
wrap: wrap,
)
),
// scss-docs-end utils-text // scss-docs-end utils-text
// scss-docs-start utils-color // scss-docs-start utils-color
"color": ( "color": (

18
site/src/content/docs/utilities/text.mdx
View File

@@ -22,12 +22,12 @@ Easily realign text to components with text alignment classes. For start, end, a
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. 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> </Callout>
## Text wrapping and overflow ## Text wrap
Wrap text with a `.text-wrap` class. Wrap text with a `.text-wrap` class.
<Example code={`<div class="badge text-bg-primary text-wrap" style="width: 6rem;"> <Example code={`<div class="text-wrap bg-body-secondary border" style="width: 8rem;">
This text should wrap. This snippet of text should wrap.
</div>`} /> </div>`} />
Prevent text from wrapping with a `.text-nowrap` class. Prevent text from wrapping with a `.text-nowrap` class.
@@ -36,6 +36,18 @@ Prevent text from wrapping with a `.text-nowrap` class.
This text should overflow the parent. This text should overflow the parent.
</div>`} /> </div>`} />
Use `.text-balance` to balance evenly distribute text across multiple lines. This is computationally expensive and is thus limited by the Chromium to six lines and by Firefox to ten lines.
<Example code={`<div class="text-balance mx-auto" style="width: 20rem;">
This text should be balanced. Here we’re writing a longer snippet of text to form a paragraph and demonstrate how the text wraps.
</div>`} />
Use `.text-pretty` to prevent single words their own line (orphans). **Pretty text wrapping is not fully supported in Safari and Firefox at the moment.**
<Example code={`<div class="text-pretty mx-auto" style="width: 20rem;">
This text should be pretty. Here we’re writing a longer snippet of text to form a paragraph and demonstrate how the text wraps.
</div>`} />
## Word break ## 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. 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.