Անցեք հիմնական բովանդակությանը Բաց թողնել փաստաթղթերի նավարկություն
Check
in English

Ցուցակի խումբ

Ցուցակի խմբերը ճկուն և հզոր բաղադրիչ են մի շարք բովանդակություն ցուցադրելու համար: Փոփոխեք և ընդլայնեք դրանք՝ աջակցելու համար ներսում գրեթե ցանկացած բովանդակություն:

Հիմնական օրինակ

Ցուցակի ամենահիմնական խումբը չդասավորված ցուցակն է՝ ցուցակի տարրերով և համապատասխան դասերով: Կառուցեք դրա վրա հաջորդող տարբերակներով կամ անհրաժեշտության դեպքում ձեր սեփական CSS-ով:

  • Մի իր
  • Երկրորդ կետ
  • Երրորդ կետ
  • Չորրորդ կետ
  • Եվ հինգերորդը
html
<ul class="list-group">
  <li class="list-group-item">An item</li>
  <li class="list-group-item">A second item</li>
  <li class="list-group-item">A third item</li>
  <li class="list-group-item">A fourth item</li>
  <li class="list-group-item">And a fifth one</li>
</ul>

Ակտիվ տարրեր

Ավելացրեք .activea- .list-group-itemին՝ ընթացիկ ակտիվ ընտրությունը նշելու համար:

  • Ակտիվ նյութ
  • Երկրորդ կետ
  • Երրորդ կետ
  • Չորրորդ կետ
  • Եվ հինգերորդը
html
<ul class="list-group">
  <li class="list-group-item active" aria-current="true">An active item</li>
  <li class="list-group-item">A second item</li>
  <li class="list-group-item">A third item</li>
  <li class="list-group-item">A fourth item</li>
  <li class="list-group-item">And a fifth one</li>
</ul>

Հաշմանդամ տարրեր

Ավելացրեք .disableda- .list-group-itemին, որպեսզի այն անջատված երևա : Նկատի ունեցեք, որ որոշ տարրերի հետ .disabledնաև կպահանջվի հատուկ JavaScript՝ իրենց սեղմումների իրադարձություններն ամբողջությամբ անջատելու համար (օրինակ՝ հղումները):

  • Հաշմանդամ տարր
  • Երկրորդ կետ
  • Երրորդ կետ
  • Չորրորդ կետ
  • Եվ հինգերորդը
html
<ul class="list-group">
  <li class="list-group-item disabled" aria-disabled="true">A disabled item</li>
  <li class="list-group-item">A second item</li>
  <li class="list-group-item">A third item</li>
  <li class="list-group-item">A fourth item</li>
  <li class="list-group-item">And a fifth one</li>
</ul>

Օգտագործեք <a>s կամ <button>s՝ սավառնող, անջատված և ակտիվ վիճակներով գործող ցանկի տարրեր ստեղծելու.list-group-item-action համար՝ ավելացնելով : Մենք առանձնացնում ենք այս կեղծ դասերը՝ ապահովելու համար, որ ոչ ինտերակտիվ տարրերից կազմված ցուցակի խմբերը (ինչպես <li>s կամ <div>s) չեն ապահովում սեղմման կամ հպման հնարավորությունը:

Համոզվեք, որ այստեղ չեք օգտագործում ստանդարտ .btnդասերը :

html
<div class="list-group">
  <a href="#" class="list-group-item list-group-item-action active" aria-current="true">
    The current link item
  </a>
  <a href="#" class="list-group-item list-group-item-action">A second link item</a>
  <a href="#" class="list-group-item list-group-item-action">A third link item</a>
  <a href="#" class="list-group-item list-group-item-action">A fourth link item</a>
  <a class="list-group-item list-group-item-action disabled">A disabled link item</a>
</div>

s- <button>ով կարող եք նաև օգտագործել disabledհատկանիշը .disabledդասի փոխարեն: Ցավոք, <a>s չի աջակցում անջատված հատկանիշը:

html
<div class="list-group">
  <button type="button" class="list-group-item list-group-item-action active" aria-current="true">
    The current button
  </button>
  <button type="button" class="list-group-item list-group-item-action">A second button item</button>
  <button type="button" class="list-group-item list-group-item-action">A third button item</button>
  <button type="button" class="list-group-item list-group-item-action">A fourth button item</button>
  <button type="button" class="list-group-item list-group-item-action" disabled>A disabled button item</button>
