Navit ja välilehdet

Dokumentaatio ja esimerkkejä Bootstrapin mukana tulevien navigointikomponenttien käytöstä.

Tällä sivulla

Base nav

Bootstrapissa käytettävissä oleva navigointi jakaa yleiset merkinnät ja tyylit perusluokista .navaktiivisiin ja pois käytöstä oleviin tiloihin. Vaihda muokkausluokkia vaihtaaksesi kunkin tyylin välillä.

Peruskomponentti .navon rakennettu flexboxilla ja se tarjoaa vahvan perustan kaikentyyppisten navigointikomponenttien rakentamiseen. Se sisältää joitain tyylien ohituksia (luetteloiden kanssa työskentelyä varten), joitain linkkien täyttöjä suurempia osumaalueita varten ja peruskäytöstä poistetun tyylin.

Peruskomponentti .navei sisällä mitään .activetilaa. Seuraavat esimerkit sisältävät luokan, lähinnä sen osoittamiseksi, että tämä tietty luokka ei käynnistä mitään erityistä tyyliä.

Jos haluat välittää aktiivisen tilan avustaville tekniikoille, käytä aria-currentattribuuttia — käyttämällä pagenykyisen sivun tai truejoukon nykyisen kohteen arvoa.

html

<ul class="nav">
  <li class="nav-item">
    <a class="nav-link active" aria-current="page" href="#">Active</a>
  </li>
  <li class="nav-item">
    <a class="nav-link" href="#">Link</a>
  </li>
  <li class="nav-item">
    <a class="nav-link" href="#">Link</a>
  </li>
  <li class="nav-item">
    <a class="nav-link disabled">Disabled</a>
  </li>
</ul>

Luokkia käytetään kaikkialla, joten merkintäsi voi olla erittäin joustava. Käytä <ul>kuten yllä, <ol>jos kohteidesi järjestys on tärkeä, tai rullaa omasi <nav>elementillä. Koska .navkäyttötarkoitukset display: flex, nav-linkit toimivat samalla tavalla kuin navigointikohteet, mutta ilman ylimääräisiä merkintöjä.

html

<nav class="nav">
  <a class="nav-link active" aria-current="page" href="#">Active</a>
  <a class="nav-link" href="#">Link</a>
  <a class="nav-link" href="#">Link</a>
  <a class="nav-link disabled">Disabled</a>
</nav>

Saatavilla olevat tyylit

Muuta s-komponentin tyyliä .navmuokkaajilla ja apuohjelmilla. Sekoita ja yhdistä tarvittaessa tai rakenna omasi.

Vaakasuora kohdistaminen

Muuta navigaattorisi vaakasuuntausta flexbox-apuohjelmilla . Oletusarvoisesti navat tasataan vasemmalle, mutta voit helposti muuttaa ne keskelle tai oikealle tasattuiksi.

Keskitetty .justify-content-center:

html

<ul class="nav justify-content-center">
  <li class="nav-item">
    <a class="nav-link active" aria-current="page" href="#">Active</a>
  </li>
  <li class="nav-item">
    <a class="nav-link" href="#">Link</a>
  </li>
  <li class="nav-item">
    <a class="nav-link" href="#">Link</a>
  </li>
  <li class="nav-item">
    <a class="nav-link disabled">Disabled</a>
  </li>
</ul>

Oikealle tasattuna kanssa .justify-content-end:

html

<ul class="nav justify-content-end">
  <li class="nav-item">
    <a class="nav-link active" aria-current="page" href="#">Active</a>
  </li>
  <li class="nav-item">
    <a class="nav-link" href="#">Link</a>
  </li>
  <li class="nav-item">
    <a class="nav-link" href="#">Link</a>
  </li>
  <li class="nav-item">
    <a class="nav-link disabled">Disabled</a>
  </li>
</ul>

Pystysuora

Pinoa navigointisi muuttamalla joustavan kohteen suuntaa .flex-columnapuohjelmalla. Pitääkö ne pinota joihinkin kuvaportteihin, mutta ei muihin? Käytä responsiivisia versioita (esim. .flex-sm-column).

html

<ul class="nav flex-column">
  <li class="nav-item">
    <a class="nav-link active" aria-current="page" href="#">Active</a>
  </li>
  <li class="nav-item">
    <a class="nav-link" href="#">Link</a>
  </li>
  <li class="nav-item">
    <a class="nav-link" href="#">Link</a>
  </li>
  <li class="nav-item">
    <a class="nav-link disabled">Disabled</a>
  </li>
</ul>

Kuten aina, pystysuuntainen navigointi on mahdollista <ul>myös ilman s-kirjainta.

