Langkau ke kandungan utama Langkau ke navigasi dokumen

Dokumentasi dan contoh untuk utiliti teks biasa untuk mengawal penjajaran, pembalut, berat dan banyak lagi.

Penjajaran teks

Selaraskan semula teks dengan mudah kepada komponen dengan kelas penjajaran teks. Untuk penjajaran permulaan, akhir dan tengah, kelas responsif tersedia yang menggunakan titik putus lebar port pandang yang sama seperti sistem grid.

Mulakan teks yang dijajarkan pada semua saiz port pandangan.

Teks yang dijajarkan ke tengah pada semua saiz port pandangan.

Tamatkan teks sejajar pada semua saiz port pandangan.

Mulakan teks sejajar pada viewport bersaiz SM (kecil) atau lebih luas.

Mulakan teks yang dijajarkan pada viewport bersaiz MD (sederhana) atau lebih luas.

Mulakan teks yang dijajarkan pada port pandangan bersaiz LG (besar) atau lebih luas.

Mulakan teks yang dijajarkan pada viewport bersaiz XL (lebih besar) atau lebih luas.

<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>
Harap maklum bahawa kami tidak menyediakan kelas utiliti untuk teks yang dibenarkan. Walaupun, dari segi estetika, teks yang dibenarkan mungkin kelihatan lebih menarik, ia menjadikan jarak perkataan lebih rawak dan oleh itu lebih sukar untuk dibaca.

Pembalut dan limpahan teks

Balut teks dengan .text-wrapkelas.

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

Elakkan teks daripada dibalut dengan .text-nowrapkelas.

Teks ini sepatutnya melimpahi induk.
<div class="text-nowrap bd-highlight" style="width: 8rem;">
  This text should overflow the parent.
</div>

Pecah kata

Elakkan rentetan teks yang panjang daripada memecahkan reka letak komponen anda dengan menggunakan .text-breakuntuk menetapkan word-wrap: break-worddan word-break: break-word. Kami menggunakan word-wrapbukannya yang lebih biasa overflow-wrapuntuk sokongan penyemak imbas yang lebih luas dan menambah yang tidak digunakan word-break: break-worduntuk mengelakkan isu dengan bekas fleksibel.

mmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmm

<p class="text-break">mmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmm</p>
Harap maklum bahawa memecahkan perkataan tidak boleh dilakukan dalam bahasa Arab , yang merupakan bahasa RTL yang paling banyak digunakan. Oleh .text-breakitu dialih keluar daripada CSS tersusun RTL kami.

Transformasi teks

Ubah teks dalam komponen dengan kelas huruf besar teks.

Teks berhuruf kecil.

Teks huruf besar.

Teks CapiTaliZed.

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

Perhatikan bagaimana .text-capitalizehanya menukar huruf pertama setiap perkataan, meninggalkan kes mana-mana huruf lain tidak terjejas.

Saiz huruf

Tukar font-sizeteks dengan cepat. Walaupun kelas tajuk kami (cth, .h1.h6) terpakai font-size, font-weight, dan line-height, utiliti ini hanya terpakai font-size. Saiz untuk utiliti ini sepadan dengan elemen tajuk HTML, jadi apabila bilangan bertambah, saiznya berkurangan.

teks .fs-1

teks .fs-2

teks .fs-3

teks .fs-4

teks .fs-5

teks .fs-6

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

Sesuaikan font-sizes anda yang tersedia dengan mengubah suai $font-sizespeta Sass.

Berat fon dan huruf condong

Tukar font-weightatau font-styleteks dengan cepat menggunakan utiliti ini. font-styleutiliti disingkatkan sebagai .fst-*dan font-weightutiliti disingkatkan sebagai .fw-*.

Teks tebal.

Teks berat yang lebih tebal (berbanding dengan elemen induk).

Teks berat biasa.

Teks ringan.

Teks yang lebih ringan (berbanding dengan elemen induk).

Teks miring.

Teks dengan gaya fon biasa

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

Ketinggian garisan

Tukar ketinggian garisan dengan .lh-*utiliti.

Ini ialah perenggan panjang yang ditulis untuk menunjukkan cara ketinggian garis sesuatu elemen dipengaruhi oleh utiliti kami. Kelas digunakan pada elemen itu sendiri atau kadangkala elemen induk. Kelas ini boleh disesuaikan mengikut keperluan dengan API utiliti kami.

Ini ialah perenggan panjang yang ditulis untuk menunjukkan cara ketinggian garis sesuatu elemen dipengaruhi oleh utiliti kami. Kelas digunakan pada elemen itu sendiri atau kadangkala elemen induk. Kelas ini boleh disesuaikan mengikut keperluan dengan API utiliti kami.

Ini ialah perenggan panjang yang ditulis untuk menunjukkan cara ketinggian garis sesuatu elemen dipengaruhi oleh utiliti kami. Kelas digunakan pada elemen itu sendiri atau kadangkala elemen induk. Kelas ini boleh disesuaikan mengikut keperluan dengan API utiliti kami.

Ini ialah perenggan panjang yang ditulis untuk menunjukkan cara ketinggian garis sesuatu elemen dipengaruhi oleh utiliti kami. Kelas digunakan pada elemen itu sendiri atau kadangkala elemen induk. Kelas ini boleh disesuaikan mengikut keperluan dengan API utiliti kami.

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

Monospace

Tukar pilihan kepada timbunan fon monospace kami dengan .font-monospace.

Ini dalam monospace

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

Tetapkan semula warna

Tetapkan semula teks atau warna pautan dengan .text-reset, supaya ia mewarisi warna daripada induknya.

Teks diredamkan dengan pautan tetapan semula .

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

Hiasan teks

Hiaskan teks dalam komponen dengan kelas hiasan teks.

Teks ini mempunyai garis di bawahnya.

Teks ini mempunyai garis yang melaluinya.

Pautan ini telah mengeluarkan hiasan teksnya
<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>

Sass

Pembolehubah

// stylelint-disable value-keyword-case
$font-family-sans-serif:      system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", "Liberation Sans", 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(--#{$variable-prefix}font-sans-serif);
$font-family-code:            var(--#{$variable-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-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;

Peta

Utiliti bersaiz fon dijana daripada peta ini, digabungkan dengan API utiliti kami.

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

Utiliti fon dan teks diisytiharkan dalam API utiliti kami dalam scss/_utilities.scss. Ketahui cara menggunakan API utiliti.

    "font-family": (
      property: font-family,
      class: font,
      values: (monospace: var(--#{$variable-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,
        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
    ),