Тэкст

Дакументацыя і прыклады звычайных тэкставых утыліт для кіравання выраўноўваннем, абгортваннем, вагай і іншым.

На гэтай старонцы

Выраўноўванне тэксту

Лёгка выраўноўвайце тэкст па кампанентах з дапамогай класаў выраўноўвання тэксту. Для пачатку, канца і выраўноўвання па цэнтры даступныя адаптыўныя класы, якія выкарыстоўваюць тыя ж кропкі перапынку шырыні прагляду, што і сістэма сеткі.

Пачніце выраўноўваць тэкст на ўсіх памерах прагляду.

Выраўнаваны па цэнтры тэкст на ўсіх памерах прагляду.

Канчатковы выраўнаваны тэкст на ўсіх памерах прагляду.

Пачніце выраўноўваць тэкст на вокнах прагляду памерам SM (маленькі) або шырэй.

Пачніце з выраўнаваным тэкстам на вокнах прагляду памерам MD (сярэдняга) або шырэй.

Пачніце з выраўнаваным тэкстам у акне прагляду памерам LG (вялікі) або шырэй.

Пачніце з выраўнаваным тэкстам на вокнах прагляду памерам XL (вельмі вялікі) або шырэй.

html

<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>

Звярніце ўвагу, што мы не даем карысныя класы для выраўнаванага тэксту. Хаця з эстэтычнага пункту гледжання выраўнаваны тэкст можа выглядаць больш прывабна, ён робіць інтэрвалы паміж словамі больш выпадковымі і, такім чынам, цяжэй для чытання.

Абцяканне тэкстам і перапаўненне

Абцяканне тэксту .text-wrapкласам.

Гэты тэкст павінен пераносіцца.

html

<div class="badge bg-primary text-wrap" style="width: 6rem;">
  This text should wrap.
</div>

Забараніць абцяканне тэксту .text-nowrapкласам.

Гэты тэкст павінен перакрываць бацькоўскі.

html

<div class="text-nowrap bg-light border" style="width: 8rem;">
  This text should overflow the parent.
</div>

Разрыў слоў

Прадухіліце доўгія радкі тэксту ад парушэння макета кампанентаў, выкарыстоўваючы .text-breakдля ўстаноўкі word-wrap: break-wordі word-break: break-word. Мы выкарыстоўваем word-wrapзамест больш распаўсюджанага overflow-wrapдля больш шырокай падтрымкі браўзераў і дадаем састарэлы word-break: break-word, каб пазбегнуць праблем з гнуткімі кантэйнерамі.

ммммммммммммммммммммммммммммммммммммммммммммммммммммммммммммммммм

html

<p class="text-break">mmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmm</p>

Звярніце ўвагу, што разбіваць словы немагчыма на арабскай мове , якая з'яўляецца найбольш часта выкарыстоўванай мовай RTL. Такім чынам .text-break, выдаляецца з нашага RTL-кампіляванага CSS.

Трансфармацыя тэксту

Пераўтварэнне тэксту ў кампанентах з дапамогай класаў капіталізацыі тэксту.

Тэкст у малым рэгістры.

Тэкст у верхнім рэгістры.

Тэкст з вялікай літары.

html

<p class="text-lowercase">Lowercased text.</p>
<p class="text-uppercase">Uppercased text.</p>
<p class="text-capitalize">CapiTaliZed text.</p>

Звярніце ўвагу на тое, што .text-capitalizeзмяняецца толькі першая літара кожнага слова, не закранаючы рэгістр іншых літар.

Памер шрыфта

Хутка змяніць font-sizeтэкст. Хоць нашы класы загалоўкаў (напрыклад, .h1– .h6) прымяняюцца font-size, font-weight, і line-height, гэтыя ўтыліты прымяняюцца толькіfont-size . Памер гэтых утыліт адпавядае элементам загалоўкаў HTML, так што з павелічэннем колькасці іх памер памяншаецца.

Тэкст .fs-1

Тэкст .fs-2

Тэкст .fs-3

Тэкст .fs-4

Тэкст .fs-5

Тэкст .fs-6

html

<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>

Наладзьце свае даступныя font-sizes, змяніўшы $font-sizesкарту Sass.

Шрыфт і курсіў

Хутка змяняйце font-weightабо font-styleтэкст з дапамогай гэтых утыліт. font-styleкамунальныя паслугі скарочана .fst-*і font-weightкамунальныя паслугі скарочана .fw-*.

Паўтлусты тэкст.

Тлусты тэкст (адносна бацькоўскага элемента).

Паўтлусты тэкст.

Нармальны вага тэксту.

Лёгкі тэкст.

Больш лёгкі тэкст (у параўнанні з бацькоўскім элементам).

Тэкст курсівам.

Тэкст са звычайным стылем шрыфта

html

<p class="fw-bold">Bold text.</p>
<p class="fw-bolder">Bolder weight text (relative to the parent element).</p>
<p class="fw-semibold">Semibold weight text.</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>

Вышыня лініі

Змяніць вышыню радка з дапамогай .lh-*утыліт.

