文章

配置、折り返し、ウェイトなどを制御する一般的なテキストユーティリティのドキュメントと例。

このページでは

テキストの配置

テキスト配置クラスを使用して、テキストをコンポーネントに簡単に再配置します。開始、終了、および中央揃えの場合、グリッドシステムと同じビューポート幅のブレークポイントを使用するレスポンシブクラスを使用できます。

すべてのビューポートサイズで位置合わせされたテキストを開始します。

すべてのビューポートサイズでテキストを中央揃えにします。

すべてのビューポートサイズで位置合わせされたテキストを終了します。

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-breakto setword-wrap: break-wordおよびを使用して、長い文字列のテキストがコンポーネントのレイアウトを壊さないようにしますword-break: break-word。より広いブラウザサポートのためword-wrapに、より一般的なものの代わりに使用し、非推奨のものを追加して、フレックスコンテナの問題を回避します。overflow-wrapword-break: break-word

mmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmm

html

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

最も使用されている RTL 言語であるArabic では、単語を分割することはできないことに注意してください。したがって .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>

Sass マップfont-sizeを変更して、使用可能なをカスタマイズします。$font-sizes

フォントの太さと斜体

これらのユーティリティを使用して、テキストのfont-weightまたはをすばやく変更します。ユーティリティはと略され、ユーティリティはと略されます。font-stylefont-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
    ),