in English

Saraksta grupa

Sarakstu grupas ir elastīgs un spēcīgs komponents satura sērijas attēlošanai. Mainiet un paplašiniet tos, lai atbalstītu gandrīz jebkuru saturu.

Pamatpiemērs

Visvienkāršākā sarakstu grupa ir nesakārtots saraksts ar saraksta vienumiem un atbilstošām klasēm. Veidojiet to, izmantojot tālāk norādītās opcijas vai pēc vajadzības ar savu CSS.

  • Lieta
  • Otrs priekšmets
  • Trešais priekšmets
  • Ceturtais postenis
  • Un piektais
<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>

Aktīvie vienumi

Pievienot .activea .list-group-item, lai norādītu pašreizējo aktīvo atlasi.

  • Aktīvs vienums
  • Otrs priekšmets
  • Trešais priekšmets
  • Ceturtais postenis
  • Un piektais
<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>

Atspējotie priekšmeti

Pievienojiet .disableda .list-group-item, lai tas izskatītos atspējots. Ņemiet vērā, ka dažiem elementiem ar .disabledbūs nepieciešams arī pielāgots JavaScript, lai pilnībā atspējotu klikšķu notikumus (piemēram, saites).

  • Atspējots vienums
  • Otrs priekšmets
  • Trešais priekšmets
  • Ceturtais postenis
  • Un piektais
<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>

Izmantojiet <a>s vai <button>s, lai izveidotu darbīgus sarakstu grupas vienumus ar kursora novietošanu, atspējotiem un aktīviem stāvokļiem, pievienojot .list-group-item-action. Mēs nošķiram šīs pseidoklases, lai nodrošinātu, ka sarakstu grupas, kas veidotas no neinteraktīviem elementiem (piemēram, <li>s vai <div>s), nenodrošina klikšķu vai pieskārienu izdevīgumu.

Noteikti neizmantojiet standarta .btnklases šeit .

Pašreizējais saites vienums Otrs saites vienums Trešais saites vienums Ceturtais saites vienums Atspējots saites vienums 
<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>

Izmantojot s, klases vietā <button>varat izmantot arī disabledatribūtu . .disabledDiemžēl <a>s neatbalsta atspējoto atribūtu.

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

Flush

Pievienot .list-group-flush, lai noņemtu dažas apmales un noapaļotus stūrus, lai atveidotu saraksta grupas vienumus no vienas malas līdz malai vecākkonteinerā (piem., kartes).

  • Lieta
  • Otrs priekšmets
  • Trešais priekšmets
  • Ceturtais postenis
  • Un piektais
<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>

Horizontāli

Pievienot .list-group-horizontal, lai mainītu sarakstu grupas vienumu izkārtojumu no vertikāla uz horizontālu visos pārtraukuma punktos. Varat arī izvēlēties adaptīvu variantu .list-group-horizontal-{sm|md|lg|xl}, lai sarakstu grupu padarītu horizontālu, sākot no šī pārtraukuma punkta min-width. Pašlaik horizontālās sarakstu grupas nevar apvienot ar izplūdušo sarakstu grupām.

ProPadoms. Vai vēlaties vienāda platuma saraksta vienumus grupēt horizontālā stāvoklī? Pievienojiet .flex-fillkatram saraksta grupas vienumam.

  • Lieta
  • Otrs priekšmets
  • Trešais priekšmets
  • Lieta
  • Otrs priekšmets
  • Trešais priekšmets
  • Lieta
  • Otrs priekšmets
  • Trešais priekšmets
  • Lieta
  • Otrs priekšmets
  • Trešais priekšmets
  • Lieta
  • Otrs priekšmets
  • Trešais priekšmets
<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>

Kontekstuālās klases

Izmantojiet kontekstuālās klases, lai veidotu saraksta vienumus ar statusu un krāsu.

  • Vienkāršs noklusējuma saraksta grupas vienums
  • Vienkāršs primārā saraksta grupas vienums
  • Vienkāršs sekundārā saraksta grupas vienums
  • Vienkāršs panākumu saraksta grupas vienums
  • Vienkāršs bīstamības saraksta grupas vienums
  • Vienkāršs brīdinājumu saraksta grupas vienums
  • Vienkāršs informācijas saraksta grupas vienums
  • Vienkāršs gaismas saraksta grupas vienums
  • Vienkāršs tumšā saraksta grupas vienums
<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>

Kontekstuālās nodarbības darbojas arī ar .list-group-item-action. Ņemiet vērā, ka šeit ir pievienoti kursora virzīšanas stili, kas nav ietverti iepriekšējā piemērā. Atbalstīta ir arī .activevalsts; lietot to, lai norādītu aktīvo atlasi kontekstuālā saraksta grupas vienumā.

Vienkāršs noklusējuma saraksta grupas vienums Vienkāršs primārā saraksta grupas vienums Vienkāršs sekundārā saraksta grupas vienums Vienkāršs panākumu saraksta grupas vienums Vienkāršs bīstamības saraksta grupas vienums Vienkāršs brīdinājumu saraksta grupas vienums Vienkāršs informācijas saraksta grupas vienums Vienkāršs gaismas saraksta grupas vienums Vienkāršs tumšā saraksta grupas vienums 
<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>
Nozīmes nodošana palīgtehnoloģijām

Krāsu izmantošana nozīmes pievienošanai nodrošina tikai vizuālu norādi, kas netiks nodota palīgtehnoloģiju lietotājiem, piemēram, ekrāna lasītājiem. Nodrošiniet, lai informācija, kas apzīmēta ar krāsu, būtu vai nu acīmredzama no paša satura (piemēram, redzamā teksta), vai arī tā ir iekļauta, izmantojot alternatīvus līdzekļus, piemēram, ar .sr-onlyklasi paslēptu papildu tekstu.