</div>

ողողել

Ավելացրեք .list-group-flush՝ որոշ եզրագծեր և կլորացված անկյուններ հեռացնելու համար՝ ցուցակի խմբային տարրերը ծայրից ծայր մայր կոնտեյներով (օրինակ՝ քարտեր) ցուցադրելու համար:

  • Մի իր
  • Երկրորդ կետ
  • Երրորդ կետ
  • Չորրորդ կետ
  • Եվ հինգերորդը
html
<ul class="list-group list-group-flush">
  <li class="list-group-item">An item</li>
  <li class="list-group-item">A second item</li>
  <li class="list-group-item">A third item</li>
  <li class="list-group-item">A fourth item</li>
  <li class="list-group-item">And a fifth one</li>
</ul>

Համարակալված

Ավելացրեք .list-group-numberedմոդիֆիկատորների դասը (և ըստ ցանկության՝ օգտագործեք <ol>տարր)՝ ընտրելու համարակալված ցուցակի խմբի տարրերը: Թվերը ստեղծվում են CSS-ի միջոցով (ի տարբերություն <ol>զննարկիչի լռելյայն ոճավորման)՝ ցուցակի խմբի տարրերի ներսում ավելի լավ տեղադրելու և ավելի լավ հարմարեցման համար:

Թվերը ստեղծվում են ըստ counter-reset, <ol>և այնուհետև ոճավորվում և տեղադրվում են ::beforeկեղծ տարրով <li>with counter-incrementand- ի վրա content:

  1. Ցանկի տարր
  2. Ցանկի տարր
  3. Ցանկի տարր
html
<ol class="list-group list-group-numbered">
  <li class="list-group-item">A list item</li>
  <li class="list-group-item">A list item</li>
  <li class="list-group-item">A list item</li>
</ol>

Սրանք հիանալի են աշխատում նաև հատուկ բովանդակության հետ:

  1. Ենթավերնագիր
    Ցանկի տարրի բովանդակությունը
    14
  2. Ենթավերնագիր
    Ցանկի տարրի բովանդակությունը
    14
  3. Ենթավերնագիր
    Ցանկի տարրի բովանդակությունը
    14
html
<ol class="list-group list-group-numbered">
  <li class="list-group-item d-flex justify-content-between align-items-start">
    <div class="ms-2 me-auto">
      <div class="fw-bold">Subheading</div>
      Content for list item
    </div>
    <span class="badge bg-primary rounded-pill">14</span>
  </li>
  <li class="list-group-item d-flex justify-content-between align-items-start">
    <div class="ms-2 me-auto">
      <div class="fw-bold">Subheading</div>
      Content for list item
    </div>
    <span class="badge bg-primary rounded-pill">14</span>
  </li>
  <li class="list-group-item d-flex justify-content-between align-items-start">
    <div class="ms-2 me-auto">
      <div class="fw-bold">Subheading</div>
      Content for list item
    </div>
    <span class="badge bg-primary rounded-pill">14</span>
  </li>
</ol>

Հորիզոնական

Ավելացրեք .list-group-horizontal՝ ցանկի խմբային տարրերի դասավորությունը ուղղահայացից դեպի հորիզոնական բոլոր ընդմիջման կետերում փոխելու համար: Որպես այլընտրանք, ընտրեք արձագանքող տարբերակ .list-group-horizontal-{sm|md|lg|xl|xxl}՝ ցուցակի խումբը հորիզոնական դարձնելու համար՝ սկսած այդ ընդմիջման կետից min-width: Ներկայում հորիզոնական ցուցակի խմբերը չեն կարող համակցվել համակցված ցուցակի խմբերի հետ:

ProTip. Ցանկանու՞մ եք հավասար լայնության ցուցակի տարրեր, երբ հորիզոնական են: Ավելացնել .flex-fillյուրաքանչյուր ցանկի խմբի տարր:

  • Մի իր
  • Երկրորդ կետ
  • Երրորդ կետ
  • Մի իր
  • Երկրորդ կետ
  • Երրորդ կետ
  • Մի իր
  • Երկրորդ կետ
  • Երրորդ կետ
  • Մի իր
  • Երկրորդ կետ
  • Երրորդ կետ
  • Մի իր
  • Երկրորդ կետ
  • Երրորդ կետ
  • Մի իր
  • Երկրորդ կետ
  • Երրորդ կետ
