Navs و Tab
مستندات و مثالهایی برای نحوه استفاده از اجزای ناوبری شامل Bootstrap.
ناوبری پایه
ناوبری موجود در Bootstrap به اشتراک گذاری نشانه گذاری و سبک های عمومی، از .nav
کلاس پایه تا حالت های فعال و غیر فعال. برای جابجایی بین هر سبک، کلاسهای اصلاحکننده را تعویض کنید.
کامپوننت پایه .nav
با فلکس باکس ساخته شده است و پایه ای قوی برای ساخت انواع اجزای ناوبری فراهم می کند. این شامل برخی نادیده گرفتن سبک (برای کار با لیست ها)، برخی از لایه های پیوند برای مناطق بزرگتر، و یک ظاهر طراحی غیرفعال اولیه است.
جزء پایه .nav
هیچ .active
حالتی را شامل نمی شود. مثالهای زیر شامل کلاس میشود، عمدتاً برای نشان دادن این که این کلاس خاص هیچ استایل خاصی را ایجاد نمیکند.
برای انتقال وضعیت فعال به فناوریهای کمکی، از aria-current
و��ژگی استفاده کنید - با استفاده از page
مقدار برای صفحه فعلی یا true
برای آیتم فعلی در یک مجموعه.
<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>
کلاس ها در سراسر جهان استفاده می شوند، بنابراین نشانه گذاری شما می تواند بسیار انعطاف پذیر باشد. اگر ترتیب اقلام شما مهم است از <ul>
s مانند بالا استفاده کنید یا خودتان را با یک عنصر <ol>
رول کنید . <nav>
از آنجا که .nav
استفاده میکند display: flex
، پیوندهای ناوبری مانند موارد ناوبری عمل میکنند، اما بدون نشانهگذاری اضافی.
<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>
سبک های موجود
سبک .nav
کامپوننت s را با اصلاح کننده ها و ابزارهای کمکی تغییر دهید. در صورت نیاز مخلوط و مطابقت دهید، یا خودتان بسازید.
تراز افقی
تراز افقی ناوبری خود را با ابزارهای flexbox تغییر دهید . به طور پیشفرض، ناوبریها تراز چپ هستند، اما میتوانید به راحتی آنها را به تراز وسط یا راست تغییر دهید.
با محوریت .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>
تراز راست با .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>
عمودی
ناوبری خود را با تغییر جهت مورد انعطاف پذیر با .flex-column
ابزار کمکی جمع کنید. آیا باید آنها را در برخی از درگاههای نمایش انباشته کنید اما در برخی دیگر نه؟ از نسخه های ریسپانسیو (به عنوان مثال، .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>
مثل همیشه، ناوبری عمودی بدون <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>
زبانه ها
ناو اصلی را از بالا می گیرد و .nav-tabs
کلاس را برای ایجاد یک رابط تب دار اضافه می کند. از آنها برای ایجاد مناطق Tabbable با افزونه جاوا اسکریپت تب ما استفاده کنید .
<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>
قرص
همان HTML را بگیرید، اما .nav-pills
به جای آن از:
<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>
پر کنید و توجیه کنید
محتویات خود .nav
را مجبور کنید که عرض کامل یکی از دو کلاس اصلاح کننده را گسترش دهند. برای پر کردن متناسب تمام فضای موجود با .nav-item
s خود، استفاده کنید .nav-fill
. توجه داشته باشید که تمام فضای افقی اشغال شده است، اما هر آیتم nav دارای عرض یکسان نیست.
<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>
هنگام استفاده از <nav>
ناوبری مبتنی بر، میتوانید با خیال راحت آن را حذف کنید .nav-item
زیرا فقط برای عناصر .nav-link
استایل مورد نیاز است.<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>
برای عناصر با عرض مساوی، از .nav-justified
. تمام فضای افقی توسط پیوندهای ناوبری اشغال می شود، اما برخلاف موارد .nav-fill
فوق، هر آیتم ناوبری یک عرض خواهد داشت.
<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>
مشابه .nav-fill
مثال با استفاده از <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>
کار با نرم افزارهای فلکس
اگر به تغییرات ناوبری پاسخگو نیاز دارید، از یک سری برنامه کاربردی flexbox استفاده کنید. این ابزارها در حالی که پرمخاطب تر هستند، سفارشی سازی بیشتری را در نقاط شکست پاسخگو ارائه می دهند. در مثال زیر، ناوبری ما در پایینترین نقطه شکست انباشته میشود، سپس با یک طرح افقی سازگار میشود که عرض موجود را با شروع از نقطه شکست کوچک پر میکند.
<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>
در مورد دسترسی
اگر از Navs برای ارائه یک نوار پیمایش استفاده میکنید، حتماً یک علامت role="navigation"
را به منطقیترین محفظه والد اضافه کنید <ul>
، یا یک <nav>
عنصر را در اطراف کل پیمایش قرار دهید. نقش را به خود اضافه نکنید <ul>
، زیرا از اعلام آن به عنوان یک لیست واقعی توسط فناوری های کمکی جلوگیری می کند.
توجه داشته باشید که نوارهای پیمایش، حتی اگر به صورت بصری به عنوان زبانه با .nav-tabs
کلاس استایل داده شوند ، نباید یا ویژگی داده شوند. اینها فقط برای رابطهای تبدار پویا مناسب هستند، همانطور که در شیوههای نگارش WAI ARIA توضیح داده شده است. برای مثال ، رفتار جاوا اسکریپت را برای رابط های تب دار پویا در این بخش ببینید. این ویژگی در رابطهای تبدار پویا ضروری نیست، زیرا جاوا اسکریپت ما وضعیت انتخابشده را با اضافه کردن برگه فعال کنترل میکند.role="tablist"
role="tab"
role="tabpanel"
aria-current
aria-selected="true"
استفاده از کرکره ها
منوهای کشویی را با کمی HTML اضافی و افزونه جاوا اسکریپت کشویی اضافه کنید .
برگه ها با فهرست کشویی
<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>
قرص هایی با کشویی
<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>
ساس
متغیرها
$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;
رفتار جاوا اسکریپت
از افزونه جاوا اسکریپت برگه استفاده کنید - آن را به صورت جداگانه یا از طریق bootstrap.js
فایل کامپایل شده اضافه کنید - تا برگهها و قرصهای ناوبری ما را برای ایجاد صفحات جدولی از محتوای محلی گسترش دهید.
رابطهای زبانهدار پویا، همانطور که در شیوههای نگارش WAI ARIA توضیح داده شده است، برای انتقال ساختار، عملکرد و وضعیت فعلی خود به کاربران فنآوریهای کمکی (مانند صفحهخوانها) به role="tablist"
, role="tab"
, role="tabpanel"
و ویژگیهای اضافی نیاز دارند . aria-
به عنوان بهترین روش، توصیه میکنیم از <button>
عناصر برای برگهها استفاده کنید، زیرا اینها کنترلهایی هستند که باعث ایجاد یک تغییر پویا میشوند، نه پیوندهایی که به یک صفحه یا مکان جدید هدایت میشوند.
توجه داشته باشید که رابطهای تبدار پویا نباید دارای منوهای کشویی باشند، زیرا این امر باعث ایجاد مشکلاتی در قابلیت استفاده و دسترسی میشود. از منظر قابلیت استفاده، این واقعیت که عنصر ماشه تب نمایش داده شده در حال حاضر بلافاصله قابل مشاهده نیست (چون در داخل منوی بازشوی بسته قرار دارد) می تواند باعث سردرگمی شود. از نقطه نظر دسترسی، در حال حاضر هیچ راه معقولی برای ترسیم این نوع ساختار به الگوی استاندارد WAI ARIA وجود ندارد، به این معنی که نمی توان آن را به راحتی برای کاربران فناوری های کمکی قابل درک کرد.
این برخی از محتوای نگهدارنده مکان، محتوای مرتبط با برگه صفحه اصلی است. با کلیک کردن بر روی برگه دیگر، نمایان شدن این یکی برای بعدی تغییر می کند. برگه جاوا اسکریپت کلاسها را برای کنترل نمایان شدن محتوا و سبکدهی، تعویض میکند. شما می توانید آن را با زبانه ها، قرص ها، و هر .nav
ناوبری قدرتمند دیگر استفاده کنید.
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>
برای کمک به برآوردن نیازهای شما، این کار با <ul>
نشانهگذاری مبتنی بر آن، همانطور که در بالا نشان داده شده است، یا با هر نشانهگذاری دلخواه «رول خودتان» کار میکند. توجه داشته باشید که اگر از را استفاده <nav>
میکنید، نباید role="tablist"
مستقیماً به آن اضافه کنید، زیرا این کار نقش اصلی عنصر را بهعنوان یک نشانه ناوبری لغو میکند. در عوض، به یک عنصر جایگزین (در مثال زیر، یک ساده <div>
) بروید و <nav>
اطراف آن را بپیچید.
<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>
افزونه تب با قرص ها نیز کار می کند.
این برخی از محتوای نگهدارنده مکان، محتوای مرتبط با برگه صفحه اصلی است. با کلیک کردن بر روی برگه دیگر، نمایان شدن این یکی برای بعدی تغییر می کند. برگه جاوا اسکریپت کلاسها را برای کنترل نمایان شدن محتوا و سبکدهی، تعویض میکند. شما می توانید آن را با زبانه ها، قرص ها، و هر .nav
ناوبری قدرتمند دیگر استفاده کنید.
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>
و با قرص های عمودی.
این برخی از محتوای نگهدارنده مکان، محتوای مرتبط با برگه صفحه اصلی است. با کلیک کردن بر روی برگه دیگر، نمایان شدن این یکی برای بعدی تغییر می کند. برگه جاوا اسکریپت کلاسها را برای کنترل نمایان شدن محتوا و سبکدهی، تعویض میکند. شما می توانید آن را با زبانه ها، قرص ها، و هر .nav
ناوبری قدرتمند دیگر استفاده کنید.
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>
استفاده از ویژگی های داده
شما می توانید پیمایش یک برگه یا قرص را بدون نوشتن جاوا اسکریپت به سادگی با تعیین data-bs-toggle="tab"
یا data-bs-toggle="pill"
روی یک عنصر فعال کنید. از این ویژگی های داده در .nav-tabs
یا .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>
از طریق جاوا اسکریپت
برگه های Tabable را از طریق جاوا اسکریپت فعال کنید (هر برگه باید به صورت جداگانه فعال شود):
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()
})
})
شما می توانید برگه های فردی را به چند روش فعال کنید:
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
به هر کدام اضافه کنید .tab-pane
. اولین صفحه تب نیز باید .show
محتوای اولیه را قابل مشاهده کند.
<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>
مواد و روش ها
روش ها و انتقال های ناهمزمان
همه متدهای API ناهمزمان هستند و یک انتقال را شروع می کنند . آنها به محض شروع انتقال اما قبل از پایان آن به تماس گیرنده باز می گردند . علاوه بر این، فراخوانی متد بر روی یک جزء انتقال نادیده گرفته خواهد شد .
constructor
یک عنصر برگه و محفظه محتوا را فعال می کند. Tab باید دارای یک data-bs-target
یا، در صورت استفاده از پیوند، یک href
ویژگی باشد که یک گره ظرف در 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>
نشان می دهد
برگه داده شده را انتخاب می کند و صفحه مربوط به آن را نشان می دهد. هر برگه دیگری که قبلاً انتخاب شده بود غیرانتخاب می شود و صفحه مربوط به آن پنهان می شود. قبل از اینکه صفحه برگه واقعاً نشان داده شود (یعنی قبل از shown.bs.tab
وقوع رویداد) به تماس گیرنده برمی گردد.
var someTabTriggerEl = document.querySelector('#someTabTrigger')
var tab = new bootstrap.Tab(someTabTriggerEl)
tab.show()
در معرض قرار دادن
تب یک عنصر را از بین می برد.
getInstance
روش ایستا که به شما امکان می دهد نمونه برگه مرتبط با یک عنصر DOM را دریافت کنید
var triggerEl = document.querySelector('#trigger')
var tab = bootstrap.Tab.getInstance(triggerEl) // Returns a Bootstrap tab instance
getOrCreateInstance
روش ایستا که به شما امکان می دهد نمونه برگه مرتبط با یک عنصر DOM را دریافت کنید، یا در صورتی که اولیه نشده بود، یک نمونه جدید ایجاد کنید.
var triggerEl = document.querySelector('#trigger')
var tab = bootstrap.Tab.getOrCreateInstance(triggerEl) // Returns a Bootstrap tab instance
مناسبت ها
هنگام نمایش یک برگه جدید، رویدادها به ترتیب زیر فعال می شوند:
hide.bs.tab
(در برگه فعال فعلی)show.bs.tab
(در برگه برای نشان دادن)hidden.bs.tab
(در برگه فعال قبلی، همان برگهhide.bs.tab
رویداد)shown.bs.tab
(در برگه تازه نشان داده شده فعال، همان برگهshow.bs.tab
رویداد)
اگر هیچ برگه ای قبلاً فعال نبوده است، رویدادهای hide.bs.tab
و فعال hidden.bs.tab
نمی شوند.
نوع رویداد | شرح |
---|---|
show.bs.tab |
این رویداد در نمایش برگه فعال می شود، اما قبل از اینکه برگه جدید نشان داده شود. از event.target و event.relatedTarget برای هدف قرار دادن برگه فعال و برگه فعال قبلی (در صورت موجود بودن) استفاده کنید. |
shown.bs.tab |
این رویداد پس از نمایش یک برگه در نمایش برگه فعال می شود. از event.target و event.relatedTarget برای هدف قرار دادن برگه فعال و برگه فعال قبلی (در صورت موجود بودن) استفاده کنید. |
hide.bs.tab |
این رویداد زمانی فعال می شود که یک برگه جدید نشان داده شود (و بنابراین باید برگه فعال قبلی پنهان شود). به ترتیب از برگه فعال فعلی و برگه جدید که به زودی فعال می شود استفاده کنید event.target و آن را هدف قرار دهید.event.relatedTarget |
hidden.bs.tab |
این رویداد پس از نمایش یک برگه جدید فعال می شود (و بنابراین تب فعال قبلی پنهان می شود). به ترتیب از event.target و event.relatedTarget برای هدف قرار دادن تب فعال قبلی و تب فعال جدید استفاده کنید. |
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
})