Ga naar hoofdinhoud Ga naar navigatie in documenten
in English

Navigatie en tabbladen

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

Base nav

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.

<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" href="#" tabindex="-1" aria-disabled="true">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.

<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" href="#" tabindex="-1" aria-disabled="true">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:

<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" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
  </li>
</ul>

Rechts uitgelijnd met .justify-content-end:

<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" href="#" tabindex="-1" aria-disabled="true">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).

<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" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
  </li>
</ul>

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

<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" href="#" tabindex="-1" aria-disabled="true">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 .

<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" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
  </li>
</ul>

Pillen

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

<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" href="#" tabindex="-1" aria-disabled="true">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.

<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" href="#" tabindex="-1" aria-disabled="true">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.

<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" href="#" tabindex="-1" aria-disabled="true">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.

<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" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
  </li>
</ul>

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

<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" href="#" tabindex="-1" aria-disabled="true">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.

<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" href="#" tabindex="-1" aria-disabled="true">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 de WAI ARIA Authoring Practices . 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

<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" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
  </li>
</ul>

Pillen met vervolgkeuzelijsten

<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" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
  </li>
</ul>

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:                    $link-color;
$nav-link-hover-color:              $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.

Dynamische interfaces met tabbladen, zoals beschreven in de WAI ARIA Authoring Practices , vereisen 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.

Houd er rekening mee dat dynamische interfaces met tabbladen geen vervolgkeuzemenu's mogen bevatten, omdat dit zowel bruikbaarheids- als toegankelijkheidsproblemen veroorzaakt. 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.

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.

<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="contact-tab" data-bs-toggle="tab" data-bs-target="#contact" type="button" role="tab" aria-controls="contact" aria-selected="false">Contact</button>
  </li>
</ul>
<div class="tab-content" id="myTabContent">
  <div class="tab-pane fade show active" id="home" role="tabpanel" aria-labelledby="home-tab">...</div>
  <div class="tab-pane fade" id="profile" role="tabpanel" aria-labelledby="profile-tab">...</div>
  <div class="tab-pane fade" id="contact" role="tabpanel" aria-labelledby="contact-tab">...</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.

<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>
  </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">...</div>
  <div class="tab-pane fade" id="nav-profile" role="tabpanel" aria-labelledby="nav-profile-tab">...</div>
  <div class="tab-pane fade" id="nav-contact" role="tabpanel" aria-labelledby="nav-contact-tab">...</div>
</div>

De plug-in voor tabbladen werkt ook met pillen.

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.

<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>
</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">...</div>
  <div class="tab-pane fade" id="pills-profile" role="tabpanel" aria-labelledby="pills-profile-tab">...</div>
  <div class="tab-pane fade" id="pills-contact" role="tabpanel" aria-labelledby="pills-contact-tab">...</div>
</div>

En met verticale pillen.

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 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-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">...</div>
    <div class="tab-pane fade" id="v-pills-profile" role="tabpanel" aria-labelledby="v-pills-profile-tab">...</div>
    <div class="tab-pane fade" id="v-pills-messages" role="tabpanel" aria-labelledby="v-pills-messages-tab">...</div>
    <div class="tab-pane fade" id="v-pills-settings" role="tabpanel" aria-labelledby="v-pills-settings-tab">...</div>
  </div>
</div>

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">...</div>
  <div class="tab-pane" id="profile" role="tabpanel" aria-labelledby="profile-tab">...</div>
  <div class="tab-pane" id="messages" role="tabpanel" aria-labelledby="messages-tab">...</div>
  <div class="tab-pane" id="settings" role="tabpanel" aria-labelledby="settings-tab">...</div>
</div>

Via JavaScript

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

var triggerTabList = [].slice.call(document.querySelectorAll('#myTab a'))
triggerTabList.forEach(function (triggerEl) {
  var tabTrigger = new bootstrap.Tab(triggerEl)

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

U kunt afzonderlijke tabbladen op verschillende manieren activeren:

var triggerEl = document.querySelector('#myTab a[href="#profile"]')
bootstrap.Tab.getInstance(triggerEl).show() // Select tab by name

var triggerFirstTabEl = document.querySelector('#myTab li:first-child a')
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">...</div>
  <div class="tab-pane fade" id="profile" role="tabpanel" aria-labelledby="profile-tab">...</div>
  <div class="tab-pane fade" id="messages" role="tabpanel" aria-labelledby="messages-tab">...</div>
  <div class="tab-pane fade" id="settings" role="tabpanel" aria-labelledby="settings-tab">...</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 .

constructor

Activeert een tabelement en inhoudcontainer. Tab moet een data-bs-targetof, bij gebruik van een link, een hrefattribuut hebben, gericht op een containerknooppunt in de DOM.

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

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

<script>
  var firstTabEl = document.querySelector('#myTab li:last-child a')
  var firstTab = new bootstrap.Tab(firstTabEl)

  firstTab.show()
</script>

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.tabgebeurtenis plaatsvindt).

  var someTabTriggerEl = document.querySelector('#someTabTrigger')
  var tab = new bootstrap.Tab(someTabTriggerEl)

  tab.show()

dispose

Vernietigt het tabblad van een element.

getInstance

Statische methode waarmee u de tab-instantie kunt koppelen aan een DOM-element

var triggerEl = document.querySelector('#trigger')
var tab = bootstrap.Tab.getInstance(triggerEl) // Returns a Bootstrap tab instance

getOrCreateInstance

Statische methode waarmee u de tab-instantie kunt koppelen aan een DOM-element, of een nieuwe kunt maken voor het geval deze niet is geïnitialiseerd

var triggerEl = document.querySelector('#trigger')
var tab = bootstrap.Tab.getOrCreateInstance(triggerEl) // Returns a Bootstrap tab instance

Events

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

  1. hide.bs.tab(op het huidige actieve tabblad)
  2. show.bs.tab(op het te tonen tabblad)
  3. hidden.bs.tab(op het vorige actieve tabblad, hetzelfde als voor het hide.bs.tabevenement)
  4. 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
show.bs.tab Deze gebeurtenis wordt geactiveerd bij tabshow, maar voordat het nieuwe tabblad is weergegeven. Gebruik event.targeten event.relatedTargetom 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.targeten event.relatedTargetom respectievelijk het actieve tabblad en het vorige actieve tabblad (indien beschikbaar) te targeten.
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.targeten om respectievelijk event.relatedTargethet 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.targeten event.relatedTargetom respectievelijk het vorige actieve tabblad en het nieuwe actieve tabblad te targeten.
var tabEl = document.querySelector('button[data-bs-toggle="tab"]')
tabEl.addEventListener('shown.bs.tab', function (event) {
  event.target // newly activated tab
  event.relatedTarget // previous active tab
})