Teksti

Dokumentaatio ja esimerkkejä yleisistä tekstin apuohjelmista tasauksen, rivityksen, painon ja muiden ohjaamiseksi.

Tällä sivulla

Tekstin tasaus

Tasaa teksti helposti komponenteiksi tekstin tasausluokkien avulla. Alku-, loppu- ja keskikohdistusta varten on saatavilla reagoivia luokkia, jotka käyttävät samoja näkymän leveyden keskeytyspisteitä kuin ruudukkojärjestelmä.

Aloita tasattu teksti kaikissa näkymäkokoissa.

Keskitasattu teksti kaikissa näkymäkokoissa.

Lopeta tasattu teksti kaikissa näkymäkokoissa.

Aloita tasattu teksti kuvaporteista, joiden koko on SM (pieni) tai leveämpi.

Aloita tasattu teksti kuvaporteista, joiden koko on MD (keskikoko) tai leveämpi.

Aloita tasattu teksti LG (suuri) tai leveämmistä kuvaporteista.

Aloita tasattu teksti XL-kokoisista (erittäin suurista) tai leveämmistä kuvaporteista.

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>

Huomaa, että emme tarjoa hyödyllisyysluokkia tasatulle tekstille. Vaikka esteettisesti tasattu teksti saattaa näyttää houkuttelevammalta, se tekee sanavälistä satunnaisemman ja siksi vaikeamman luettavan.

Tekstin rivitys ja ylivuoto

Kääri teksti .text-wrapluokalla.

Tämän tekstin pitäisi loppua.

html

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

Estä tekstin rivittäminen .text-nowrapluokassa.

Tämän tekstin tulisi ylittää vanhemman.

html

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

Sanan tauko

Estä pitkiä tekstijonoja rikkomasta komponenttien asettelua käyttämällä .text-breakasetuksia word-wrap: break-wordja word-break: break-word. Käytämme word-wrapyleisemmän sijasta overflow-wraplaajempaa selaintukea varten ja lisäämme vanhentuneen tilan word-break: break-wordvälttääksemme flex-säilöihin liittyviä ongelmia.

mmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmm

html

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

Huomaa, että sanojen rikkominen ei ole mahdollista arabiassa , joka on eniten käytetty RTL-kieli. Siksi .text-breakse on poistettu RTL:stä käännetystä CSS:stä.

Tekstin muunnos

Muunna teksti komponenteiksi tekstin isojen kirjainten luokilla.

Pienet kirjaimet.

Teksti isoilla kirjaimilla.

Isokokoinen teksti.

html

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

Huomaa, että .text-capitalizevain kunkin sanan ensimmäinen kirjain muuttuu, jolloin muiden kirjainten kirjainkoko ei vaikuta.

Fonttikoko

font-sizeMuuta tekstiä nopeasti . Vaikka otsikkoluokat (esim. .h1– .h6) koskevat font-size, font-weightja line-height, nämä apuohjelmat koskevat vainfont-size . Näiden apuohjelmien koko vastaa HTML:n otsikkoelementtejä, joten lukumäärän kasvaessa niiden koko pienenee.

.fs-1 teksti

.fs-2 teksti

.fs-3 teksti

.fs-4 teksti

.fs-5 teksti

.fs-6 teksti

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>

Mukauta käytettävissä olevia font-sizes:iä muokkaamalla $font-sizesSass-kartta.

Fontin paino ja kursivoitu

Muuta font-weighttai font-styletekstin nopeasti näiden apuohjelmien avulla. font-styleapuohjelmat on lyhennetty muodossa .fst-*ja font-weightapuohjelmat lyhennetään nimellä .fw-*.

Lihavoitu teksti.

Lihavoitumpi teksti (suhteessa yläelementtiin).

Puolilihavoitu teksti.

Normaalipainoinen teksti.

Kevyt teksti.

Kevyempi teksti (suhteessa yläelementtiin).

Kursivoitu teksti.

Teksti normaalilla kirjasintyylillä

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>

Viivankorkeus

Muuta linjan korkeutta .lh-*apuohjelmilla.

Tämä on pitkä kappale, joka on kirjoitettu osoittamaan, kuinka apuohjelmamme vaikuttavat elementin rivin korkeuteen. Luokkia sovelletaan itse elementtiin tai joskus pääelementtiin. Näitä luokkia voidaan mukauttaa tarpeen mukaan apuohjelman API:lla.

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>

Monospace

Muuta valinta monospace-fonttipinoksi käyttämällä .font-monospace.

Tämä on monoavaruudessa

html

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

Palauta väri

Palauta tekstin tai linkin väri .text-resetpainikkeella , jotta se perii värin vanhemmalta.

Mykistetty teksti nollauslinkillä .

html

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

Tekstin koristelu

Koristele komponenttien teksti tekstinkoristeluokilla.

Tämän tekstin alla on viiva.

Tämän tekstin läpi kulkee rivi.

Tästä linkistä on poistettu tekstikoristelu

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>

Sass

Muuttujat

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

Kartat

Fonttikokoiset apuohjelmat luodaan tästä kartasta yhdessä apuohjelmien API:n kanssa.

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

Utilities API

Fontti- ja tekstiapuohjelmat on ilmoitettu apuohjelmien API:ssa scss/_utilities.scss. Opi käyttämään apuohjelmien sovellusliittymää.

    "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
    ),