html
<ul class="list-group list-group-horizontal">
  <li class="list-group-item">An item</li>
  <li class="list-group-item">A second item</li>
  <li class="list-group-item">A third item</li>
</ul>
<ul class="list-group list-group-horizontal-sm">
  <li class="list-group-item">An item</li>
  <li class="list-group-item">A second item</li>
  <li class="list-group-item">A third item</li>
</ul>
<ul class="list-group list-group-horizontal-md">
  <li class="list-group-item">An item</li>
  <li class="list-group-item">A second item</li>
  <li class="list-group-item">A third item</li>
</ul>
<ul class="list-group list-group-horizontal-lg">
  <li class="list-group-item">An item</li>
  <li class="list-group-item">A second item</li>
  <li class="list-group-item">A third item</li>
</ul>
<ul class="list-group list-group-horizontal-xl">
  <li class="list-group-item">An item</li>
  <li class="list-group-item">A second item</li>
  <li class="list-group-item">A third item</li>
</ul>
<ul class="list-group list-group-horizontal-xxl">
  <li class="list-group-item">An item</li>
  <li class="list-group-item">A second item</li>
  <li class="list-group-item">A third item</li>
</ul>

Համատեքստային դասեր

Օգտագործեք համատեքստային դասեր՝ վիճակագրական ֆոնով և գույնով տարրերի ցանկի ոճավորման համար:

  • Պարզ լռելյայն ցուցակի խմբի տարր
  • Պարզ առաջնային ցուցակի խմբային տարր
  • Պարզ երկրորդական ցուցակի խմբային տարր
  • Պարզ հաջողության ցանկի խմբային տարր
  • Պարզ վտանգի ցուցակի խմբային տարր
  • Պարզ նախազգուշացման ցուցակի խմբային տարր
  • Պարզ տեղեկատվական ցանկի խմբային տարր
  • Պարզ թեթև ցուցակի խմբային տարր
  • Պարզ մութ ցուցակի խմբային տարր
html
<ul class="list-group">
  <li class="list-group-item">A simple default list group item</li>

  <li class="list-group-item list-group-item-primary">A simple primary list group item</li>
  <li class="list-group-item list-group-item-secondary">A simple secondary list group item</li>
  <li class="list-group-item list-group-item-success">A simple success list group item</li>
  <li class="list-group-item list-group-item-danger">A simple danger list group item</li>
  <li class="list-group-item list-group-item-warning">A simple warning list group item</li>
  <li class="list-group-item list-group-item-info">A simple info list group item</li>
  <li class="list-group-item list-group-item-light">A simple light list group item</li>
  <li class="list-group-item list-group-item-dark">A simple dark list group item</li>
</ul>

Համատեքստային դասերը նույնպես աշխատում են .list-group-item-action. Ուշադրություն դարձրեք սավառնող ոճերի ավելացմանը, որոնք ներկայացված չեն նախորդ օրինակում: Աջակցում է նաև .activeպետությունը. կիրառել այն՝ համատեքստային ցանկի խմբի տարրի վրա ակտիվ ընտրություն նշելու համար:

html
<div class="list-group">
  <a href="#" class="list-group-item list-group-item-action">A simple default list group item</a>

  <a href="#" class="list-group-item list-group-item-action list-group-item-primary">A simple primary list group item</a>
  <a href="#" class="list-group-item list-group-item-action list-group-item-secondary">A simple secondary list group item</a>
  <a href="#" class="list-group-item list-group-item-action list-group-item-success">A simple success list group item</a>
  <a href="#" class="list-group-item list-group-item-action list-group-item-danger">A simple danger list group item</a>
  <a href="#" class="list-group-item list-group-item-action list-group-item-warning">A simple warning list group item</a>
  <a href="#" class="list-group-item list-group-item-action list-group-item-info">A simple info list group item</a>
  <a href="#" class="list-group-item list-group-item-action list-group-item-light">A simple light list group item</a>
  <a href="#" class="list-group-item list-group-item-action list-group-item-dark">A simple dark list group item</a>
</div>
Օժանդակ տեխնոլոգիաներին իմաստ հաղորդելը

Իմաստ ավելացնելու համար գույնի օգտագործումը միայն տեսողական ցուցում է տալիս, որը չի փոխանցվի օժանդակ տեխնոլոգիաների օգտագործողներին, ինչպիսիք են էկրանի ընթերցողները: Համոզվեք, որ գույնով նշված տեղեկատվությունը կա՛մ ակնհայտ է հենց բովանդակությունից (օրինակ՝ տեսանելի տեքստից), կա՛մ ներառված է այլընտրանքային միջոցներով, ինչպիսին է .visually-hiddenդասի հետ թաքցված լրացուցիչ տեքստը:

