Navigatie en tabbladen

Documentatie en voorbeelden voor het gebruik van de meegeleverde navigatiecomponenten van Bootstrap.

Op deze pagina

Basisnavigatiesysteem

Navigatie beschikbaar in Bootstrap deelt algemene markeringen en stijlen, van de basisklasse .navtot de actieve en uitgeschakelde statussen. Wissel modificatieklassen om tussen elke stijl te schakelen.

De .navbasiscomponent is gebouwd met flexbox en biedt een sterke basis voor het bouwen van alle soorten navigatiecomponenten. Het bevat een aantal stijloverschrijvingen (voor het werken met lijsten), een aantal linkpadding voor grotere hitgebieden en een standaard uitgeschakelde styling.

De .navbasiscomponent bevat geen .activestaat. De volgende voorbeelden bevatten de klasse, voornamelijk om aan te tonen dat deze specifieke klasse geen speciale styling veroorzaakt.

Om de actieve status over te brengen naar ondersteunende technologieën, gebruikt u het aria-currentattribuut — met de pagewaarde voor de huidige pagina of truevoor het huidige item in een set.

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>

Klassen worden overal gebruikt, dus je opmaak kan superflexibel zijn. Gebruik <ul>s zoals hierboven, <ol>als de volgorde van je items belangrijk is, of rol er zelf een met een <nav>element. Omdat het .navgebruik display: flex, gedragen de nav-links zich hetzelfde als nav-items, maar zonder de extra opmaak.

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>

Beschikbare stijlen

Verander de stijl van .navs-component met modifiers en hulpprogramma's. Mix en match indien nodig, of bouw er zelf een.

Horizontale uitlijning

Verander de horizontale uitlijning van uw navigatiesysteem met flexbox-hulpprogramma's . Standaard zijn navigatiesystemen links uitgelijnd, maar u kunt ze eenvoudig wijzigen in gecentreerd of rechts uitgelijnd.

Gecentreerd met .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>

Rechts uitgelijnd met .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>

Verticaal