html

<nav class="nav flex-column">
  <a class="nav-link active" aria-current="page" href="#">Active</a>
  <a class="nav-link" href="#">Link</a>
  <a class="nav-link" href="#">Link</a>
  <a class="nav-link disabled">Disabled</a>
</nav>

Välilehdet

Ottaa perusnavigaattorin ylhäältä ja lisää .nav-tabsluokan luodakseen välilehtikäyttöliittymän. Käytä niitä välilehtialueiden luomiseen JavaScript-laajennuksellamme .

html

<ul class="nav nav-tabs">
  <li class="nav-item">
    <a class="nav-link active" aria-current="page" href="#">Active</a>
  </li>
  <li class="nav-item">
    <a class="nav-link" href="#">Link</a>
  </li>
  <li class="nav-item">
    <a class="nav-link" href="#">Link</a>
  </li>
  <li class="nav-item">
    <a class="nav-link disabled">Disabled</a>
  </li>
</ul>

Pillerit

Ota sama HTML, mutta käytä .nav-pillssen sijaan:

html

<ul class="nav nav-pills">
  <li class="nav-item">
    <a class="nav-link active" aria-current="page" href="#">Active</a>
  </li>
  <li class="nav-item">
    <a class="nav-link" href="#">Link</a>
  </li>
  <li class="nav-item">
    <a class="nav-link" href="#">Link</a>
  </li>
  <li class="nav-item">
    <a class="nav-link disabled">Disabled</a>
  </li>
</ul>

Täytä ja perustele

Pakota sisältösi .navlaajentamaan koko käytettävissä olevaa leveyttä toisella kahdesta muokkausluokasta. Täytä kaikki käytettävissä oleva tila suhteellisesti .nav-items:lläsi käyttämällä .nav-fill. Huomaa, että kaikki vaakasuora tila on varattu, mutta kaikilla navigointikohdilla ei ole samaa leveyttä.

html

<ul class="nav nav-pills nav-fill">
  <li class="nav-item">
    <a class="nav-link active" aria-current="page" href="#">Active</a>
  </li>
  <li class="nav-item">
    <a class="nav-link" href="#">Much longer nav link</a>
  </li>
  <li class="nav-item">
    <a class="nav-link" href="#">Link</a>
  </li>
  <li class="nav-item">
    <a class="nav-link disabled">Disabled</a>
  </li>
</ul>

Kun käytät <nav>-pohjaista navigointia, voit turvallisesti jättää sen pois .nav-item, koska se .nav-linkon tarpeen vain <a>tyylielementtien osalta.

html

<nav class="nav nav-pills nav-fill">
  <a class="nav-link active" aria-current="page" href="#">Active</a>
  <a class="nav-link" href="#">Much longer nav link</a>
  <a class="nav-link" href="#">Link</a>
  <a class="nav-link disabled">Disabled</a>
</nav>

Käytä yhtä leveitä elementtejä varten .nav-justified. Nav-linkit täyttävät kaiken vaakasuoran tilan, mutta toisin kuin .nav-fillyllä, jokainen navigointikohde on sama leveä.

html

<ul class="nav nav-pills nav-justified">
  <li class="nav-item">
    <a class="nav-link active" aria-current="page" href="#">Active</a>
  </li>
  <li class="nav-item">
    <a class="nav-link" href="#">Much longer nav link</a>
  </li>
  <li class="nav-item">
    <a class="nav-link" href="#">Link</a>
  </li>
  <li class="nav-item">
    <a class="nav-link disabled">Disabled</a>
  </li>
</ul>

Samanlainen kuin .nav-fillesimerkki, jossa käytetään <nav>-pohjaista navigointia.

html

<nav class="nav nav-pills nav-justified">
  <a class="nav-link active" aria-current="page" href="#">Active</a>
  <a class="nav-link" href="#">Much longer nav link</a>
  <a class="nav-link" href="#">Link</a>
  <a class="nav-link disabled">Disabled</a>
</nav>

Työskentely flex utilities

Jos tarvitset reagoivia navigointimuunnelmia, harkitse useiden flexbox-apuohjelmien käyttöä . Vaikka nämä apuohjelmat ovat monisanaisempia, ne tarjoavat enemmän mukauttamista reagoivien keskeytyskohtien välillä. Alla olevassa esimerkissä navigaattorimme pinotaan alimmalle keskeytyspisteelle ja mukautetaan sitten vaakasuuntaiseen asetteluun, joka täyttää käytettävissä olevan leveyden pienestä keskeytyskohdasta alkaen.

html