Կրծքանշաններով

Ցուցակի խմբի ցանկացած տարր ավելացրեք նշանակներ՝ որոշ կոմունալ ծրագրերի օգնությամբ չընթերցված թվերը, ակտիվությունը և ավելին ցույց տալու համար :

  • Ցանկի տարր14
  • Ցանկի երկրորդ կետը2
  • Ցանկի երրորդ կետը1
html
<ul class="list-group">
  <li class="list-group-item d-flex justify-content-between align-items-center">
    A list item
    <span class="badge bg-primary rounded-pill">14</span>
  </li>
  <li class="list-group-item d-flex justify-content-between align-items-center">
    A second list item
    <span class="badge bg-primary rounded-pill">2</span>
  </li>
  <li class="list-group-item d-flex justify-content-between align-items-center">
    A third list item
    <span class="badge bg-primary rounded-pill">1</span>
  </li>
</ul>

Պատվերով բովանդակություն

Ավելացրեք գրեթե ցանկացած HTML ներսում, նույնիսկ կապված ցուցակի խմբերի համար, ինչպիսին է ստորև, flexbox կոմունալ ծրագրերի օգնությամբ :

html
<div class="list-group">
  <a href="#" class="list-group-item list-group-item-action active" aria-current="true">
    <div class="d-flex w-100 justify-content-between">
      <h5 class="mb-1">List group item heading</h5>
      <small>3 days ago</small>
    </div>
    <p class="mb-1">Some placeholder content in a paragraph.</p>
    <small>And some small print.</small>
  </a>
  <a href="#" class="list-group-item list-group-item-action">
    <div class="d-flex w-100 justify-content-between">
      <h5 class="mb-1">List group item heading</h5>
      <small class="text-muted">3 days ago</small>
    </div>
    <p class="mb-1">Some placeholder content in a paragraph.</p>
    <small class="text-muted">And some muted small print.</small>
  </a>
  <a href="#" class="list-group-item list-group-item-action">
    <div class="d-flex w-100 justify-content-between">
      <h5 class="mb-1">List group item heading</h5>
      <small class="text-muted">3 days ago</small>
    </div>
    <p class="mb-1">Some placeholder content in a paragraph.</p>
    <small class="text-muted">And some muted small print.</small>
  </a>
</div>

Նշման տուփեր և ռադիոներ

Տեղադրեք Bootstrap-ի վանդակները և ռադիոկայանները ցուցակի խմբի տարրերի մեջ և հարմարեցրեք ըստ անհրաժեշտության: Դուք կարող եք դրանք օգտագործել առանց <label>s, բայց խնդրում ենք հիշել, որ ներառեք aria-labelհատկանիշ և արժեք մատչելիության համար:

html
<ul class="list-group">
  <li class="list-group-item">
    <input class="form-check-input me-1" type="checkbox" value="" id="firstCheckbox">
    <label class="form-check-label" for="firstCheckbox">First checkbox</label>
  </li>
  <li class="list-group-item">
    <input class="form-check-input me-1" type="checkbox" value="" id="secondCheckbox">
    <label class="form-check-label" for="secondCheckbox">Second checkbox</label>
  </li>
  <li class="list-group-item">
    <input class="form-check-input me-1" type="checkbox" value="" id="thirdCheckbox">
    <label class="form-check-label" for="thirdCheckbox">Third checkbox</label>
  </li>
</ul>
html
<ul class="list-group">
  <li class="list-group-item">
    <input class="form-check-input me-1" type="radio" name="listGroupRadio" value="" id="firstRadio" checked>
    <label class="form-check-label" for="firstRadio">First radio</label>
  </li>
  <li class="list-group-item">
    <input class="form-check-input me-1" type="radio" name="listGroupRadio" value="" id="secondRadio">
    <label class="form-check-label" for="secondRadio">Second radio</label>
  </li>
  <li class="list-group-item">
    <input class="form-check-input me-1" type="radio" name="listGroupRadio" value="" id="thirdRadio">
    <label class="form-check-label" for="thirdRadio">Third radio</label>
  </li>
</ul>

