Navi és fülek

Dokumentáció és példák a Bootstrap mellékelt navigációs összetevőinek használatához.

Ezen az oldalon

Base nav

A Bootstrapban elérhető navigáció megosztja az általános jelöléseket és stílusokat, az alaposztálytól .navaz 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 .navflexbox-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 .navnem 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-currentattribútumot – pageaz aktuális oldal vagy truea 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" href="#" tabindex="-1" aria-disabled="true">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 .navfelhaszná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" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
</nav>

Elérhető stílusok

Módosítókkal és segédprogramokkal módosítsa az .navs 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-centerkö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" href="#" tabindex="-1" aria-disabled="true">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" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
  </li>
</ul>

Függőleges

Halmozza fel a navigációt a rugalmas elem irányának a .flex-columnsegé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" href="#" tabindex="-1" aria-disabled="true">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" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
</nav>

Tabs

Felülről veszi az alap navigációt, és hozzáadja az .nav-tabsosztá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" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
  </li>
</ul>

Tabletták

Vegyük ugyanazt a HTML-kódot, de használjuk .nav-pillshelyette:

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

Töltse ki és indokolja

Kényszerítse a .navtartalmá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-items-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" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
  </li>
</ul>

Ha egy <nav>-alapú navigációt használ, nyugodtan kihagyhatja .nav-item, mivel csak .nav-linka 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" href="#" tabindex="-1" aria-disabled="true">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-fillfentiekkel 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" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
  </li>
</ul>

Hasonlóan a -alapú navigációt .nav-fillhaszná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" href="#" tabindex="-1" aria-disabled="true">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" href="#" tabindex="-1" aria-disabled="true">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-tabsNe 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-currentattribú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" href="#" tabindex="-1" aria-disabled="true">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" href="#" tabindex="-1" aria-disabled="true">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.jsfá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 .navnavigá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.

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

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-tabsvagy 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 a'))
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 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 hatás

A lapok elhalványulásához adja hozzá .fademindegyikhez a .tab-pane. Az első lappanelnek is .showlá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-targetvagy – hivatkozás használata esetén – hrefattribú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 a')
  var firstTab = new bootstrap.Tab(firstTabEl)

  firstTab.show()
</script>

show

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.tabesemény bekövetkezte előtt).

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

  tab.show()

dispose

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

Events

Ú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 az hide.bs.tabeseménynél)
shown.bs.tab(az újonnan aktív, most megjelenő lapon ugyanaz, mint az show.bs.tabeseménynél)

Ha még nem volt aktív lap, akkor a hide.bs.tabés hidden.bs.tabesemé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
})