<nav class="nav nav-pills flex-column flex-sm-row">
  <a class="flex-sm-fill text-sm-center nav-link active" aria-current="page" href="#">Active</a>
  <a class="flex-sm-fill text-sm-center nav-link" href="#">Longer nav link</a>
  <a class="flex-sm-fill text-sm-center nav-link" href="#">Link</a>
  <a class="flex-sm-fill text-sm-center nav-link disabled">Disabled</a>
</nav>

Mitä tulee saavutettavuuteen

Jos käytät navigointipalkin luomiseen navigointia, muista lisätä loogisimpaan pääsäilöön role="navigation"tai <ul>kääri <nav>elementti koko navigointipalkin ympärille. Älä lisää roolia <ul>itseensä, koska se estäisi sen ilmoittamisen todelliseksi luetteloksi aputekniikoiden avulla.

Huomaa, että navigointipalkkeja, vaikka ne olisivat visuaalisesti tyylitelty välilehdiksi .nav-tabsluokan kanssa, ei pitäisi antaa role="tablist", role="tab"tai role="tabpanel"attribuutteja. Nämä sopivat vain dynaamisille välilehtiliittymille, kuten ARIA Authoring Practices Guide -välilehtimallissa kuvataan . Katso esimerkki dynaamisten välilehtiliittymien JavaScript-käyttäytymisestä tässä osiossa. Attribuuttia aria-currentei tarvita dynaamisissa välilehtiliittymissä, koska JavaScript käsittelee valitun tilan lisäämällä aria-selected="true"aktiiviseen välilehteen.

Pudotusvalikoiden käyttäminen

Lisää avattavat valikot hieman ylimääräisellä HTML-koodilla ja avattavalla JavaScript-laajennuksella .

Välilehdet avattavilla valikoilla

html

<ul class="nav nav-tabs">
  <li class="nav-item">
    <a class="nav-link active" aria-current="page" href="#">Active</a>
  </li>
  <li class="nav-item dropdown">
    <a class="nav-link dropdown-toggle" data-bs-toggle="dropdown" href="#" role="button" aria-expanded="false">Dropdown</a>
    <ul class="dropdown-menu">
      <li><a class="dropdown-item" href="#">Action</a></li>
      <li><a class="dropdown-item" href="#">Another action</a></li>
      <li><a class="dropdown-item" href="#">Something else here</a></li>
      <li><hr class="dropdown-divider"></li>
      <li><a class="dropdown-item" href="#">Separated link</a></li>
    </ul>
  </li>
  <li class="nav-item">
    <a class="nav-link" href="#">Link</a>
  </li>
  <li class="nav-item">
    <a class="nav-link disabled">Disabled</a>
  </li>
</ul>

Pillerit pudotusvalikoilla

html

<ul class="nav nav-pills">
  <li class="nav-item">
    <a class="nav-link active" aria-current="page" href="#">Active</a>
  </li>
  <li class="nav-item dropdown">
    <a class="nav-link dropdown-toggle" data-bs-toggle="dropdown" href="#" role="button" aria-expanded="false">Dropdown</a>
    <ul class="dropdown-menu">
      <li><a class="dropdown-item" href="#">Action</a></li>
      <li><a class="dropdown-item" href="#">Another action</a></li>
      <li><a class="dropdown-item" href="#">Something else here</a></li>
      <li><hr class="dropdown-divider"></li>
      <li><a class="dropdown-item" href="#">Separated link</a></li>
    </ul>
  </li>
  <li class="nav-item">
    <a class="nav-link" href="#">Link</a>
  </li>
  <li class="nav-item">
    <a class="nav-link disabled">Disabled</a>
  </li>
</ul>

CSS

Muuttujat

Lisätty versioon 5.2.0

Osana Bootstrapin kehittyvää CSS-muuttujien lähestymistapaa navigaattorit käyttävät nyt paikallisia CSS-muuttujia .nav, .nav-tabs, ja .nav-pillsparannettuaan reaaliaikaista räätälöintiä. CSS-muuttujien arvot asetetaan Sassin kautta, joten myös Sass-räätälöinti on edelleen tuettu.