Ar nozīmītēm

Pievienojiet emblēmas jebkuram saraksta grupas vienumam, lai ar dažu utilītu palīdzību parādītu nelasīto skaitu, darbību un citu informāciju .

  • Saraksta vienums14
  • Otrs saraksta vienums2
  • Trešais saraksta elements1 
<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>

Pielāgots saturs

Pievienojiet gandrīz jebkuru HTML, pat tādām saistīto sarakstu grupām kā tālāk, izmantojot flexbox utilītas .

Saraksta grupas vienumu virsraksts
pirms 3 dienām

Daļa viettura satura rindkopā.

Un dažas sīkas drukas.
Saraksta grupas vienumu virsraksts
pirms 3 dienām

Daļa viettura satura rindkopā.

Un daži klusināti sīkie burti.
Saraksta grupas vienumu virsraksts
pirms 3 dienām

Daļa viettura satura rindkopā.

Un daži klusināti sīkie burti. 
<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 uzvedība

Izmantojiet cilnes JavaScript spraudni — iekļaujiet to atsevišķi vai izmantojot apkopoto bootstrap.jsfailu — lai paplašinātu mūsu sarakstu grupu un izveidotu vietējā satura cilnes rūtis.

Dažs viettura saturs rindkopā, kas attiecas uz "Sākums". Un vēl kāds saturs, kas šeit tiek izmantots, lai aizpildītu un aizpildītu šo cilnes paneli. Ražošanā jums šeit acīmredzot būtu vairāk reāla satura. Un ne tikai tekstu. Tas varētu būt jebkas, tiešām. Teksts, attēli, formas.

Some placeholder content in a paragraph relating to "Profile". And some more content, used here just to pad out and fill this tab panel. In production, you would obviously have more real content here. And not just text. It could be anything, really. Text, images, forms.

Some placeholder content in a paragraph relating to "Messages". And some more content, used here just to pad out and fill this tab panel. In production, you would obviously have more real content here. And not just text. It could be anything, really. Text, images, forms.

Some placeholder content in a paragraph relating to "Settings". And some more content, used here just to pad out and fill this tab panel. In production, you would obviously have more real content here. And not just text. It could be anything, really. Text, images, forms.

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

Izmantojot datu atribūtus

Varat aktivizēt sarakstu grupas navigāciju, nerakstot JavaScript, vienkārši norādot data-toggle="list"elementu vai uz tā. Izmantojiet šos datu atribūtus vietnē .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>

Izmantojot JavaScript

Iespējot cilnes saraksta vienumu, izmantojot JavaScript (katrs saraksta vienums ir jāaktivizē atsevišķi):

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

Atsevišķu saraksta vienumu var aktivizēt vairākos veidos:

$('#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

Izbalēšanas efekts

Lai ciļņu panelis izzustu, pievienojiet .fadekatram .tab-pane. Pirmajā cilnes rūtī ir arī .showjāpadara redzams sākotnējais saturs.

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

Metodes

$().tab

Aktivizē saraksta vienuma elementu un satura konteineru. Cilnē DOM ir jābūt vai nu konteinera mezglam, data-targetvai tā mērķauditorijas atlasei.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('show')

Atlasa doto saraksta vienumu un parāda ar to saistīto rūti. Jebkurš cits saraksta vienums, kas iepriekš tika atlasīts, tiek atcelts, un ar to saistītā rūts tiek paslēpta. Atgriežas pie zvanītāja, pirms cilnes rūts ir faktiski parādīta (piemēram, pirms shown.bs.tabnotikuma).

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

Pasākumi

Rādot jaunu cilni, notikumi tiek aktivizēti šādā secībā:

  1. hide.bs.tab(pašreizējā aktīvajā cilnē)
  2. show.bs.tab(cilnē, kas jāparāda)
  3. hidden.bs.tab(iepriekšējā aktīvajā cilnē tā pati, kas hide.bs.tabpasākumam)
  4. shown.bs.tab(jaunaktīvā tikko parādītajā cilnē tā pati, kas show.bs.tabnotikumam)

Ja neviena cilne jau nebija aktīva, hide.bs.tabun hidden.bs.tabnotikumi netiks aktivizēti.

Pasākuma veids Apraksts
show.bs.tab Šis notikums tiek aktivizēts cilnes rādīšanas laikā, bet pirms jaunās cilnes parādīšanas. Izmantojiet event.targetun event.relatedTarget, lai atlasītu attiecīgi aktīvo cilni un iepriekšējo aktīvo cilni (ja pieejama).
parādīts.bs.tab Šis notikums tiek aktivizēts cilnes rādīšanas laikā pēc cilnes parādīšanas. Izmantojiet event.targetun event.relatedTarget, lai atlasītu attiecīgi aktīvo cilni un iepriekšējo aktīvo cilni (ja pieejama).
hide.bs.tab Šis notikums tiek aktivizēts, kad ir jāparāda jauna cilne (un tādējādi iepriekšējā aktīvā cilne ir jāpaslēpta). Izmantojiet event.targetun event.relatedTarget, lai atlasītu attiecīgi pašreizējo aktīvo cilni un jauno cilni, kas drīzumā būs aktīva.
Hid.bs.tab Šis notikums tiek aktivizēts pēc jaunas cilnes parādīšanas (un līdz ar to iepriekšējā aktīvā cilne tiek paslēpta). Izmantojiet event.targetun event.relatedTarget, lai atlasītu attiecīgi iepriekšējo aktīvo cilni un jauno aktīvo cilni. 
$('a[data-toggle="list"]').on('shown.bs.tab', function (event) {
  event.target // newly activated tab
  event.relatedTarget // previous active tab
})