in English

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

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

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

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

  • Մի իր
  • Երկրորդ կետ
  • Երրորդ կետ
  • Չորրորդ կետ
  • Եվ հինգերորդը
<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ին՝ ընթացիկ ակտիվ ընտրությունը նշելու համար:

  • Ակտիվ նյութ
  • Երկրորդ կետ
  • Երրորդ կետ
  • Չորրորդ կետ
  • Եվ հինգերորդը
<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՝ իրենց սեղմումների իրադարձություններն ամբողջությամբ անջատելու համար (օրինակ՝ հղումները):

  • Հաշմանդամ տարր
  • Երկրորդ կետ
  • Երրորդ կետ
  • Չորրորդ կետ
  • Եվ հինգերորդը
<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դասերը :

<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 չի աջակցում անջատված հատկանիշը:

<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 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՝ որոշ եզրագծեր և կլորացված անկյուններ հեռացնելու համար՝ ցուցակի խմբային տարրերը ծայրից ծայր մայր կոնտեյներով (օրինակ՝ քարտեր) ցուցադրելու համար:

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

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

  • Մի իր
  • Երկրորդ կետ
  • Երրորդ կետ
  • Մի իր
  • Երկրորդ կետ
  • Երրորդ կետ
  • Մի իր
  • Երկրորդ կետ
  • Երրորդ կետ
  • Մի իր
  • Երկրորդ կետ
  • Երրորդ կետ
  • Մի իր
  • Երկրորդ կետ
  • Երրորդ կետ
<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">
  <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պետությունը. կիրառել այն՝ համատեքստային ցանկի խմբի տարրի վրա ակտիվ ընտրություն նշելու համար:

<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>
Օժանդակ տեխնոլոգիաներին իմաստ հաղորդելը

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

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

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

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

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

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

<div class="list-group">
  <a href="#" class="list-group-item list-group-item-action active">
    <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>

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-toggle="list" href="#list-home" role="tab" aria-controls="home">Home</a>
      <a class="list-group-item list-group-item-action" id="list-profile-list" data-toggle="list" href="#list-profile" role="tab" aria-controls="profile">Profile</a>
      <a class="list-group-item list-group-item-action" id="list-messages-list" data-toggle="list" href="#list-messages" role="tab" aria-controls="messages">Messages</a>
      <a class="list-group-item list-group-item-action" id="list-settings-list" data-toggle="list" href="#list-settings" role="tab" aria-controls="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-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-toggle="list" href="#home" role="tab">Home</a>
    <a class="list-group-item list-group-item-action" data-toggle="list" href="#profile" role="tab">Profile</a>
    <a class="list-group-item list-group-item-action" data-toggle="list" href="#messages" role="tab">Messages</a>
    <a class="list-group-item list-group-item-action" data-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-ի միջոցով (ցուցակի յուրաքանչյուր տարր պետք է առանձին ակտիվացվի).

$('#myList a').on('click', function (event) {
  event.preventDefault()
  $(this).tab('show')
})

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

$('#myList a[href="#profile"]').tab('show') // Select tab by name
$('#myList a:first-child').tab('show') // Select first tab
$('#myList a:last-child').tab('show') // Select last tab
$('#myList a:nth-child(3)').tab('show') // Select third 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>

Մեթոդներ

$().էջանիշ

Ակտիվացնում է ցանկի տարրի տարրը և բովանդակության կոնտեյները: Ներդիրը պետք է ունենա DOM-ում կամ a data-targetկամ hrefթիրախավորող կոնտեյներային հանգույց:

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

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

<script>
  $(function () {
    $('#myList a:last-child').tab('show')
  })
</script>

.tab ('ցուցադրել')

Ընտրում է տվյալ ցանկի տարրը և ցուցադրում դրա հետ կապված վահանակը: Ցանկի ցանկացած այլ տարր, որը նախկինում ընտրվել է, դառնում է չընտրված, և դրա հետ կապված վահանակը թաքցվում է: Վերադառնում է զանգահարողին՝ նախքան ներդիրի վահանակի ցուցադրումը (օրինակ՝ մինչև shown.bs.tabիրադարձության տեղի ունենալը):

$('#someListItem').tab('show')

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

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

  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թիրախավորեք համապատասխանաբար ակտիվ ներդիրը և նախորդ ակտիվ ներդիրը (եթե առկա է):
ցուցադրված.bs.ներդիր Այս իրադարձությունը բացվում է ներդիրների ցուցադրումից հետո ներդիրի ցուցադրումից հետո: Օգտագործեք event.targetև event.relatedTargetթիրախավորեք համապատասխանաբար ակտիվ ներդիրը և նախորդ ակտիվ ներդիրը (եթե առկա է):
hide.bs.tab Այս իրադարձությունը բացվում է, երբ պետք է ցուցադրվի նոր ներդիր (և այդպիսով, նախորդ ակտիվ ներդիրը պետք է թաքցվի): Օգտագործեք event.targetև event.relatedTargetթիրախավորեք համապատասխանաբար ընթացիկ ակտիվ ներդիրը և նոր շուտով ակտիվանալու ներդիրը:
hidden.bs.tab Այս իրադարձությունը բացվում է նոր ներդիրի ցուցադրումից հետո (և այդպիսով նախորդ ակտիվ ներդիրը թաքցվում է): Օգտագործեք event.targetև event.relatedTargetթիրախավորեք նախորդ ակտիվ ներդիրը և նոր ակտիվ ներդիրը, համապատասխանաբար:
$('a[data-toggle="list"]').on('shown.bs.tab', function (event) {
  event.target // newly activated tab
  event.relatedTarget // previous active tab
})