Гэта доўгі параграф, напісаны, каб паказаць, як нашы ўтыліты ўплываюць на вышыню радка элемента. Класы прымяняюцца да самога элемента або часам да бацькоўскага элемента. Гэтыя класы можна наладзіць па меры неабходнасці з дапамогай нашага ўтылітнага API.

html

<p class="lh-1">This is a long paragraph written to show how the line-height of an element is affected by our utilities. Classes are applied to the element itself or sometimes the parent element. These classes can be customized as needed with our utility API.</p>
<p class="lh-sm">This is a long paragraph written to show how the line-height of an element is affected by our utilities. Classes are applied to the element itself or sometimes the parent element. These classes can be customized as needed with our utility API.</p>
<p class="lh-base">This is a long paragraph written to show how the line-height of an element is affected by our utilities. Classes are applied to the element itself or sometimes the parent element. These classes can be customized as needed with our utility API.</p>
<p class="lh-lg">This is a long paragraph written to show how the line-height of an element is affected by our utilities. Classes are applied to the element itself or sometimes the parent element. These classes can be customized as needed with our utility API.</p>

Монапрастор

Зменіце выбар на наш монашырынны стэк шрыфтоў з дапамогай .font-monospace.

Гэта ў монапрасторы

html

<p class="font-monospace">This is in monospace</p>

Скінуць колер

Скіньце колер тэксту або спасылкі з дапамогай .text-reset, каб ён атрымаў колер ад бацькоўскага.

Прыглушаны тэкст са спасылкай для скіду .

html

<p class="text-muted">
  Muted text with a <a href="#" class="text-reset">reset link</a>.
</p>

Афармленне тэксту

Упрыгожце тэкст у кампанентах з дапамогай класаў афармлення тэксту.

Гэты тэкст мае радок пад ім.

Праз гэты тэкст праходзіць радок.

Тэкставае ўпрыгожванне спасылкі выдалена

html

<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>

Сас

Пераменныя

// stylelint-disable value-keyword-case
$font-family-sans-serif:      system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", "Liberation Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
$font-family-monospace:       SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
// stylelint-enable value-keyword-case
$font-family-base:            var(--#{$prefix}font-sans-serif);
$font-family-code:            var(--#{$prefix}font-monospace);

// $font-size-root affects the value of `rem`, which is used for as well font sizes, paddings, and margins
// $font-size-base affects the font size of the body text
$font-size-root:              null;
$font-size-base:              1rem; // Assumes the browser default, typically `16px`
$font-size-sm:                $font-size-base * .875;
$font-size-lg:                $font-size-base * 1.25;

$font-weight-lighter:         lighter;
$font-weight-light:           300;
$font-weight-normal:          400;
$font-weight-semibold:        600;
$font-weight-bold:            700;
$font-weight-bolder:          bolder;

$font-weight-base:            $font-weight-normal;

$line-height-base:            1.5;
$line-height-sm:              1.25;
$line-height-lg:              2;

$h1-font-size:                $font-size-base * 2.5;
$h2-font-size:                $font-size-base * 2;
$h3-font-size:                $font-size-base * 1.75;
$h4-font-size:                $font-size-base * 1.5;
$h5-font-size:                $font-size-base * 1.25;
$h6-font-size:                $font-size-base;

Карты

Утыліты памеру шрыфта ствараюцца з гэтай карты ў спалучэнні з нашым API утыліт.

$font-sizes: (
  1: $h1-font-size,
  2: $h2-font-size,
  3: $h3-font-size,
  4: $h4-font-size,
  5: $h5-font-size,
  6: $h6-font-size
);

API утыліт

Утыліты шрыфтоў і тэксту аб'яўлены ў нашым API утыліт у scss/_utilities.scss. Даведайцеся, як выкарыстоўваць API утыліт.

    "font-family": (
      property: font-family,
      class: font,
      values: (monospace: var(--#{$prefix}font-monospace))
    ),
    "font-size": (
      rfs: true,
      property: font-size,
      class: fs,
      values: $font-sizes
    ),
    "font-style": (
      property: font-style,
      class: fst,
      values: italic normal
    ),
    "font-weight": (
      property: font-weight,
      class: fw,
      values: (
        light: $font-weight-light,
        lighter: $font-weight-lighter,
        normal: $font-weight-normal,
        bold: $font-weight-bold,
        semibold: $font-weight-semibold,
        bolder: $font-weight-bolder
      )
    ),
    "line-height": (
      property: line-height,
      class: lh,
      values: (
        1: 1,
        sm: $line-height-sm,
        base: $line-height-base,
        lg: $line-height-lg,
      )
    ),
    "text-align": (
      responsive: true,
      property: text-align,
      class: text,
      values: (
        start: left,
        end: right,
        center: center,
      )
    ),
    "text-decoration": (
      property: text-decoration,
      values: none underline line-through
    ),
    "text-transform": (
      property: text-transform,
      class: text,
      values: lowercase uppercase capitalize
    ),
    "white-space": (
      property: white-space,
      class: text,
      values: (
        wrap: normal,
        nowrap: nowrap,
      )
    ),
    "word-wrap": (
      property: word-wrap word-break,
      class: text,
      values: (break: break-word),
      rtl: false
    ),