Stapel uw navigatie door de richting van het flexitem te wijzigen met het .flex-columnhulpprogramma. Moet u ze op sommige viewports stapelen, maar niet op andere? Gebruik de responsieve versies (bijv. .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>

Zoals altijd is verticale navigatie ook mogelijk zonder <ul>s.

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>

Tabbladen

Neemt de basisnavigatie van boven en voegt de .nav-tabsklasse toe om een interface met tabbladen te genereren. Gebruik ze om tabbable-regio's te maken met onze JavaScript-plug-in voor tabbladen .

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>

Pillen

Neem dezelfde HTML, maar gebruik .nav-pillsin plaats daarvan:

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>

Invullen en uitvullen

Forceer .navde inhoud van uw 's om de volledige beschikbare breedte uit te breiden met een van de twee modificatieklassen. Om alle beschikbare ruimte proportioneel te vullen met uw .nav-items, gebruikt u .nav-fill. Merk op dat alle horizontale ruimte bezet is, maar dat niet elk navigatie-item dezelfde breedte heeft.

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>

Wanneer u een <nav>navigatie op basis gebruikt, kunt u deze veilig weglaten .nav-item, aangezien dit alleen .nav-linknodig is voor <a>stijlelementen.

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>

Gebruik voor elementen van gelijke breedte .nav-justified. Alle horizontale ruimte wordt ingenomen door navigatielinks, maar in tegenstelling tot het .nav-fillbovenstaande zal elk navigatie-item dezelfde breedte hebben.

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>

Vergelijkbaar met het .nav-fillvoorbeeld met een <nav>-gebaseerde navigatie.

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>

Werken met flexhulpprogramma's

Als je responsieve navigatievariaties nodig hebt, overweeg dan om een reeks flexbox-hulpprogramma's te gebruiken . Hoewel ze uitgebreider zijn, bieden deze hulpprogramma's meer maatwerk voor responsieve onderbrekingspunten. In het onderstaande voorbeeld wordt onze navigatie gestapeld op het laagste breekpunt en vervolgens aangepast aan een horizontale lay-out die de beschikbare breedte vult vanaf het kleine breekpunt.

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>

Wat betreft toegankelijkheid

Als je navigatie gebruikt om een navigatiebalk te bieden, zorg er dan voor dat je een a toevoegt role="navigation"aan de meest logische bovenliggende container van de <ul>, of een <nav>element rond de hele navigatie plaatst. Voeg de rol niet toe aan de functie <ul>zelf, omdat dit zou voorkomen dat deze door ondersteunende technologieën als een echte lijst wordt aangekondigd.

Merk op dat navigatiebalken, zelfs als ze visueel zijn gestileerd als tabbladen met de .nav-tabsklasse, niet mogen worden gegeven role="tablist", role="tab"of role="tabpanel"attributen. Deze zijn alleen geschikt voor dynamische interfaces met tabbladen, zoals beschreven in het tabbladenpatroon van de ARIA Authoring Practices Guide . Zie JavaScript-gedrag voor dynamische interfaces met tabbladen in dit gedeelte voor een voorbeeld. Het aria-currentattribuut is niet nodig op dynamische interfaces met tabbladen, omdat ons JavaScript de geselecteerde status afhandelt door aria-selected="true"het actieve tabblad toe te voegen.

Vervolgkeuzelijsten gebruiken

Voeg dropdown menu's toe met een beetje extra HTML en de dropdowns JavaScript plugin .

Tabbladen met vervolgkeuzelijsten

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>

Pillen met vervolgkeuzelijsten

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

Variabelen

Toegevoegd in v5.2.0

Als onderdeel van Bootstrap's evoluerende benadering van CSS-variabelen, gebruiken navigatiesystemen nu lokale CSS-variabelen op .nav, .nav-tabs, en .nav-pillsvoor verbeterde realtime aanpassingen. Waarden voor de CSS-variabelen worden ingesteld via Sass, dus Sass-aanpassing wordt ook nog steeds ondersteund.

In de .navbasisklasse:

  --#{$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};

Op de .nav-tabsmodificatieklasse:

  --#{$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};

Op de .nav-pillsmodificatieklasse:

  --#{$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-variabelen

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

Gebruik de JavaScript-plug-in voor tabbladen - neem deze afzonderlijk of via het gecompileerde bootstrap.jsbestand op - om onze navigatietabbladen en -pillen uit te breiden om tabbare vensters met lokale inhoud te maken.

Dit is een tijdelijke inhoud van de inhoud van het tabblad Start . Als u op een ander tabblad klikt, wordt de zichtbaarheid van dit tabblad voor het volgende gewijzigd. Het tabblad JavaScript wisselt klassen om de zichtbaarheid en stijl van de inhoud te regelen. Je kunt het gebruiken met tabbladen, pillen en elke andere .navnavigatie.

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

Om aan uw behoeften te voldoen, werkt dit met opmaak op basis van <ul>markeringen, zoals hierboven weergegeven, of met een willekeurige "rol uw eigen" opmaak. Houd er rekening mee dat als u gebruikt <nav>, u er niet role="tablist"rechtstreeks aan moet toevoegen, omdat dit de oorspronkelijke rol van het element als navigatieoriëntatiepunt zou overschrijven. Schakel in plaats daarvan over naar een alternatief element (in het onderstaande voorbeeld een eenvoudige <div>) en wikkel <nav>er omheen.

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>

De plug-in voor tabbladen werkt ook met pillen.

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>

En met verticale pillen. Idealiter moet u voor verticale tabbladen ook toevoegen aria-orientation="vertical"aan de container met tabbladen.

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>

Toegankelijkheid

Dynamische interfaces met tabbladen, zoals beschreven in de ARIA Authoring Practices Guide-tabbladenpatroon , role="tablist", role="tab", role="tabpanel"en aanvullende aria-attributen om hun structuur, functionaliteit en huidige status over te brengen aan gebruikers van ondersteunende technologieën (zoals schermlezers). Als best practice raden we aan om <button>elementen voor de tabbladen te gebruiken, omdat dit besturingselementen zijn die een dynamische verandering teweegbrengen, in plaats van links die naar een nieuwe pagina of locatie navigeren.

In overeenstemming met het ARIA Authoring Practices-patroon krijgt alleen het momenteel actieve tabblad toetsenbordfocus. Wanneer de JavaScript-plug-in is geïnitialiseerd, wordt deze ingesteld tabindex="-1"op alle inactieve tabbladbesturingselementen. Zodra het momenteel actieve tabblad de focus heeft, activeren de cursortoetsen het vorige/volgende tabblad, waarbij de plug-in de rovingtabindex dienovereenkomstig verandert. Houd er echter rekening mee dat de JavaScript-plug-in geen onderscheid maakt tussen horizontale en verticale tablijsten als het gaat om interactie met de cursortoetsen: ongeacht de oriëntatie van de tablijst gaan zowel de cursor omhoog als de linkercursor naar het vorige tabblad, en de cursor omlaag en naar rechts gaan naar het volgende tabblad.

Over het algemeen wordt aanbevolen om, om toetsenbordnavigatie te vergemakkelijken, de tabbladpanelen zelf ook focusseerbaar te maken, tenzij het eerste element met zinvolle inhoud in het tabbladpaneel al focusseerbaar is. De JavaScript-plug-in probeert dit aspect niet aan te pakken - waar van toepassing, moet u uw tabbladpanelen expliciet focusbaar maken door tabindex="0"uw opmaak toe te voegen.

De JavaScript-plug- in voor tabbladen ondersteunt geen interfaces met tabbladen die vervolgkeuzemenu's bevatten, omdat deze zowel bruikbaarheids- als toegankelijkheidsproblemen veroorzaken. Vanuit het oogpunt van bruikbaarheid kan het feit dat het triggerelement van het momenteel weergegeven tabblad niet onmiddellijk zichtbaar is (aangezien het in het gesloten vervolgkeuzemenu staat) voor verwarring zorgen. Vanuit het oogpunt van toegankelijkheid is er momenteel geen verstandige manier om dit soort constructies in kaart te brengen in een standaard WAI ARIA-patroon, wat betekent dat het niet gemakkelijk begrijpelijk kan worden gemaakt voor gebruikers van ondersteunende technologieën.

Gegevenskenmerken gebruiken

U kunt een tab- of pill-navigatie activeren zonder JavaScript te schrijven door simpelweg data-bs-toggle="tab"of data-bs-toggle="pill"op een element te specificeren. Gebruik deze gegevensattributen op .nav-tabsof .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>

Via JavaScript

Tabbladen met tabbladen inschakelen via JavaScript (elk tabblad moet afzonderlijk worden geactiveerd):

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

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

U kunt afzonderlijke tabbladen op verschillende manieren activeren:

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

Fade-effect

.fadeVoeg aan elk toe om tabbladen te laten infaden .tab-pane. Het eerste tabblad moet ook .showde initiële inhoud zichtbaar maken.

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

Methoden:

Asynchrone methoden en overgangen

Alle API-methoden zijn asynchroon en starten een transitie . Ze keren terug naar de beller zodra de overgang is gestart maar voordat deze eindigt . Bovendien wordt een methodeaanroep op een overgangscomponent genegeerd .

Zie onze JavaScript-documentatie voor meer informatie .

Activeert uw inhoud als een tabbladelement.

U kunt een tabbladinstantie maken met de constructor, bijvoorbeeld:

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

Methode	Beschrijving
`dispose`	Vernietigt het tabblad van een element.
`getInstance`	Statische methode waarmee u de tab-instantie kunt koppelen aan een DOM-element, u kunt deze als volgt gebruiken: `bootstrap.Tab.getInstance(element)`.
`getOrCreateInstance`	Statische methode die een tab-instantie retourneert die is gekoppeld aan een DOM-element of een nieuwe maakt voor het geval deze niet is geïnitialiseerd. Je kunt het als volgt gebruiken: `bootstrap.Tab.getOrCreateInstance(element)`.
`show`	Selecteert het gegeven tabblad en toont het bijbehorende paneel. Elk ander tabblad dat eerder was geselecteerd, wordt gedeselecteerd en het bijbehorende paneel wordt verborgen. Keert terug naar de beller voordat het tabblad daadwerkelijk is weergegeven (dwz voordat de `shown.bs.tab`gebeurtenis plaatsvindt).

Evenementen

Wanneer een nieuw tabblad wordt weergegeven, worden de gebeurtenissen in de volgende volgorde geactiveerd:

hide.bs.tab(op het huidige actieve tabblad)
show.bs.tab(op het te tonen tabblad)
hidden.bs.tab(op het vorige actieve tabblad, hetzelfde als voor het hide.bs.tabevenement)
shown.bs.tab(op het nieuw actieve tabblad dat zojuist is weergegeven, dezelfde als voor de show.bs.tabgebeurtenis)

Als er al geen tabblad actief was, worden de gebeurtenissen hide.bs.taben hidden.bs.tabniet geactiveerd.

Evenementtype	Beschrijving
`hide.bs.tab`	Deze gebeurtenis wordt geactiveerd wanneer een nieuw tabblad moet worden weergegeven (en dus het vorige actieve tabblad moet worden verborgen). Gebruik `event.target`en om respectievelijk `event.relatedTarget`het huidige actieve tabblad en het nieuwe binnenkort actieve tabblad te targeten.
`hidden.bs.tab`	Deze gebeurtenis wordt geactiveerd nadat een nieuw tabblad is weergegeven (en dus het vorige actieve tabblad is verborgen). Gebruik `event.target`en `event.relatedTarget`om respectievelijk het vorige actieve tabblad en het nieuwe actieve tabblad te targeten.
`show.bs.tab`	Deze gebeurtenis wordt geactiveerd bij tabshow, maar voordat het nieuwe tabblad is weergegeven. Gebruik `event.target`en `event.relatedTarget`om respectievelijk het actieve tabblad en het vorige actieve tabblad (indien beschikbaar) te targeten.
`shown.bs.tab`	Deze gebeurtenis wordt geactiveerd bij tabshow nadat een tabblad is weergegeven. Gebruik `event.target`en `event.relatedTarget`om respectievelijk het actieve tabblad en het vorige actieve tabblad (indien beschikbaar) te targeten.

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