Դուք կարող եք օգտագործել s-ի .stretched-linkվրա <label>՝ ամբողջ ցանկի խմբի տարրը սեղմելի դարձնելու համար:

html
<ul class="list-group">
  <li class="list-group-item">
    <input class="form-check-input me-1" type="checkbox" value="" id="firstCheckboxStretched">
    <label class="form-check-label stretched-link" for="firstCheckboxStretched">First checkbox</label>
  </li>
  <li class="list-group-item">
    <input class="form-check-input me-1" type="checkbox" value="" id="secondCheckboxStretched">
    <label class="form-check-label stretched-link" for="secondCheckboxStretched">Second checkbox</label>
  </li>
  <li class="list-group-item">
    <input class="form-check-input me-1" type="checkbox" value="" id="thirdCheckboxStretched">
    <label class="form-check-label stretched-link" for="thirdCheckboxStretched">Third checkbox</label>
  </li>
</ul>

CSS

Փոփոխականներ

Ավելացված է v5.2.0-ում

Որպես Bootstrap-ի զարգացող CSS փոփոխականների մոտեցման մաս, ցուցակի խմբերն այժմ օգտագործում են տեղական CSS փոփոխականները՝ .list-groupիրական ժամանակում ընդլայնված հարմարեցման համար: CSS փոփոխականների արժեքները սահմանվում են Sass-ի միջոցով, ուստի Sass-ի հարմարեցումը դեռևս աջակցվում է:

  --#{$prefix}list-group-color: #{$list-group-color};
  --#{$prefix}list-group-bg: #{$list-group-bg};
  --#{$prefix}list-group-border-color: #{$list-group-border-color};
  --#{$prefix}list-group-border-width: #{$list-group-border-width};
  --#{$prefix}list-group-border-radius: #{$list-group-border-radius};
  --#{$prefix}list-group-item-padding-x: #{$list-group-item-padding-x};
  --#{$prefix}list-group-item-padding-y: #{$list-group-item-padding-y};
  --#{$prefix}list-group-action-color: #{$list-group-action-color};
  --#{$prefix}list-group-action-hover-color: #{$list-group-action-hover-color};
  --#{$prefix}list-group-action-hover-bg: #{$list-group-hover-bg};
  --#{$prefix}list-group-action-active-color: #{$list-group-action-active-color};
  --#{$prefix}list-group-action-active-bg: #{$list-group-action-active-bg};
  --#{$prefix}list-group-disabled-color: #{$list-group-disabled-color};
  --#{$prefix}list-group-disabled-bg: #{$list-group-disabled-bg};
  --#{$prefix}list-group-active-color: #{$list-group-active-color};
  --#{$prefix}list-group-active-bg: #{$list-group-active-bg};
  --#{$prefix}list-group-active-border-color: #{$list-group-active-border-color};
  

Sass փոփոխականներ

$list-group-color:                  $gray-900;
$list-group-bg:                     $white;
$list-group-border-color:           rgba($black, .125);
$list-group-border-width:           $border-width;
$list-group-border-radius:          $border-radius;

$list-group-item-padding-y:         $spacer * .5;
$list-group-item-padding-x:         $spacer;
$list-group-item-bg-scale:          -80%;
$list-group-item-color-scale:       40%;

$list-group-hover-bg:               $gray-100;
$list-group-active-color:           $component-active-color;
$list-group-active-bg:              $component-active-bg;
$list-group-active-border-color:    $list-group-active-bg;

$list-group-disabled-color:         $gray-600;
$list-group-disabled-bg:            $list-group-bg;

$list-group-action-color:           $gray-700;
$list-group-action-hover-color:     $list-group-action-color;

$list-group-action-active-color:    $body-color;
$list-group-action-active-bg:       $gray-200;

Միքսիններ

Օգտագործվում է համակցությամբ՝ s-ի համար համատեքստային տարբերակային դասեր$theme-colors ստեղծելու համար :.list-group-item

@mixin list-group-item-variant($state, $background, $color) {
  .list-group-item-#{$state} {
    color: $color;
    background-color: $background;

    &.list-group-item-action {
      &:hover,
      &:focus {
        color: $color;
        background-color: shade-color($background, 10%);
      }

      &.active {
        color: $white;
        background-color: $color;
        border-color: $color;
      }
    }
  }
}

Օղակ

Օղակ, որը ստեղծում է մոդիֆիկատորների դասեր list-group-item-variant()mixin-ի հետ:

