Navigace a karty
Dokumentace a příklady, jak používat navigační komponenty obsažené v Bootstrapu.
Základní nav
Navigace dostupná v Bootstrapu sdílí obecné označení a styly, od základní .nav
třídy až po aktivní a zakázaný stav. Zaměňte třídy modifikátorů pro přepínání mezi jednotlivými styly.
Základní .nav
komponenta je vyrobena z flexboxu a poskytuje pevný základ pro stavbu všech typů navigačních komponent. Zahrnuje některé přepisy stylů (pro práci se seznamy), výplň odkazů pro větší oblasti zásahu a základní zakázaný styl.
Základní .nav
komponenta neobsahuje žádný .active
stav. Následující příklady zahrnují třídu, hlavně proto, aby demonstrovaly, že tato konkrétní třída nespouští žádný speciální styl.
Chcete-li přenést aktivní stav na asistenční technologie, použijte aria-current
atribut — pomocí page
hodnoty pro aktuální stránku nebo true
pro aktuální položku v sadě.
<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>
Třídy se používají všude, takže vaše označení může být velmi flexibilní. Použijte <ul>
s jako výše, <ol>
pokud je důležité pořadí vašich položek, nebo si hoďte vlastní s <nav>
prvkem. Vzhledem k .nav
použití display: flex
se navigační odkazy chovají stejně jako položky navigace, ale bez zvláštního označení.
<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>
Dostupné styly
Změňte styl .nav
komponenty s pomocí modifikátorů a utilit. Mixujte a spojujte podle potřeby nebo si vytvořte vlastní.
Horizontální zarovnání
Změňte vodorovné zarovnání své navigace pomocí nástrojů flexbox . Ve výchozím nastavení jsou navigace zarovnány doleva, ale můžete je snadno změnit na zarovnané na střed nebo doprava.
Na střed s .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>
Zarovnáno vpravo s .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>
Vertikální
Uspořádejte svou navigaci změnou směru flexibilní položky pomocí .flex-column
nástroje. Potřebujete je naskládat do některých výřezů, ale do jiných ne? Použijte responzivní verze (např. .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>
Jako vždy je vertikální navigace možná i bez <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>
Karty
Převezme základní navigaci shora a přidá .nav-tabs
třídu pro vytvoření rozhraní s kartami. Použijte je k vytvoření tablovatelných regionů pomocí našeho pluginu tab JavaScript .
<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>
Pilulky
Vezměte stejný HTML, ale použijte .nav-pills
místo něj:
<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>
Vyplňte a zdůvodněte
Vynutíte, aby obsah vašeho souboru .nav
rozšířil celou dostupnou šířku jedné ze dvou tříd modifikátorů. Chcete-li úměrně vyplnit veškerý dostupný prostor vaším .nav-item
s, použijte .nav-fill
. Všimněte si, že veškerý horizontální prostor je obsazen, ale ne každá položka navigace má stejnou šířku.
<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>
Při použití <nav>
navigace založené na principu můžete vynechat .nav-item
, protože .nav-link
je vyžadováno pouze pro prvky stylů <a>
.
<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>
Pro prvky stejné šířky použijte .nav-justified
. Veškerý horizontální prostor bude obsazen navigačními odkazy, ale na rozdíl od .nav-fill
výše uvedeného bude mít každá navigační položka stejnou šířku.
<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>
Podobně jako v .nav-fill
příkladu s použitím <nav>
navigace založené na.
<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>
Práce s flex utilitami
Pokud potřebujete responzivní varianty navigace, zvažte použití řady nástrojů flexbox . I když jsou tyto nástroje podrobnější, nabízejí větší přizpůsobení napříč citlivými body přerušení. V níže uvedeném příkladu bude naše navigace naskládána na nejnižší bod přerušení a poté se přizpůsobí vodorovnému rozvržení, které vyplní dostupnou šířku počínaje malým bodem přerušení.
<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>
Ohledně přístupnosti
Pokud k poskytování navigačního panelu používáte navigace, nezapomeňte přidat a role="navigation"
do nejlogičtějšího nadřazeného kontejneru <ul>
, nebo obklopit <nav>
prvek kolem celé navigace. Nepřidávejte roli k <ul>
samotné roli, protože by to zabránilo tomu, aby byla asistenčními technologiemi oznámena jako skutečný seznam.
Všimněte si, že navigační panely, i když jsou vizuálně stylizované jako karty s .nav-tabs
třídou, by neměly být uvedeny role="tablist"
, role="tab"
nebo role="tabpanel"
atributy. Ty jsou vhodné pouze pro rozhraní s dynamickými kartami, jak je popsáno v WAI ARIA Authoring Practices . Příklad viz Chování JavaScriptu pro rozhraní s dynamickými kartami v této části. Atribut aria-current
není nutný na rozhraních s dynamickými kartami, protože náš JavaScript zpracovává vybraný stav přidáním aria-selected="true"
na aktivní kartu.
Pomocí rozbalovacích nabídek
Přidejte rozevírací nabídky s trochou kódu HTML navíc a rozbalovacím pluginem JavaScript .
Karty s rozevíracími seznamy
<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>
Pilulky s rozevíracími seznamy
<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
Proměnné
$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;
Chování JavaScriptu
Použijte zásuvný modul JavaScript tab – zahrňte jej jednotlivě nebo prostřednictvím zkompilovaného bootstrap.js
souboru – k rozšíření našich navigačních karet a pilulek tak, aby vytvořily tabelovatelné panely místního obsahu.
Dynamická rozhraní s kartami, jak je popsáno v WAI ARIA Authoring Practices , vyžadují role="tablist"
, role="tab"
, role="tabpanel"
, a další aria-
atributy, aby bylo možné zprostředkovat jejich strukturu, funkčnost a aktuální stav uživatelům asistenčních technologií (jako jsou čtečky obrazovky). Jako osvědčený postup doporučujeme používat <button>
prvky pro karty, protože se jedná o ovládací prvky, které spouštějí dynamickou změnu, spíše než odkazy, které přecházejí na novou stránku nebo umístění.
Pamatujte, že dynamická rozhraní s kartami by neměla obsahovat rozevírací nabídky, protože to způsobuje problémy s použitelností i přístupností. Z hlediska použitelnosti může způsobit zmatek skutečnost, že spouštěcí prvek aktuálně zobrazené karty není okamžitě viditelný (jelikož je uvnitř zavřené rozevírací nabídky). Z hlediska přístupnosti v současnosti neexistuje rozumný způsob, jak tento druh konstrukce namapovat na standardní vzor WAI ARIA, což znamená, že nemůže být snadno srozumitelný pro uživatele asistenčních technologií.
Toto je nějaký zástupný obsah související s kartou Domů. Kliknutím na jinou kartu přepnete viditelnost této karty pro další. Karta JavaScript zaměňuje třídy pro ovládání viditelnosti obsahu a stylů. Můžete jej použít s kartami, pilulkami a jakoukoli jinou .nav
navigací.
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>
Aby to vyhovovalo vašim potřebám, funguje to se <ul>
značkami založenými na principu, jak je uvedeno výše, nebo s libovolným označením „nahodit vlastní“. Všimněte si, že pokud používáte <nav>
, neměli byste role="tablist"
k němu přidávat přímo, protože by to přepsalo nativní roli prvku jako orientační bod navigace. Místo toho přepněte na alternativní prvek (v níže uvedeném příkladu jednoduchý <div>
) a obtočte <nav>
jej.
<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>
Plugin tabs funguje i s pilulkami.
Toto je nějaký zástupný obsah související s kartou Domů. Kliknutím na jinou kartu přepnete viditelnost této karty pro další. Karta JavaScript zaměňuje třídy pro ovládání viditelnosti obsahu a stylů. Můžete jej použít s kartami, pilulkami a jakoukoli jinou .nav
navigací.
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>
A s vertikálními pilulkami.
Toto je nějaký zástupný obsah související s kartou Domů. Kliknutím na jinou kartu přepnete viditelnost této karty pro další. Karta JavaScript zaměňuje třídy pro ovládání viditelnosti obsahu a stylů. Můžete jej použít s kartami, pilulkami a jakoukoli jinou .nav
navigací.
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>
Použití atributů dat
Můžete aktivovat navigaci na kartě nebo pilulce bez psaní jakéhokoli JavaScriptu pouhým zadáním data-bs-toggle="tab"
nebo data-bs-toggle="pill"
na prvku. Použijte tyto atributy dat na .nav-tabs
nebo .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>
Prostřednictvím JavaScriptu
Povolit záložky pomocí JavaScriptu (každá karta musí být aktivována samostatně):
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()
})
})
Jednotlivé karty můžete aktivovat několika způsoby:
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
Efekt vyblednutí
Chcete-li, aby karty vybledly, přidejte .fade
ke každému .tab-pane
. První panel karet musí také .show
zviditelnit počáteční obsah.
<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>
Metody
Asynchronní metody a přechody
Všechny metody API jsou asynchronní a zahajují přechod . Vrátí se k volajícímu, jakmile je přechod zahájen, ale před jeho ukončením . Kromě toho bude ignorováno volání metody na přechodové komponentě .
Další informace naleznete v naší dokumentaci k JavaScriptu .
constructor
Aktivuje prvek karty a kontejner obsahu. Karta by měla mít buď atribut, data-bs-target
nebo v případě použití odkazu href
atribut, který cílí na uzel kontejneru v modelu 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
Vybere danou kartu a zobrazí související panel. Jakákoli jiná karta, která byla dříve vybrána, se stane nevybranou a její přidružené podokno se skryje. Vrátí se k volajícímu dříve, než se panel karet skutečně zobrazí (tj. než dojde k shown.bs.tab
události).
var someTabTriggerEl = document.querySelector('#someTabTrigger')
var tab = new bootstrap.Tab(someTabTriggerEl)
tab.show()
dispose
Zničí záložku prvku.
getInstance
Statická metoda, která vám umožní získat instanci karty přidruženou k prvku DOM
var triggerEl = document.querySelector('#trigger')
var tab = bootstrap.Tab.getInstance(triggerEl) // Returns a Bootstrap tab instance
getOrCreateInstance
Statická metoda, která vám umožní získat instanci karty přidruženou k prvku DOM nebo vytvořit novou v případě, že nebyla inicializována
var triggerEl = document.querySelector('#trigger')
var tab = bootstrap.Tab.getOrCreateInstance(triggerEl) // Returns a Bootstrap tab instance
Events
Při zobrazení nové karty se události spustí v následujícím pořadí:
hide.bs.tab
(na aktuální aktivní kartě)show.bs.tab
(na kartě k zobrazení)hidden.bs.tab
(na předchozí aktivní záložce, stejné jako uhide.bs.tab
události)shown.bs.tab
(na nově aktivní právě zobrazené záložce, stejné jako ushow.bs.tab
události)
Pokud již žádná karta nebyla aktivní, události hide.bs.tab
a hidden.bs.tab
se nespustí.
Typ události | Popis |
---|---|
show.bs.tab |
Tato událost se spustí při zobrazení karty, ale předtím, než se zobrazí nová karta. Pomocí event.target a event.relatedTarget můžete cílit na aktivní kartu a na předchozí aktivní kartu (pokud je k dispozici). |
shown.bs.tab |
Tato událost se spustí při zobrazení karty po zobrazení karty. Pomocí event.target a event.relatedTarget můžete cílit na aktivní kartu a na předchozí aktivní kartu (pokud je k dispozici). |
hide.bs.tab |
Tato událost se spustí, když se má zobrazit nová karta (a tedy předchozí aktivní karta má být skryta). Pomocí event.target a event.relatedTarget můžete cílit na aktuální aktivní kartu a na novou kartu, která bude brzy aktivní. |
hidden.bs.tab |
Tato událost se spustí po zobrazení nové karty (a tedy předchozí aktivní karta je skryta). Pomocí event.target a event.relatedTarget můžete cílit na předchozí aktivní kartu a na novou aktivní kartu. |
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
})