0
0
mirror of https://github.com/twbs/bootstrap.git synced 2024-12-04 16:24:22 +01:00
Bootstrap/site/docs/4.3/utilities/text.md

133 lines
4.5 KiB
Markdown
Raw Normal View History

---
layout: docs
2017-08-17 10:19:44 +02:00
title: Text
2017-05-28 20:25:59 +02:00
description: Documentation and examples for common text utilities to control alignment, wrapping, weight, and more.
group: utilities
2017-05-28 20:25:59 +02:00
toc: true
---
## Text alignment
Easily realign text to components with text alignment classes.
2018-03-14 16:44:38 +01:00
{% 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>
2018-03-14 16:44:38 +01:00
{% 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.
2018-03-14 16:44:38 +01:00
{% 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>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
## Text wrapping and overflow
2018-11-04 12:33:57 +01:00
Wrap text with a `.text-wrap` class.
{% capture example %}
2018-11-04 14:38:56 +01:00
<div class="badge badge-primary text-wrap" style="width: 6rem;">
2018-11-04 12:33:57 +01:00
This text should wrap.
</div>
{% endcapture %}
{% include example.html content=example %}
Prevent text from wrapping with a `.text-nowrap` class.
2018-03-14 16:44:38 +01:00
{% capture example %}
<div class="text-nowrap bd-highlight" style="width: 8rem;">
This text should overflow the parent.
</div>
2018-03-14 16:44:38 +01:00
{% 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`.**
2018-03-14 16:44:38 +01:00
{% 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>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
2018-12-17 18:58:18 +01:00
## Word break
2019-02-06 11:38:13 +01:00
Prevent long strings of text from breaking your components' layout by using `.text-break` to set `overflow-wrap: break-word` (and `word-break: break-word` for IE & Edge compatibility).
2018-12-17 18:58:18 +01:00
{% capture example %}
<p class="text-break">mmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmm</p>
{% endcapture %}
{% include example.html content=example %}
## Text transform
Transform text in components with text capitalization classes.
2018-03-14 16:44:38 +01:00
{% capture example %}
<p class="text-lowercase">Lowercased text.</p>
<p class="text-uppercase">Uppercased text.</p>
<p class="text-capitalize">CapiTaliZed text.</p>
2018-03-14 16:44:38 +01:00
{% 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.
2018-03-14 16:44:38 +01:00
{% 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>
2018-03-14 16:44:38 +01:00
{% endcapture %}
{% include example.html content=example %}
2018-04-01 06:04:54 +02:00
## Monospace
Change a selection to our monospace font stack with `.text-monospace`.
{% capture example %}
<p class="text-monospace">This is in monospace</p>
2018-04-01 06:04:54 +02:00
{% 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 %}