Navigatie en tabbladen
Documentatie en voorbeelden voor het gebruik van de meegeleverde navigatiecomponenten van Bootstrap.
Basisnavigatiesysteem
Navigatie beschikbaar in Bootstrap deelt algemene markeringen en stijlen, van de basisklasse .nav
tot de actieve en uitgeschakelde statussen. Wissel modificatieklassen om tussen elke stijl te schakelen.
De .nav
basiscomponent 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 .nav
basiscomponent bevat geen .active
staat. 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-current
attribuut — met de page
waarde voor de huidige pagina of true
voor 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">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 .nav
gebruik 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">Disabled</a>
</nav>
Beschikbare stijlen
Verander de stijl van .nav
s-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">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">Disabled</a>
</li>
</ul>
Verticaal
Stapel uw navigatie door de richting van het flexitem te wijzigen met het .flex-column
hulpprogramma. 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">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">Disabled</a>
</nav>
Tabbladen
Neemt de basisnavigatie van boven en voegt de .nav-tabs
klasse 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">Disabled</a>
</li>
</ul>
Pillen
Neem dezelfde HTML, maar gebruik .nav-pills
in 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">Disabled</a>
</li>
</ul>
Invullen en uitvullen
Forceer .nav
de 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-item
s, 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">Disabled</a>
</li>
</ul>
Wanneer u een <nav>
navigatie op basis gebruikt, kunt u deze veilig weglaten .nav-item
, aangezien dit alleen .nav-link
nodig 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">Disabled</a>
</nav>
Gebruik voor elementen van gelijke breedte .nav-justified
. Alle horizontale ruimte wordt ingenomen door navigatielinks, maar in tegenstelling tot het .nav-fill
bovenstaande 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">Disabled</a>
</li>
</ul>
Vergelijkbaar met het .nav-fill
voorbeeld 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">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">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-tabs
klasse, 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-current
attribuut 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">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">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.js
bestand 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 .nav
navigatie.
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 .nav
navigatie.
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 .nav
navigatie.
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-tabs
of .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 button'))
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 button[data-bs-target="#profile"]')
bootstrap.Tab.getInstance(triggerEl).show() // Select tab by name
var triggerFirstTabEl = document.querySelector('#myTab li:first-child button')
bootstrap.Tab.getInstance(triggerFirstTabEl).show() // Select first tab
Fade-effect
.fade
Voeg aan elk toe om tabbladen te laten infaden .tab-pane
. Het eerste tabblad moet ook .show
de 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 .
constructor
Activeert een tabelement en inhoudcontainer. Tab moet een data-bs-target
of, bij gebruik van een link, een href
attribuut 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 button')
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.tab
gebeurtenis plaatsvindt).
var someTabTriggerEl = document.querySelector('#someTabTrigger')
var tab = new bootstrap.Tab(someTabTriggerEl)
tab.show()
weggooien
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
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 hethide.bs.tab
evenement)shown.bs.tab
(op het nieuw actieve tabblad dat zojuist is weergegeven, dezelfde als voor deshow.bs.tab
gebeurtenis)
Als er al geen tabblad actief was, worden de gebeurtenissen hide.bs.tab
en hidden.bs.tab
niet geactiveerd.
Evenementtype | Beschrijving |
---|---|
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. |
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. |
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
})