// List group contextual variants
//
// Add modifier classes to change text and background color on individual items.
// Organizationally, this must come after the `:hover` states.

@each $state, $value in $theme-colors {
  $list-group-variant-bg: shift-color($value, $list-group-item-bg-scale);
  $list-group-variant-color: shift-color($value, $list-group-item-color-scale);
  @if (contrast-ratio($list-group-variant-bg, $list-group-variant-color) < $min-contrast-ratio) {
    $list-group-variant-color: mix($value, color-contrast($list-group-variant-bg), abs($list-group-item-color-scale));
  }

  @include list-group-item-variant($state, $list-group-variant-bg, $list-group-variant-color);
}

JavaScript-ի վարքագիծը

Օգտագործեք ներդիրի JavaScript հավելվածը, ներառեք այն անհատապես կամ կազմված bootstrap.jsֆայլի միջոցով, մեր ցուցակի խումբը ընդլայնելու համար՝ տեղական բովանդակության ներդիրային վահանակներ ստեղծելու համար:

<div class="row">
  <div class="col-4">
    <div class="list-group" id="list-tab" role="tablist">
      <a class="list-group-item list-group-item-action active" id="list-home-list" data-bs-toggle="list" href="#list-home" role="tab" aria-controls="list-home">Home</a>
      <a class="list-group-item list-group-item-action" id="list-profile-list" data-bs-toggle="list" href="#list-profile" role="tab" aria-controls="list-profile">Profile</a>
      <a class="list-group-item list-group-item-action" id="list-messages-list" data-bs-toggle="list" href="#list-messages" role="tab" aria-controls="list-messages">Messages</a>
      <a class="list-group-item list-group-item-action" id="list-settings-list" data-bs-toggle="list" href="#list-settings" role="tab" aria-controls="list-settings">Settings</a>
    </div>
  </div>
  <div class="col-8">
    <div class="tab-content" id="nav-tabContent">
      <div class="tab-pane fade show active" id="list-home" role="tabpanel" aria-labelledby="list-home-list">...</div>
      <div class="tab-pane fade" id="list-profile" role="tabpanel" aria-labelledby="list-profile-list">...</div>
      <div class="tab-pane fade" id="list-messages" role="tabpanel" aria-labelledby="list-messages-list">...</div>
      <div class="tab-pane fade" id="list-settings" role="tabpanel" aria-labelledby="list-settings-list">...</div>
    </div>
  </div>
</div>

Օգտագործելով տվյալների ատրիբուտները

Դուք կարող եք ակտիվացնել ցուցակի խմբային նավիգացիան՝ առանց որևէ JavaScript գրելու՝ պարզապես նշելով data-bs-toggle="list"կամ որևէ տարրի վրա: Օգտագործեք այս տվյալների ատրիբուտները .list-group-item.

<div role="tabpanel">
  <!-- List group -->
  <div class="list-group" id="myList" role="tablist">
    <a class="list-group-item list-group-item-action active" data-bs-toggle="list" href="#home" role="tab">Home</a>
    <a class="list-group-item list-group-item-action" data-bs-toggle="list" href="#profile" role="tab">Profile</a>
    <a class="list-group-item list-group-item-action" data-bs-toggle="list" href="#messages" role="tab">Messages</a>
    <a class="list-group-item list-group-item-action" data-bs-toggle="list" href="#settings" role="tab">Settings</a>
  </div>

  <!-- Tab panes -->
  <div class="tab-content">
    <div class="tab-pane active" id="home" role="tabpanel">...</div>
    <div class="tab-pane" id="profile" role="tabpanel">...</div>
    <div class="tab-pane" id="messages" role="tabpanel">...</div>
    <div class="tab-pane" id="settings" role="tabpanel">...</div>
  </div>
</div>

JavaScript-ի միջոցով

Միացնել ներդիրների ցանկի տարրը JavaScript-ի միջոցով (ցուցակի յուրաքանչյուր տարր պետք է առանձին ակտիվացվի).

const triggerTabList = document.querySelectorAll('#myTab a')
triggerTabList.forEach(triggerEl => {
  const tabTrigger = new bootstrap.Tab(triggerEl)

  triggerEl.addEventListener('click', event => {
    event.preventDefault()
    tabTrigger.show()
  })
})

Դուք կարող եք ակտիվացնել առանձին ցանկի տարրը մի քանի եղանակով.

