رفتن به محتوای اصلی به پیمایش اسناد بروید
in English

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-items خود، استفاده کنید .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-currentaria-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

مناسبت ها

هنگام نمایش یک برگه جدید، رویدادها به ترتیب زیر فعال می شوند:

  1. hide.bs.tab(در برگه فعال فعلی)
  2. show.bs.tab(در برگه برای نشان دادن)
  3. hidden.bs.tab(در برگه فعال قبلی، همان برگه hide.bs.tabرویداد)
  4. 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
})