Navi és fülek
Dokumentáció és példák a Bootstrap mellékelt navigációs összetevőinek használatához.
Base nav
A Bootstrapban elérhető navigáció megosztja az általános jelöléseket és stílusokat, az alaposztálytól .nav
az aktív és letiltott állapotig. Cserélje fel a módosító osztályokat az egyes stílusok közötti váltáshoz.
Az alapelem .nav
flexbox-szal készült, és erős alapot biztosít minden típusú navigációs alkatrész felépítéséhez. Tartalmaz néhány stílusfelülírást (a listákkal való munkához), néhány hivatkozáskitöltést a nagyobb találati területekhez, és az alapvető letiltott stílust.
Az alapkomponens .nav
nem tartalmaz semmilyen .active
állapotot. A következő példák az osztályt tartalmazzák, főleg annak bemutatására, hogy ez az osztály nem vált ki semmilyen különleges stílust.
Az aktív állapot kisegítő technológiák számára történő továbbításához használja az aria-current
attribútumot – page
az aktuális oldal vagy true
a készlet aktuális elemének értékét használva.
<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>
Az osztályokat mindenhol használják, így a jelölés rendkívül rugalmas lehet. Használja <ul>
a fentiekhez hasonlókat, <ol>
ha fontos a tételek sorrendje, vagy dobja a sajátját egy <nav>
elemmel. Mivel a .nav
felhasználások display: flex
, a navigációs hivatkozások ugyanúgy viselkednek, mint a navigációs elemek, de extra jelölés nélkül.
<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>
Elérhető stílusok
Módosítókkal és segédprogramokkal módosítsa az .nav
s komponens stílusát. Szükség szerint keverje össze, vagy készítse el a sajátját.
Vízszintes igazítás
Módosítsa a navigációs készülék vízszintes beállítását a flexbox segédprogramokkal . Alapértelmezés szerint a navigációs helyek balra vannak igazítva, de egyszerűen módosíthatja őket középre vagy jobbra igazítva.
Középre a .justify-content-center
következővel:
<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>
Jobbra igazítva ezzel .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>
Függőleges
Halmozza fel a navigációt a rugalmas elem irányának a .flex-column
segédprogrammal történő megváltoztatásával. Egyes nézetablakban kell őket egymásra helyezni, másokon nem? Használja a reszponzív verziókat (pl. .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>
Mint mindig, a függőleges navigáció <ul>
s nélkül is lehetséges.
<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>
Tabs
Felülről veszi az alap navigációt, és hozzáadja az .nav-tabs
osztályt egy füles felület létrehozásához. Használja őket lapozható régiók létrehozására a lap JavaScript beépülő moduljával .
<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>
Tabletták
Vegyük ugyanazt a HTML-kódot, de használjuk .nav-pills
helyette:
<ul class="nav nav-pills">
<li class="nav-item">
<a class="nav-link active" aria-current="page" href="#">Active</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Link</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled">Disabled</a>
</li>
</ul>
Töltse ki és indokolja
Kényszerítse a .nav
tartalmát, hogy kiterjesztse a teljes elérhető szélességet a két módosító osztály egyike. Ha az összes rendelkezésre álló helyet arányosan szeretné kitölteni az .nav-item
s-ekkel, használja a gombot .nav-fill
. Figyelje meg, hogy az összes vízszintes terület foglalt, de nem minden navigációs elem azonos szélességű.
<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>
Ha egy <nav>
-alapú navigációt használ, nyugodtan kihagyhatja .nav-item
, mivel csak .nav-link
a stíluselemekhez szükséges <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>
Az egyenlő szélességű elemekhez használja a .nav-justified
. A teljes vízszintes helyet a navigációs hivatkozások foglalják el, de a .nav-fill
fentiekkel ellentétben minden navigációs elem azonos szélességű lesz.
<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>
Hasonlóan a -alapú navigációt .nav-fill
használó példához .<nav>
<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>
Rugalmas segédprogramokkal való munka
Ha reszponzív navigációs változatokra van szüksége, fontolja meg egy sor flexbox segédprogram használatát . Noha ezek a segédprogramok bőbeszédűbbek, nagyobb testreszabást kínálnak az érzékeny töréspontok között. Az alábbi példában a navigátorunk a legalacsonyabb töréspontra kerül, majd alkalmazkodik egy vízszintes elrendezéshez, amely kitölti a rendelkezésre álló szélességet a kis törésponttól kezdve.
<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>
Az elérhetőséggel kapcsolatban
Ha navigációs sávot használ navigációs sáv létrehozásához, ügyeljen arra, role="navigation"
hogy a leglogikusabb szülőtárolóhoz adjon hozzá egy elemet <ul>
, vagy körbevesz egy <nav>
elemet a teljes navigáció köré. Ne adja hozzá a szerepet <ul>
magához, mert ezzel megakadályozhatja, hogy a kisegítő technológiák tényleges listának jelentsék.
.nav-tabs
Ne feledje, hogy a navigációs sávok, még akkor sem, ha vizuálisan az osztályhoz tartozó lapokként vannak kialakítva , nem tartalmazhatnak role="tablist"
, role="tab"
vagy role="tabpanel"
attribútumokat. Ezek csak a dinamikus füles interfészek esetében megfelelőek, amint azt a WAI ARIA Authoring Practices című dokumentumban leírtuk . Példaként tekintse meg a JavaScript viselkedését dinamikus füles felületekhez ebben a szakaszban. Az aria-current
attribútum nem szükséges dinamikus füles felületeken, mivel a JavaScriptünk úgy kezeli a kiválasztott állapotot, hogy hozzáadja aria-selected="true"
az aktív laphoz.
Legördülő menük használata
Adjon hozzá legördülő menüket egy kis extra HTML-lel és a legördülő JavaScript beépülő modullal .
Lapok legördülő menükkel
<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>
Tabletták legördülő menükkel
<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
Változók
$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 viselkedés
Használja a lap JavaScript beépülő modulját – külön-külön vagy a lefordított bootstrap.js
fájlon keresztül is elhelyezheti – navigációs lapjaink és tablettáink kiterjesztéséhez helyi tartalom lapozható ablaktábláinak létrehozásához.
A WAI ARIA Authoring Practices című dokumentumban leírt dinamikus füles interfészek , role="tablist"
, role="tab"
és role="tabpanel"
további attribútumokat igényelnek aria-
annak érdekében, hogy szerkezetüket, funkcionalitásukat és jelenlegi állapotukat közvetítsék a kisegítő technológiák (például képernyőolvasók) felhasználói számára. Bevált gyakorlatként azt javasoljuk, hogy <button>
elemeket használjon a lapokhoz, mivel ezek dinamikus változást indító vezérlők, nem pedig új oldalra vagy helyre navigáló hivatkozások.
Vegye figyelembe, hogy a dinamikus füles felületek nem tartalmazhatnak legördülő menüket, mivel ez mind a használhatóság, mind a kisegítő lehetőségek problémáit okozza. A használhatóság szempontjából az a tény, hogy az aktuálisan megjelenített lap triggereleme nem látható azonnal (mivel a zárt legördülő menüben van), zavart okozhat. Hozzáférhetőségi szempontból jelenleg nincs ésszerű módja ennek a fajta konstrukciónak egy szabványos WAI ARIA mintára való leképezésének, ami azt jelenti, hogy nem lehet könnyen érthetővé tenni a kisegítő technológiák felhasználói számára.
Ez néhány helyőrző tartalom, amely a Kezdőlap laphoz kapcsolódik. Egy másik fülre kattintva átkapcsolja ennek a lapnak a láthatóságát a következőre. A JavaScript lap osztályokat cserél a tartalom láthatóságának és stílusának szabályozása érdekében. Használhatja lapokkal, tablettákkal és bármilyen más .nav
navigációval.
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>
Az Ön igényeinek kielégítése érdekében ez a <ul>
fent bemutatott módon -alapú jelöléssel vagy bármilyen tetszőleges „saját” jelöléssel működik. Vegye figyelembe, hogy ha a t használja <nav>
, ne role="tablist"
közvetlenül adjon hozzá, mivel ez felülírná az elem natív szerepét a navigációs iránypontként. Ehelyett váltson egy alternatív elemre (az alábbi példában egy egyszerű <div>
), és tekerje <nav>
köré.
<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>
A tabs plugin tablettákkal is működik.
Ez néhány helyőrző tartalom, amely a Kezdőlap laphoz kapcsolódik. Egy másik fülre kattintva átkapcsolja ennek a lapnak a láthatóságát a következőre. A JavaScript lap osztályokat cserél a tartalom láthatóságának és stílusának szabályozása érdekében. Használhatja lapokkal, tablettákkal és bármilyen más .nav
navigációval.
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>
És függőleges tablettákkal.
Ez néhány helyőrző tartalom, amely a Kezdőlap laphoz kapcsolódik. Egy másik fülre kattintva átkapcsolja ennek a lapnak a láthatóságát a következőre. A JavaScript lap osztályokat cserél a tartalom láthatóságának és stílusának szabályozása érdekében. Használhatja lapokkal, tablettákkal és bármilyen más .nav
navigációval.
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>
Adatattribútumok használata
Aktiválhat egy fület vagy tabletta navigációt anélkül, hogy JavaScriptet írna, egyszerűen megadva data-bs-toggle="tab"
vagy data-bs-toggle="pill"
egy elemen. Használja ezeket az adatattribútumokat a .nav-tabs
vagy oldalon .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>
JavaScripten keresztül
Lapozható lapok engedélyezése JavaScript segítségével (minden lapot külön kell aktiválni):
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()
})
})
Az egyes lapokat többféleképpen is aktiválhatja:
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 hatás
A lapok elhalványulásához adja hozzá .fade
mindegyikhez a .tab-pane
. Az első lappanelnek is .show
láthatóvá kell tennie a kezdeti tartalmat.
<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>
Mód
Aszinkron módszerek és átmenetek
Minden API metódus aszinkron , és átmenetet indít . Visszatérnek a hívóhoz, amint az átmenet elkezdődik, de még azelőtt, hogy az véget érne . Ezenkívül a rendszer figyelmen kívül hagyja az átmeneti komponens metódushívásait .
További információért tekintse meg JavaScript dokumentációnkat .
constructor
Aktivál egy tabulátor elemet és tartalomtárolót. A lapnak rendelkeznie kell egy data-bs-target
vagy – hivatkozás használata esetén – href
attribútummal, amely egy tárolócsomópontot céloz meg a DOM-ban.
<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>
előadás
Kijelöli az adott lapot, és megjeleníti a hozzá tartozó panelt. Minden más korábban kiválasztott lap kijelölése megszűnik, és a hozzájuk tartozó panel elrejtődik. Visszatér a hívóhoz, mielőtt a lappanel ténylegesen megjelenne (azaz az shown.bs.tab
esemény bekövetkezte előtt).
var someTabTriggerEl = document.querySelector('#someTabTrigger')
var tab = new bootstrap.Tab(someTabTriggerEl)
tab.show()
eldob
Megsemmisíti egy elem lapját.
getInstance
Statikus módszer, amely lehetővé teszi a DOM-elemhez társított lappéldány lekérését
var triggerEl = document.querySelector('#trigger')
var tab = bootstrap.Tab.getInstance(triggerEl) // Returns a Bootstrap tab instance
getOrCreateInstance
Statikus módszer, amely lehetővé teszi a tabulátorpéldány DOM-elemhez társítását, vagy új létrehozását, ha nem inicializálták
var triggerEl = document.querySelector('#trigger')
var tab = bootstrap.Tab.getOrCreateInstance(triggerEl) // Returns a Bootstrap tab instance
Események
Új lap megjelenítésekor az események a következő sorrendben aktiválódnak:
hide.bs.tab
(az aktuális aktív lapon)show.bs.tab
(a megjelenítendő lapon)hidden.bs.tab
(az előző aktív lapon ugyanaz, mint azhide.bs.tab
eseménynél)shown.bs.tab
(az újonnan aktív, most megjelenő lapon ugyanaz, mint azshow.bs.tab
eseménynél)
Ha még nem volt aktív lap, akkor a hide.bs.tab
és hidden.bs.tab
események nem aktiválódnak.
Esemény típus | Leírás |
---|---|
show.bs.tab |
Ez az esemény a lap megjelenítésekor aktiválódik, de az új lap megjelenítése előtt. Használja a event.target és event.relatedTarget az aktív lapot, illetve az előző aktív lapot (ha elérhető) célozza meg. |
shown.bs.tab |
Ez az esemény lapmegjelenítéskor aktiválódik, miután egy lap megjelenik. Használja a event.target és event.relatedTarget az aktív lapot, illetve az előző aktív lapot (ha elérhető) célozza meg. |
hide.bs.tab |
Ez az esemény akkor aktiválódik, amikor új lapot kell megjeleníteni (és így az előző aktív lapot el kell rejteni). Használja a event.target és event.relatedTarget az aktuális aktív lapot, illetve a hamarosan aktívvá váló új lapot. |
hidden.bs.tab |
Ez az esemény egy új lap megjelenítése után aktiválódik (és így az előző aktív lap el van rejtve). Használja a event.target és event.relatedTarget az előző aktív lapot, illetve az új aktív lapot. |
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
})