GitHubで表示

テキスト

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

このページの内容

テキストの配置

テキスト配置クラスを使用して、コンポーネントのテキストを簡単に再配置できます。開始、終了、中央の配置には、グリッドシステムと同じビューポート幅のブレークポイントを使用するレスポンシブクラスが用意されています。

すべてのビューポートサイズで左揃えのテキスト。

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

すべてのビューポートサイズで右揃えのテキスト。

SM（小）以上のビューポートサイズで右揃えのテキスト。

MD（中）以上のビューポートサイズで右揃えのテキスト。

LG（大）以上のビューポートサイズで右揃えのテキスト。

XL（特大）以上のビューポートサイズで右揃えのテキスト。

XXL（超特大）以上のビューポートサイズで右揃えのテキスト。

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-end">End aligned text on viewports sized SM (small) or wider.</p>
<p class="text-md-end">End aligned text on viewports sized MD (medium) or wider.</p>
<p class="text-lg-end">End aligned text on viewports sized LG (large) or wider.</p>
<p class="text-xl-end">End aligned text on viewports sized XL (extra large) or wider.</p>
<p class="text-xxl-end">End aligned text on viewports sized XXL (extra extra large) or wider.</p>

均等割り付けのテキスト用のユーティリティクラスは提供していません。均等割り付けのテキストは見た目が美しい場合がありますが、単語間隔がランダムになるため、読みづらくなります。

テキストの折り返しとオーバーフロー

.text-wrapクラスを使用してテキストを折り返します。

このテキストは折り返されます。

html

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

.text-nowrapクラスを使用してテキストの折り返しを防ぎます。

このテキストは親要素からオーバーフローします。

html

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

単語の改行

.text-breakを使用して`word-wrap: break-word`と`word-break: break-word`を設定することで、長いテキスト文字列がコンポーネントのレイアウトを壊さないようにします。より幅広いブラウザサポートのために、より一般的な`overflow-wrap`の代わりに`word-wrap`を使用し、フレックスコンテナの問題を回避するために非推奨の`word-break: break-word`を追加します。

mmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmm

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` Sassマップを変更することで、使用可能な`font-size`をカスタマイズできます。

フォントの太さと斜体

これらのユーティリティを使用して、テキストの`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-medium">Medium 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`を使用して、テキストまたはリンクの色をリセットし、親要素から色を継承するようにします。

2番目の本文テキストとリセットされたリンク。

html

<p class="text-body-secondary">
  Secondary body 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>

CSS

Sass変数

デフォルトのタイプとフォント関連のSass変数

scss/_variables.scss

// 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-medium:          500;
$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;

Sassマップ

フォントサイズユーティリティは、ユーティリティAPIと組み合わせて、このマップから生成されます。

scss/_variables.scss

$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
);

scss/_maps.scss

$theme-colors-text: (
  "primary": $primary-text-emphasis,
  "secondary": $secondary-text-emphasis,
  "success": $success-text-emphasis,
  "info": $info-text-emphasis,
  "warning": $warning-text-emphasis,
  "danger": $danger-text-emphasis,
  "light": $light-text-emphasis,
  "dark": $dark-text-emphasis,
);

SassユーティリティAPI

フォントとテキストのユーティリティは、`scss/_utilities.scss`のユーティリティAPIで宣言されています。ユーティリティAPIの使用方法をご覧ください。

scss/_utilities.scss

"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: (
    lighter: $font-weight-lighter,
    light: $font-weight-light,
    normal: $font-weight-normal,
    medium: $font-weight-medium,
    semibold: $font-weight-semibold,
    bold: $font-weight-bold,
    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
),