Perusluokassa .nav:

  --#{$prefix}nav-link-padding-x: #{$nav-link-padding-x};
  --#{$prefix}nav-link-padding-y: #{$nav-link-padding-y};
  @include rfs($nav-link-font-size, --#{$prefix}nav-link-font-size);
  --#{$prefix}nav-link-font-weight: #{$nav-link-font-weight};
  --#{$prefix}nav-link-color: #{$nav-link-color};
  --#{$prefix}nav-link-hover-color: #{$nav-link-hover-color};
  --#{$prefix}nav-link-disabled-color: #{$nav-link-disabled-color};

Muutosluokassa .nav-tabs:

  --#{$prefix}nav-tabs-border-width: #{$nav-tabs-border-width};
  --#{$prefix}nav-tabs-border-color: #{$nav-tabs-border-color};
  --#{$prefix}nav-tabs-border-radius: #{$nav-tabs-border-radius};
  --#{$prefix}nav-tabs-link-hover-border-color: #{$nav-tabs-link-hover-border-color};
  --#{$prefix}nav-tabs-link-active-color: #{$nav-tabs-link-active-color};
  --#{$prefix}nav-tabs-link-active-bg: #{$nav-tabs-link-active-bg};
  --#{$prefix}nav-tabs-link-active-border-color: #{$nav-tabs-link-active-border-color};

Muutosluokassa .nav-pills:

  --#{$prefix}nav-pills-border-radius: #{$nav-pills-border-radius};
  --#{$prefix}nav-pills-link-active-color: #{$nav-pills-link-active-color};
  --#{$prefix}nav-pills-link-active-bg: #{$nav-pills-link-active-bg};

Sass muuttujat

$nav-link-padding-y:                .5rem;
$nav-link-padding-x:                1rem;
$nav-link-font-size:                null;
$nav-link-font-weight:              null;
$nav-link-color:                    var(--#{$prefix}link-color);
$nav-link-hover-color:              var(--#{$prefix}link-hover-color);
$nav-link-transition:               color .15s ease-in-out, background-color .15s ease-in-out, border-color .15s ease-in-out;
$nav-link-disabled-color:           $gray-600;

$nav-tabs-border-color:             $gray-300;
$nav-tabs-border-width:             $border-width;
$nav-tabs-border-radius:            $border-radius;
$nav-tabs-link-hover-border-color:  $gray-200 $gray-200 $nav-tabs-border-color;
$nav-tabs-link-active-color:        $gray-700;
$nav-tabs-link-active-bg:           $body-bg;
$nav-tabs-link-active-border-color: $gray-300 $gray-300 $nav-tabs-link-active-bg;

$nav-pills-border-radius:           $border-radius;
$nav-pills-link-active-color:       $component-active-color;
$nav-pills-link-active-bg:          $component-active-bg;

JavaScript-käyttäytyminen

Käytä välilehden JavaScript-laajennusta – sisällytä se yksittäin tai käännetyn bootstrap.jstiedoston kautta – laajentaaksesi navigointivälilehtiämme ja pillereitämme luodaksesi välilehtiruutuja paikallisesta sisällöstä.

Tämä on paikkamerkkisisältöä, joka liittyy Etusivu-välilehteen . Toisen välilehden napsauttaminen vaihtaa tämän näkyvyyden seuraavalle välilehdelle. JavaScript-välilehti vaihtaa luokkia hallitakseen sisällön näkyvyyttä ja tyyliä. Voit käyttää sitä välilehtien, pillereiden ja minkä tahansa muun .navnavigoinnin kanssa.

Tämä on paikkamerkkisisältöä, joka liittyy Profiili-välilehteen . Toisen välilehden napsauttaminen vaihtaa tämän näkyvyyden seuraavalle välilehdelle. JavaScript-välilehti vaihtaa luokkia hallitakseen sisällön näkyvyyttä ja tyyliä. Voit käyttää sitä välilehtien, pillereiden ja minkä tahansa muun .navnavigoinnin kanssa.

This is some placeholder content the Contact tab's associated content. Clicking another tab will toggle the visibility of this one for the next. The tab JavaScript swaps classes to control the content visibility and styling. You can use it with tabs, pills, and any other .nav-powered navigation.

This is some placeholder content the Disabled tab's associated content.

<ul class="nav nav-tabs" id="myTab" role="tablist">
  <li class="nav-item" role="presentation">
    <button class="nav-link active" id="home-tab" data-bs-toggle="tab" data-bs-target="#home-tab-pane" type="button" role="tab" aria-controls="home-tab-pane" aria-selected="true">Home</button>
  </li>
  <li class="nav-item" role="presentation">
    <button class="nav-link" id="profile-tab" data-bs-toggle="tab" data-bs-target="#profile-tab-pane" type="button" role="tab" aria-controls="profile-tab-pane" aria-selected="false">Profile</button>
  </li>
  <li class="nav-item" role="presentation">
    <button class="nav-link" id="contact-tab" data-bs-toggle="tab" data-bs-target="#contact-tab-pane" type="button" role="tab" aria-controls="contact-tab-pane" aria-selected="false">Contact</button>
  </li>
  <li class="nav-item" role="presentation">
    <button class="nav-link" id="disabled-tab" data-bs-toggle="tab" data-bs-target="#disabled-tab-pane" type="button" role="tab" aria-controls="disabled-tab-pane" aria-selected="false" disabled>Disabled</button>
  </li>
</ul>
<div class="tab-content" id="myTabContent">
  <div class="tab-pane fade show active" id="home-tab-pane" role="tabpanel" aria-labelledby="home-tab" tabindex="0">...</div>
  <div class="tab-pane fade" id="profile-tab-pane" role="tabpanel" aria-labelledby="profile-tab" tabindex="0">...</div>
  <div class="tab-pane fade" id="contact-tab-pane" role="tabpanel" aria-labelledby="contact-tab" tabindex="0">...</div>
  <div class="tab-pane fade" id="disabled-tab-pane" role="tabpanel" aria-labelledby="disabled-tab" tabindex="0">...</div>
</div>

Jotta tämä vastaa tarpeitasi, tämä toimii <ul>yllä olevan kuvan mukaisella merkinnällä tai millä tahansa mielivaltaisella "rullaa omalla" merkinnällä. Huomaa, että jos käytät <nav>, sinun ei pitäisi lisätä role="tablist"siihen suoraan, koska se ohittaisi elementin alkuperäisen roolin navigoinnin maamerkkinä. Vaihda sen sijaan vaihtoehtoiseen elementtiin (alla olevassa esimerkissä yksinkertainen <div>) ja kääri sen <nav>ympärille.

This is some placeholder content the Profile tab's associated content. Clicking another tab will toggle the visibility of this one for the next. The tab JavaScript swaps classes to control the content visibility and styling. You can use it with tabs, pills, and any other .nav-powered navigation.

This is some placeholder content the Disabled tab's associated content.

<nav>
  <div class="nav nav-tabs" id="nav-tab" role="tablist">
    <button class="nav-link active" id="nav-home-tab" data-bs-toggle="tab" data-bs-target="#nav-home" type="button" role="tab" aria-controls="nav-home" aria-selected="true">Home</button>
    <button class="nav-link" id="nav-profile-tab" data-bs-toggle="tab" data-bs-target="#nav-profile" type="button" role="tab" aria-controls="nav-profile" aria-selected="false">Profile</button>
    <button class="nav-link" id="nav-contact-tab" data-bs-toggle="tab" data-bs-target="#nav-contact" type="button" role="tab" aria-controls="nav-contact" aria-selected="false">Contact</button>
    <button class="nav-link" id="nav-disabled-tab" data-bs-toggle="tab" data-bs-target="#nav-disabled" type="button" role="tab" aria-controls="nav-disabled" aria-selected="false" disabled>Disabled</button>
  </div>
</nav>
<div class="tab-content" id="nav-tabContent">
  <div class="tab-pane fade show active" id="nav-home" role="tabpanel" aria-labelledby="nav-home-tab" tabindex="0">...</div>
  <div class="tab-pane fade" id="nav-profile" role="tabpanel" aria-labelledby="nav-profile-tab" tabindex="0">...</div>
  <div class="tab-pane fade" id="nav-contact" role="tabpanel" aria-labelledby="nav-contact-tab" tabindex="0">...</div>
  <div class="tab-pane fade" id="nav-disabled" role="tabpanel" aria-labelledby="nav-disabled-tab" tabindex="0">...</div>
</div>

Välilehdet-laajennus toimii myös pillereiden kanssa.

This is some placeholder content the Disabled tab's associated content.

<ul class="nav nav-pills mb-3" id="pills-tab" role="tablist">
  <li class="nav-item" role="presentation">
    <button class="nav-link active" id="pills-home-tab" data-bs-toggle="pill" data-bs-target="#pills-home" type="button" role="tab" aria-controls="pills-home" aria-selected="true">Home</button>
  </li>
  <li class="nav-item" role="presentation">
    <button class="nav-link" id="pills-profile-tab" data-bs-toggle="pill" data-bs-target="#pills-profile" type="button" role="tab" aria-controls="pills-profile" aria-selected="false">Profile</button>
  </li>
  <li class="nav-item" role="presentation">
    <button class="nav-link" id="pills-contact-tab" data-bs-toggle="pill" data-bs-target="#pills-contact" type="button" role="tab" aria-controls="pills-contact" aria-selected="false">Contact</button>
  </li>
  <li class="nav-item" role="presentation">
    <button class="nav-link" id="pills-disabled-tab" data-bs-toggle="pill" data-bs-target="#pills-disabled" type="button" role="tab" aria-controls="pills-disabled" aria-selected="false" disabled>Disabled</button>
  </li>
</ul>
<div class="tab-content" id="pills-tabContent">
  <div class="tab-pane fade show active" id="pills-home" role="tabpanel" aria-labelledby="pills-home-tab" tabindex="0">...</div>
  <div class="tab-pane fade" id="pills-profile" role="tabpanel" aria-labelledby="pills-profile-tab" tabindex="0">...</div>
  <div class="tab-pane fade" id="pills-contact" role="tabpanel" aria-labelledby="pills-contact-tab" tabindex="0">...</div>
  <div class="tab-pane fade" id="pills-disabled" role="tabpanel" aria-labelledby="pills-disabled-tab" tabindex="0">...</div>
</div>

Ja pystypillereillä. Ihannetapauksessa pystysuuntaisia välilehtiä varten sinun pitäisi lisätä aria-orientation="vertical"myös välilehtiluettelon säilöön.

This is some placeholder content the Disabled tab's associated content.

This is some placeholder content the Messages tab's associated content. Clicking another tab will toggle the visibility of this one for the next. The tab JavaScript swaps classes to control the content visibility and styling. You can use it with tabs, pills, and any other .nav-powered navigation.

This is some placeholder content the Settings tab's associated content. Clicking another tab will toggle the visibility of this one for the next. The tab JavaScript swaps classes to control the content visibility and styling. You can use it with tabs, pills, and any other .nav-powered navigation.

<div class="d-flex align-items-start">
  <div class="nav flex-column nav-pills me-3" id="v-pills-tab" role="tablist" aria-orientation="vertical">
    <button class="nav-link active" id="v-pills-home-tab" data-bs-toggle="pill" data-bs-target="#v-pills-home" type="button" role="tab" aria-controls="v-pills-home" aria-selected="true">Home</button>
    <button class="nav-link" id="v-pills-profile-tab" data-bs-toggle="pill" data-bs-target="#v-pills-profile" type="button" role="tab" aria-controls="v-pills-profile" aria-selected="false">Profile</button>
    <button class="nav-link" id="v-pills-disabled-tab" data-bs-toggle="pill" data-bs-target="#v-pills-disabled" type="button" role="tab" aria-controls="v-pills-disabled" aria-selected="false" disabled>Disabled</button>
    <button class="nav-link" id="v-pills-messages-tab" data-bs-toggle="pill" data-bs-target="#v-pills-messages" type="button" role="tab" aria-controls="v-pills-messages" aria-selected="false">Messages</button>
    <button class="nav-link" id="v-pills-settings-tab" data-bs-toggle="pill" data-bs-target="#v-pills-settings" type="button" role="tab" aria-controls="v-pills-settings" aria-selected="false">Settings</button>
  </div>
  <div class="tab-content" id="v-pills-tabContent">
    <div class="tab-pane fade show active" id="v-pills-home" role="tabpanel" aria-labelledby="v-pills-home-tab" tabindex="0">...</div>
    <div class="tab-pane fade" id="v-pills-profile" role="tabpanel" aria-labelledby="v-pills-profile-tab" tabindex="0">...</div>
    <div class="tab-pane fade" id="v-pills-disabled" role="tabpanel" aria-labelledby="v-pills-disabled-tab" tabindex="0">...</div>
    <div class="tab-pane fade" id="v-pills-messages" role="tabpanel" aria-labelledby="v-pills-messages-tab" tabindex="0">...</div>
    <div class="tab-pane fade" id="v-pills-settings" role="tabpanel" aria-labelledby="v-pills-settings-tab" tabindex="0">...</div>
  </div>
</div>

Esteettömyys

Dynaamiset välilehdet, jotka on kuvattu ARIA Authoring Practices Guide -välilehtimallissa , vaativat role="tablist", role="tab", role="tabpanel"ja aria-lisäattribuutteja, jotta niiden rakenne, toiminnallisuus ja nykyinen tila voidaan välittää aputekniikoiden (kuten näytönlukuohjelmien) käyttäjille. Parhaana käytäntönä suosittelemme <button>elementtien käyttöä välilehdissä, koska nämä ovat säätimiä, jotka käynnistävät dynaamisen muutoksen uudelle sivulle tai sijaintiin siirtyvien linkkien sijaan.

ARIA Authoring Practices -mallin mukaisesti vain tällä hetkellä aktiivinen välilehti saa näppäimistökohdistuksen. Kun JavaScript-laajennus alustetaan, se asetetaan tabindex="-1"kaikkiin ei-aktiivisiin välilehtien ohjaimiin. Kun tällä hetkellä aktiivinen välilehti on kohdistettu, kohdistinnäppäimet aktivoivat edellisen/seuraavan välilehden, ja laajennus muuttaa kiertämistätabindex vastaavasti. Huomaa kuitenkin, että JavaScript-laajennus ei tee eroa vaaka- ja pystyvälilehtiluetteloiden välillä kohdistinnäppäinten vuorovaikutuksessa: välilehtiluettelon suunnasta riippumatta sekä ylä- että vasen kohdistin siirtyvät edelliseen välilehteen ja ala- ja oikea kohdistin seuraava välilehti.

Yleisesti ottaen näppäimistöllä liikkumisen helpottamiseksi on suositeltavaa tehdä myös itse välilehtipaneelit tarkennettavissa, ellei välilehtipaneelin ensimmäinen merkityksellistä sisältöä sisältävä elementti ole jo tarkennettavissa. JavaScript-laajennus ei yritä käsitellä tätä näkökohtaa – tarvittaessa sinun on tehtävä välilehtipaneelit tarkennettavissa lisäämällä tabindex="0"merkintäsi.

Välilehden JavaScript-laajennus ei tue avattavia valikoita sisältäviä välilehtiliittymiä, koska ne aiheuttavat sekä käytettävyys- että saavutettavuusongelmia. Käytettävyyden kannalta se, että tällä hetkellä näytettävän välilehden laukaisuelementti ei ole heti näkyvissä (koska se on suljetun avattavan valikon sisällä), voi aiheuttaa sekaannusta. Saavutettavuuden näkökulmasta tällä hetkellä ei ole järkevää tapaa kartoittaa tällaista rakennetta standardi WAI ARIA -malliin, mikä tarkoittaa, että sitä ei voida helposti tehdä ymmärrettäväksi aputekniikoiden käyttäjille.

Tietoattribuuttien käyttäminen

Voit aktivoida välilehden tai pillerinavigoinnin kirjoittamatta JavaScriptiä yksinkertaisesti määrittämällä data-bs-toggle="tab"tai data-bs-toggle="pill"elementin päälle. Käytä näitä tietomääritteitä kohdassa .nav-tabstai .nav-pills.

<!-- Nav tabs -->
<ul class="nav nav-tabs" id="myTab" role="tablist">
  <li class="nav-item" role="presentation">
    <button class="nav-link active" id="home-tab" data-bs-toggle="tab" data-bs-target="#home" type="button" role="tab" aria-controls="home" aria-selected="true">Home</button>
  </li>
  <li class="nav-item" role="presentation">
    <button class="nav-link" id="profile-tab" data-bs-toggle="tab" data-bs-target="#profile" type="button" role="tab" aria-controls="profile" aria-selected="false">Profile</button>
  </li>
  <li class="nav-item" role="presentation">
    <button class="nav-link" id="messages-tab" data-bs-toggle="tab" data-bs-target="#messages" type="button" role="tab" aria-controls="messages" aria-selected="false">Messages</button>
  </li>
  <li class="nav-item" role="presentation">
    <button class="nav-link" id="settings-tab" data-bs-toggle="tab" data-bs-target="#settings" type="button" role="tab" aria-controls="settings" aria-selected="false">Settings</button>
  </li>
</ul>

<!-- Tab panes -->
<div class="tab-content">
  <div class="tab-pane active" id="home" role="tabpanel" aria-labelledby="home-tab" tabindex="0">...</div>
  <div class="tab-pane" id="profile" role="tabpanel" aria-labelledby="profile-tab" tabindex="0">...</div>
  <div class="tab-pane" id="messages" role="tabpanel" aria-labelledby="messages-tab" tabindex="0">...</div>
  <div class="tab-pane" id="settings" role="tabpanel" aria-labelledby="settings-tab" tabindex="0">...</div>
</div>

JavaScriptin kautta

Ota välilehdet käyttöön JavaScriptin kautta (jokainen välilehti on aktivoitava erikseen):

const triggerTabList = document.querySelectorAll('#myTab button')
triggerTabList.forEach(triggerEl => {
  const tabTrigger = new bootstrap.Tab(triggerEl)

  triggerEl.addEventListener('click', event => {
    event.preventDefault()
    tabTrigger.show()
  })
})

Voit aktivoida yksittäisiä välilehtiä useilla tavoilla:

const triggerEl = document.querySelector('#myTab button[data-bs-target="#profile"]')
bootstrap.Tab.getInstance(triggerEl).show() // Select tab by name

const triggerFirstTabEl = document.querySelector('#myTab li:first-child button')
bootstrap.Tab.getInstance(triggerFirstTabEl).show() // Select first tab

Häivytysefekti

Saat välilehdet häivyttää lisäämällä .fadekuhunkin .tab-pane. Ensimmäisen välilehtiruudun on myös .showtehtävä alkuperäinen sisältö näkyväksi.

<div class="tab-content">
  <div class="tab-pane fade show active" id="home" role="tabpanel" aria-labelledby="home-tab" tabindex="0">...</div>
  <div class="tab-pane fade" id="profile" role="tabpanel" aria-labelledby="profile-tab" tabindex="0">...</div>
  <div class="tab-pane fade" id="messages" role="tabpanel" aria-labelledby="messages-tab" tabindex="0">...</div>
  <div class="tab-pane fade" id="settings" role="tabpanel" aria-labelledby="settings-tab" tabindex="0">...</div>
</div>

menetelmät

Asynkroniset menetelmät ja siirtymät

Kaikki API - menetelmät ovat asynkronisia ja aloittavat siirtymän . He palaavat soittajan luo heti siirtymisen alkaessa, mutta ennen sen päättymistä . Lisäksi siirtyvän komponentin menetelmäkutsu jätetään huomioimatta .

Katso lisätietoja JavaScript - dokumentaatiostamme .

Aktivoi sisältösi välilehtielementiksi.

Voit luoda välilehden esiintymän rakentajalla, esimerkiksi:

const bsTab = new bootstrap.Tab('#myTab')

Menetelmä	Kuvaus
`dispose`	Tuhoaa elementin välilehden.
`getInstance`	Staattinen menetelmä, jonka avulla voit saada DOM-elementtiin liittyvän välilehden esiintymän, voit käyttää sitä seuraavasti: `bootstrap.Tab.getInstance(element)`.
`getOrCreateInstance`	Staattinen menetelmä, joka palauttaa DOM-elementtiin liitetyn välilehden esiintymän tai luo uuden, jos sitä ei ole alustettu. Voit käyttää sitä näin: `bootstrap.Tab.getOrCreateInstance(element)`.
`show`	Valitsee välilehden ja näyttää siihen liittyvän ruudun. Kaikki muut aiemmin valitut välilehdet jäävät valitsemattomiksi ja niihin liittyvä ruutu piilotetaan. Palaa soittajalle ennen kuin välilehtiruutu on todella näytetty (eli ennen `shown.bs.tab`tapahtumaa).

Tapahtumat

Kun uusi välilehti näytetään, tapahtumat käynnistyvät seuraavassa järjestyksessä:

hide.bs.tab(nykyisellä aktiivisella välilehdellä)
show.bs.tab(näytettävissä välilehdellä)
hidden.bs.tab(edellisellä aktiivisella välilehdellä sama kuin hide.bs.tabtapahtumalla)
shown.bs.tab(äskettäin aktiivisella juuri näytetyllä välilehdellä, sama kuin show.bs.tabtapahtumassa)

Jos mikään välilehti ei ollut jo aktiivinen, hide.bs.tabja hidden.bs.tabtapahtumia ei käynnistetä.

Tapahtumatyyppi	Kuvaus
`hide.bs.tab`	Tämä tapahtuma käynnistyy, kun uusi välilehti näytetään (ja siten edellinen aktiivinen välilehti piilotetaan). Käytä `event.target`ja `event.relatedTarget`kohdistaaksesi nykyiseen aktiiviseen välilehteen ja uuteen pian aktiiviseen välilehteen.
`hidden.bs.tab`	Tämä tapahtuma käynnistyy, kun uusi välilehti näytetään (ja siten edellinen aktiivinen välilehti piilotetaan). Käytä `event.target`ja `event.relatedTarget`kohdistaaksesi edelliseen aktiiviseen välilehteen ja uuteen aktiiviseen välilehteen.
`show.bs.tab`	Tämä tapahtuma käynnistyy välilehtien näyttämisen yhteydessä, mutta ennen kuin uusi välilehti on näytetty. Käytä `event.target`ja `event.relatedTarget`kohdistaaksesi aktiiviseen välilehteen ja edelliseen aktiiviseen välilehteen (jos saatavilla).
`shown.bs.tab`	Tämä tapahtuma käynnistyy välilehden näyttämisen yhteydessä, kun välilehti on näytetty. Käytä `event.target`ja `event.relatedTarget`kohdistaaksesi aktiiviseen välilehteen ja edelliseen aktiiviseen välilehteen (jos saatavilla).

const tabEl = document.querySelector('button[data-bs-toggle="tab"]')
tabEl.addEventListener('shown.bs.tab', event => {
  event.target // newly activated tab
  event.relatedTarget // previous active tab
})