const triggerEl = document.querySelector('#myTab a[href="#profile"]')
bootstrap.Tab.getInstance(triggerEl).show() // Select tab by name

const triggerFirstTabEl = document.querySelector('#myTab li:first-child a')
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">...</div>
  <div class="tab-pane fade" id="profile" role="tabpanel">...</div>
  <div class="tab-pane fade" id="messages" role="tabpanel">...</div>
  <div class="tab-pane fade" id="settings" role="tabpanel">...</div>
</div>

Մեթոդներ

Ասինխրոն մեթոդներ և անցումներ

Բոլոր API մեթոդները ասինխրոն են և սկսում են անցում : Նրանք վերադառնում են զանգահարողին հենց որ անցումը սկսվի, բայց մինչև այն ավարտվի : Բացի այդ, անցումային բաղադրիչի վրա մեթոդի կանչը անտեսվելու է :

Լրացուցիչ տեղեկությունների համար տես մեր JavaScript փաստաթղթերը :

Ակտիվացնում է ձեր բովանդակությունը որպես ներդիրի տարր:

Դուք կարող եք ստեղծել ներդիրի օրինակ կոնստրուկտորով, օրինակ՝

const bsTab = new bootstrap.Tab('#myTab')
Մեթոդ Նկարագրություն
dispose Ոչնչացնում է տարրի ներդիրը:
getInstance Ստատիկ մեթոդ, որը թույլ է տալիս ստանալ DOM տարրի հետ կապված ներդիրի օրինակը, կարող եք օգտագործել այն այսպես bootstrap.Tab.getInstance(element).
getOrCreateInstance Ստատիկ մեթոդ, որը վերադարձնում է ներդիրի օրինակ, որը կապված է DOM տարրի հետ կամ ստեղծում է նորը, եթե այն նախաստորագրված չէ: Դուք կարող եք օգտագործել այն այսպես bootstrap.Tab.getOrCreateInstance(element).
show Ընտրում է տվյալ ներդիրը և ցույց տալիս դրա հետ կապված վահանակը: Նախկինում ընտրված ցանկացած այլ ներդիր դառնում է չընտրված, և դրա հետ կապված վահանակը թաքցվում է: Վերադառնում է զանգահարողին՝ նախքան ներդիրի վահանակի ցուցադրումը (այսինքն՝ նախքան shown.bs.tabիրադարձությունը տեղի ունենալը):

Իրադարձություններ

Նոր ներդիր ցուցադրելիս իրադարձությունները բացվում են հետևյալ հաջորդականությամբ.

  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իրադարձությունները չեն գործարկվի:

Միջոցառման տեսակը Նկարագրություն
hide.bs.tab Այս իրադարձությունը բացվում է, երբ պետք է ցուցադրվի նոր ներդիր (և այդպիսով, նախորդ ակտիվ ներդիրը պետք է թաքցվի): Օգտագործեք event.targetև event.relatedTargetթիրախավորեք համապատասխանաբար ընթացիկ ակտիվ ներդիրը և նոր շուտով ակտիվանալու ներդիրը:
hidden.bs.tab Այս իրադարձությունը բացվում է նոր ներդիրի ցուցադրումից հետո (և այդպիսով նախորդ ակտիվ ներդիրը թաքցվում է): Օգտագործեք event.targetև event.relatedTargetթիրախավորեք նախորդ ակտիվ ներդիրը և նոր ակտիվ ներդիրը, համապատասխանաբար:
show.bs.tab Այս իրադարձությունը բացվում է ներդիրների ցուցադրման վրա, բայց մինչ նոր ներդիրը կցուցադրվի: Օգտագործեք event.targetև event.relatedTargetթիրախավորեք համապատասխանաբար ակտիվ ներդիրը և նախորդ ակտիվ ներդիրը (եթե առկա է):
shown.bs.tab Այս իրադարձությունը բացվում է ներդիրների ցուցադրումից հետո ներդիրի ցուցադրումից հետո: Օգտագործեք event.targetև event.relatedTargetթիրախավորեք համապատասխանաբար ակտիվ ներդիրը և նախորդ ակտիվ ներդիրը (եթե առկա է):
const tabElms = document.querySelectorAll('a[data-bs-toggle="list"]')
tabElms.forEach(tabElm => {
  tabElm.addEventListener('shown.bs.tab', event => {
    event.target // newly activated tab
    event.relatedTarget // previous active tab
  })
})