Mga Nav at tab
Dokumentasyon at mga halimbawa para sa kung paano gamitin ang mga kasamang bahagi ng nabigasyon ng Bootstrap.
Base nav
Ang nabigasyon na available sa Bootstrap ay nagbabahagi ng pangkalahatang markup at mga istilo, mula sa batayang .nav
klase hanggang sa aktibo at may kapansanan na mga estado. Magpalit ng mga klase ng modifier upang lumipat sa pagitan ng bawat istilo.
Ang batayang .nav
bahagi ay binuo gamit ang flexbox at nagbibigay ng matibay na pundasyon para sa pagbuo ng lahat ng uri ng mga bahagi ng nabigasyon. Kabilang dito ang ilang pag-override sa istilo (para sa pagtatrabaho sa mga listahan), ilang link padding para sa mas malalaking lugar ng hit, at pangunahing naka-disable na estilo.
Ang batayang .nav
bahagi ay hindi kasama ang anumang .active
estado. Kasama sa mga sumusunod na halimbawa ang klase, pangunahin upang ipakita na ang partikular na klase na ito ay hindi nagti-trigger ng anumang espesyal na estilo.
Upang maihatid ang aktibong estado sa mga teknolohiyang pantulong, gamitin ang aria-current
katangian — gamit ang page
halaga para sa kasalukuyang pahina, o true
para sa kasalukuyang item sa isang 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>
Ginagamit ang mga klase sa kabuuan, kaya maaaring maging sobrang flexible ang iyong markup. Gumamit ng <ul>
s tulad ng nasa itaas, <ol>
kung ang pagkakasunud-sunod ng iyong mga item ay mahalaga, o i-roll ang iyong sarili gamit ang isang <nav>
elemento. Dahil ang mga .nav
gamit display: flex
, ang mga nav link ay kumikilos tulad ng nav item, ngunit walang dagdag na markup.
<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>
Magagamit na mga istilo
Baguhin ang istilo ng .nav
s component gamit ang mga modifier at utility. Paghaluin at pagtugmain kung kinakailangan, o bumuo ng iyong sarili.
Pahalang na pagkakahanay
Baguhin ang pahalang na pagkakahanay ng iyong nav gamit ang flexbox utilities . Bilang default, ang mga nav ay naka-left-align, ngunit madali mong mababago ang mga ito sa center o right aligned.
Nakasentro sa .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>
Naka-align sa kanan sa .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>
Patayo
I-stack ang iyong nabigasyon sa pamamagitan ng pagbabago ng direksyon ng flex item gamit ang .flex-column
utility. Kailangang i-stack ang mga ito sa ilang viewport ngunit hindi sa iba? Gamitin ang mga tumutugon na bersyon (hal., .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>
Gaya ng nakasanayan, ang vertical navigation ay posible nang walang <ul>
s, masyadong.
<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>
Mga tab
Kinukuha ang pangunahing nav mula sa itaas at idinaragdag ang .nav-tabs
klase upang makabuo ng naka-tab na interface. Gamitin ang mga ito upang lumikha ng mga tabbable na rehiyon gamit ang aming tab na JavaScript plugin .
<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>
Pills
Kunin ang parehong HTML, ngunit gamitin .nav-pills
sa halip ang:
<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>
Punan at bigyang-katwiran
Pilitin ang iyong .nav
mga nilalaman na palawigin ang buong magagamit na lapad ng isa sa dalawang klase ng modifier. Para proporsyonal na punan ang lahat ng magagamit na espasyo ng iyong .nav-item
s, gamitin ang .nav-fill
. Pansinin na ang lahat ng pahalang na espasyo ay inookupahan, ngunit hindi lahat ng nav item ay may parehong lapad.
<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>
Kapag gumagamit ng <nav>
nakabatay sa nabigasyon, maaari mong ligtas na alisin .nav-item
dahil kailangan lang para sa mga elemento .nav-link
ng pag-istilo .<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>
Para sa pantay na lapad na mga elemento, gamitin ang .nav-justified
. Ang lahat ng pahalang na espasyo ay sasakupin ng mga nav link, ngunit hindi tulad ng nasa .nav-fill
itaas, ang bawat nav item ay magiging parehong lapad.
<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>
Katulad ng .nav-fill
halimbawa gamit ang isang <nav>
-based navigation.
<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>
Paggawa gamit ang mga flex utility
Kung kailangan mo ng mga tumutugon na variation ng nav, isaalang-alang ang paggamit ng isang serye ng mga flexbox utilities . Bagama't mas verbose, nag-aalok ang mga utility na ito ng higit na pagpapasadya sa mga tumutugon na breakpoint. Sa halimbawa sa ibaba, ang aming nav ay isalansan sa pinakamababang breakpoint, pagkatapos ay iaangkop sa isang pahalang na layout na pumupuno sa magagamit na lapad simula sa maliit na breakpoint.
<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>
Tungkol sa accessibility
Kung gumagamit ka ng navs upang magbigay ng navigation bar, tiyaking magdagdag ng isang role="navigation"
sa pinakalohikal na parent container ng <ul>
, o maglagay ng <nav>
elemento sa buong nabigasyon. Huwag idagdag ang tungkulin sa <ul>
sarili nito, dahil mapipigilan ito na maipahayag bilang isang aktwal na listahan ng mga pantulong na teknolohiya.
Tandaan na ang mga navigation bar, kahit na biswal na naka-istilo bilang mga tab na may .nav-tabs
klase, ay hindi dapat ibigay role="tablist"
, role="tab"
o mga role="tabpanel"
katangian. Ang mga ito ay angkop lamang para sa mga dynamic na naka-tab na interface, tulad ng inilarawan sa WAI ARIA Authoring Practices . Tingnan ang pag-uugali ng JavaScript para sa mga dynamic na naka-tab na interface sa seksyong ito para sa isang halimbawa. Hindi kinakailangan ang aria-current
attribute sa mga dynamic na tabbed na interface dahil pinangangasiwaan ng aming JavaScript ang napiling estado sa pamamagitan ng pagdaragdag aria-selected="true"
sa aktibong tab.
Paggamit ng mga dropdown
Magdagdag ng mga dropdown na menu na may kaunting dagdag na HTML at ang dropdown na JavaScript plugin .
Mga tab na may mga dropdown
<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>
Mga tabletang may dropdown
<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
Mga variable
$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;
Pag-uugali ng JavaScript
Gamitin ang plugin ng tab na JavaScript—isama ito nang isa-isa o sa pamamagitan ng pinagsama bootstrap.js
-samang file—upang palawigin ang aming mga tab sa pag-navigate at mga tabletas upang lumikha ng mga tabable na pane ng lokal na nilalaman.
Ang mga dynamic na tabbed na interface, tulad ng inilarawan sa WAI ARIA Authoring Practices , ay nangangailangan ng role="tablist"
, role="tab"
, role="tabpanel"
, at mga karagdagang aria-
katangian upang maihatid ang kanilang istraktura, functionality at kasalukuyang estado sa mga user ng mga pantulong na teknolohiya (tulad ng mga screen reader). Bilang pinakamahusay na kasanayan, inirerekomenda namin ang paggamit <button>
ng mga elemento para sa mga tab, dahil ito ang mga kontrol na nagti-trigger ng dynamic na pagbabago, sa halip na mga link na nagna-navigate sa isang bagong page o lokasyon.
Tandaan na ang mga dynamic na naka-tab na interface ay hindi dapat maglaman ng mga dropdown na menu, dahil nagdudulot ito ng mga isyu sa kakayahang magamit at accessibility. Mula sa pananaw ng kakayahang magamit, ang katotohanan na ang kasalukuyang ipinapakitang elemento ng trigger ng tab ay hindi agad nakikita (dahil nasa loob ito ng saradong dropdown na menu) ay maaaring magdulot ng kalituhan. Mula sa punto ng view ng pagiging naa-access, kasalukuyang walang makatwirang paraan upang imapa ang ganitong uri ng konstruksyon sa isang karaniwang pattern ng WAI ARIA, ibig sabihin, hindi ito madaling maunawaan ng mga gumagamit ng mga pantulong na teknolohiya.
Ito ay ilang placeholder na nilalaman na nauugnay na nilalaman ng tab na Home. Ang pag-click sa isa pang tab ay magpapalipat-lipat sa visibility ng isang ito para sa susunod. Ang tab na JavaScript ay nagpapalit ng mga klase upang kontrolin ang pagpapakita ng nilalaman at pag-istilo. Magagamit mo ito sa mga tab, tableta, at anumang iba pang .nav
nabigasyon na pinapagana.
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>
Para tumulong na umangkop sa iyong mga pangangailangan, gumagana ito sa <ul>
-based na markup, tulad ng ipinapakita sa itaas, o sa anumang arbitrary na "i-roll ang iyong sariling" markup. Tandaan na kung gumagamit ka ng <nav>
, hindi ka dapat direktang magdagdag role="tablist"
dito, dahil ma-o-override nito ang katutubong tungkulin ng elemento bilang isang palatandaan ng nabigasyon. Sa halip, lumipat sa isang alternatibong elemento (sa halimbawa sa ibaba, isang simple <div>
) at balutin ang <nav>
paligid nito.
<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>
Gumagana rin ang tabs plugin sa mga tabletas.
Ito ay ilang placeholder na nilalaman na nauugnay na nilalaman ng tab na Home. Ang pag-click sa isa pang tab ay magpapalipat-lipat sa visibility ng isang ito para sa susunod. Ang tab na JavaScript ay nagpapalit ng mga klase upang kontrolin ang pagpapakita ng nilalaman at pag-istilo. Magagamit mo ito sa mga tab, tableta, at anumang iba pang .nav
nabigasyon na pinapagana.
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>
At may mga vertical na tabletas.
Ito ay ilang placeholder na nilalaman na nauugnay na nilalaman ng tab na Home. Ang pag-click sa isa pang tab ay magpapalipat-lipat sa visibility ng isang ito para sa susunod. Ang tab na JavaScript ay nagpapalit ng mga klase upang kontrolin ang pagpapakita ng nilalaman at pag-istilo. Magagamit mo ito sa mga tab, tableta, at anumang iba pang .nav
nabigasyon na pinapagana.
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>
Paggamit ng mga katangian ng data
Maaari mong i-activate ang isang tab o pill navigation nang hindi sumusulat ng anumang JavaScript sa pamamagitan lamang ng pagtukoy data-bs-toggle="tab"
o data-bs-toggle="pill"
sa isang elemento. Gamitin ang mga katangian ng data na ito sa .nav-tabs
o .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>
Sa pamamagitan ng JavaScript
Paganahin ang mga tab na tab sa pamamagitan ng JavaScript (kailangang isaaktibo ang bawat tab):
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()
})
})
Maaari mong i-activate ang mga indibidwal na tab sa maraming paraan:
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
Upang mag-fade in ang mga tab, idagdag .fade
sa bawat isa .tab-pane
. Ang unang tab pane ay dapat ding .show
gawin ang unang nilalaman na nakikita.
<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>
Paraan
Mga asynchronous na pamamaraan at paglipat
Ang lahat ng mga pamamaraan ng API ay asynchronous at nagsisimula ng isang paglipat . Bumalik sila sa tumatawag sa sandaling magsimula ang paglipat ngunit bago ito matapos . Bilang karagdagan, babalewalain ang isang method call sa isang transitioning component .
Tingnan ang aming dokumentasyon ng JavaScript para sa higit pang impormasyon .
constructor
Ina-activate ang isang elemento ng tab at lalagyan ng nilalaman. Ang tab ay dapat magkaroon ng alinman sa data-bs-target
o, kung gumagamit ng link, isang href
attribute, na nagta-target ng container node sa 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>
palabas
Pinipili ang ibinigay na tab at ipinapakita ang nauugnay na pane nito. Ang anumang iba pang tab na dati nang napili ay hindi mapipili at ang nauugnay na pane nito ay nakatago. Bumabalik sa tumatawag bago aktwal na naipakita ang tab pane (ibig sabihin bago shown.bs.tab
mangyari ang kaganapan).
var someTabTriggerEl = document.querySelector('#someTabTrigger')
var tab = new bootstrap.Tab(someTabTriggerEl)
tab.show()
itapon
Sinisira ang tab ng isang elemento.
getInstance
Static na paraan na nagbibigay-daan sa iyong makuha ang instance ng tab na nauugnay sa isang elemento ng DOM
var triggerEl = document.querySelector('#trigger')
var tab = bootstrap.Tab.getInstance(triggerEl) // Returns a Bootstrap tab instance
getOrCreateInstance
Static na paraan na nagbibigay-daan sa iyong makuha ang instance ng tab na nauugnay sa isang elemento ng DOM, o lumikha ng bago kung sakaling hindi ito nasimulan
var triggerEl = document.querySelector('#trigger')
var tab = bootstrap.Tab.getOrCreateInstance(triggerEl) // Returns a Bootstrap tab instance
Mga kaganapan
Kapag nagpapakita ng bagong tab, gagana ang mga kaganapan sa sumusunod na pagkakasunud-sunod:
hide.bs.tab
(sa kasalukuyang aktibong tab)show.bs.tab
(sa ipapakitang tab)hidden.bs.tab
(sa nakaraang aktibong tab, kapareho ng para sahide.bs.tab
kaganapan)shown.bs.tab
(sa bagong-aktibong kakapakitang tab, kapareho ng para sashow.bs.tab
kaganapan)
Kung wala pang tab na aktibo, hindi papaganahin ang hide.bs.tab
at mga hidden.bs.tab
kaganapan.
Uri ng kaganapan | Paglalarawan |
---|---|
show.bs.tab |
Ang kaganapang ito ay gagana sa palabas sa tab, ngunit bago ipakita ang bagong tab. Gamitin event.target at event.relatedTarget i-target ang aktibong tab at ang nakaraang aktibong tab (kung magagamit) ayon sa pagkakabanggit. |
shown.bs.tab |
Ang kaganapang ito ay gagana sa palabas sa tab pagkatapos maipakita ang isang tab. Gamitin event.target at event.relatedTarget i-target ang aktibong tab at ang nakaraang aktibong tab (kung magagamit) ayon sa pagkakabanggit. |
hide.bs.tab |
Ang kaganapang ito ay gagana kapag ang isang bagong tab ay ipapakita (at sa gayon ang nakaraang aktibong tab ay itatago). Gamitin event.target at event.relatedTarget i-target ang kasalukuyang aktibong tab at ang bagong tab na malapit nang maging aktibo, ayon sa pagkakabanggit. |
hidden.bs.tab |
Ang kaganapang ito ay gagana pagkatapos ipakita ang isang bagong tab (at sa gayon ang nakaraang aktibong tab ay nakatago). Gamitin event.target at event.relatedTarget i-target ang nakaraang aktibong tab at ang bagong aktibong tab, ayon sa pagkakabanggit. |
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
})