in English

Seznam skupine

Skupine seznamov so prilagodljiva in zmogljiva komponenta za prikaz niza vsebin. Spremenite in razširite jih tako, da podpirajo skoraj vsako vsebino znotraj.

Osnovni primer

Najosnovnejša skupina seznamov je neurejen seznam s postavkami seznama in ustreznimi razredi. Nadgradite ga z možnostmi, ki sledijo, ali po potrebi s svojim lastnim CSS.

  • Stvar
  • Drugi predmet
  • Tretji predmet
  • Četrta postavka
  • In še peti
<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>

Aktivni predmeti

Dodajte .activek a .list-group-item, da označite trenutno aktivno izbiro.

  • Aktiven predmet
  • Drugi predmet
  • Tretji predmet
  • Četrta postavka
  • In še peti
<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>

Onemogočeni predmeti

Dodajte .disabledv a .list-group-item, da bo videti onemogočeno. Upoštevajte, da .disabledbodo nekateri elementi z zahtevali tudi JavaScript po meri, da v celoti onemogočijo dogodke klikov (npr. povezave).

  • Onemogočen element
  • Drugi predmet
  • Tretji predmet
  • Četrta postavka
  • In še peti
<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>

Uporabite <a>s ali <button>s za ustvarjanje uporabnih elementov skupine seznamov z lebdenjem, onemogočenim in aktivnim stanjem, tako da dodate .list-group-item-action. Te psevdorazrede ločimo, da zagotovimo, da skupine seznamov, sestavljene iz neinteraktivnih elementov (kot <li>je s ali <div>s), ne nudijo možnosti klika ali dotika.

Pazite, da tukaj ne uporabljate standardnih .btnrazredov .

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

Z <button>s lahko uporabite tudi disabledatribut namesto .disabledrazreda. Na žalost <a>s ne podpira atributa disabled.

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

Izperite

Dodajte .list-group-flush, če želite odstraniti nekatere obrobe in zaobljene vogale za upodabljanje elementov skupine seznama od roba do roba v nadrejenem vsebniku (npr. kartice).

  • Stvar
  • Drugi predmet
  • Tretji predmet
  • Četrta postavka
  • In še peti
<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>

Vodoravno

Dodaj .list-group-horizontal, če želite spremeniti postavitev elementov skupine seznamov iz navpične v vodoravno na vseh prelomnih točkah. Druga možnost je, da izberete odzivno različico .list-group-horizontal-{sm|md|lg|xl}, da bo skupina seznamov vodoravna, začenši na tej prelomni točki min-width. Skupin horizontalnih seznamov trenutno ni mogoče kombinirati s skupinami seznamov za izpiranje.

Strokovni nasvet: želite enako široke elemente skupine seznamov, ko so vodoravni? Dodajte .flex-fillvsakemu elementu skupine seznama.

  • Stvar
  • Drugi predmet
  • Tretji predmet
  • Stvar
  • Drugi predmet
  • Tretji predmet
  • Stvar
  • Drugi predmet
  • Tretji predmet
  • Stvar
  • Drugi predmet
  • Tretji predmet
  • Stvar
  • Drugi predmet
  • Tretji predmet
<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>

Kontekstualni razredi

Uporabite kontekstualne razrede za oblikovanje elementov seznama z ozadjem in barvo, ki spremlja stanje.

  • Preprost privzeti element skupine seznama
  • Preprost element primarne skupine seznama
  • Preprost sekundarni element skupine seznama
  • Enostaven element skupine na seznamu uspehov
  • Preprost element skupine nevarnosti
  • Enostaven element skupine opozorilnih seznamov
  • Enostaven element skupine informacijskega seznama
  • Enostaven lahek seznam skupine elementov
  • Preprost element skupine temnega seznama
<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>

Kontekstualni razredi delujejo tudi z .list-group-item-action. Upoštevajte dodatek slogov lebdenja, ki tukaj niso prisotni v prejšnjem primeru. Podprta je tudi .activedržava; uporabite za označevanje aktivnega izbora na elementu kontekstualne skupine seznama.

<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>
Prenos pomena za podporne tehnologije

Uporaba barve za dodajanje pomena zagotavlja le vizualno indikacijo, ki ne bo posredovana uporabnikom podpornih tehnologij – kot so bralniki zaslona. Zagotovite, da so informacije, označene z barvo, očitne iz same vsebine (npr. vidno besedilo) ali pa so vključene z alternativnimi sredstvi, kot je dodatno besedilo, skrito z .sr-onlyrazredom.

Z značkami

Dodajte značke kateremu koli elementu skupine na seznamu, da prikažete število neprebranih, dejavnost in drugo s pomočjo nekaterih pripomočkov .

  • Element seznama14
  • Drugi element seznama2
  • Tretji element seznama1
<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>

Vsebina po meri

Dodajte skoraj kateri koli HTML znotraj, tudi za skupine povezanih seznamov, kot je ta spodaj, s pomočjo pripomočkov 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>

obnašanje JavaScripta

Uporabite vtičnik JavaScript za zavihke – vključite ga posamično ali prek prevedene bootstrap.jsdatoteke – da razširite našo skupino seznamov in ustvarite podokna z zavihki lokalne vsebine.

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

Uporaba podatkovnih atributov

Navigacijo po skupinah seznamov lahko aktivirate brez pisanja JavaScripta tako, da preprosto določite data-toggle="list"ali na elementu. Uporabite te atribute podatkov na .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>

Prek JavaScripta

Omogoči element seznama, ki ga je mogoče zavihkati, prek JavaScripta (vsak element seznama je treba aktivirati posebej):

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

Posamezen element seznama lahko aktivirate na več načinov:

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

Učinek bledenja

.fadeČe želite, da podokno z zavihki zbledi, vsakemu dodajte .tab-pane. V prvem podoknu z zavihki mora biti .showvidna tudi začetna vsebina.

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

Metode

$().tab

Aktivira element elementa seznama in vsebnik vsebine. Zavihek mora imeti bodisi data-targetali hrefciljno usmerjen na vozlišče vsebnika v DOM.

<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('pokaži')

Izbere dani element seznama in prikaže povezano podokno. Kateri koli drug element seznama, ki je bil prej izbran, postane neizbran in njegovo povezano podokno je skrito. Vrne se klicatelju, preden je podokno z zavihki dejansko prikazano (na primer, preden shown.bs.tabpride do dogodka).

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

Dogodki

Pri prikazu novega zavihka se dogodki sprožijo v naslednjem vrstnem redu:

  1. hide.bs.tab(na trenutno aktivnem zavihku)
  2. show.bs.tab(na zavihku za prikaz)
  3. hidden.bs.tab(na prejšnjem aktivnem zavihku, enak kot za hide.bs.tabdogodek)
  4. shown.bs.tab(na novoaktivnem pravkar prikazanem zavihku, isti kot za show.bs.tabdogodek)

Če noben zavihek še ni bil aktiven, se dogodki hide.bs.tabin hidden.bs.tabne bodo sprožili.

Vrsta dogodka Opis
show.bs.tab Ta dogodek se sproži ob prikazu zavihka, vendar preden je prikazan nov zavihek. Uporabite event.targetin event.relatedTargetza ciljanje na aktivni zavihek oziroma prejšnji aktivni zavihek (če je na voljo).
prikazano.bs.tab Ta dogodek se sproži na prikazu zavihkov po prikazu zavihka. Uporabite event.targetin event.relatedTargetza ciljanje na aktivni zavihek oziroma prejšnji aktivni zavihek (če je na voljo).
hide.bs.tab Ta dogodek se sproži, ko je treba prikazati nov zavihek (in tako naj bi bil prejšnji aktivni zavihek skrit). Uporabite event.targetin event.relatedTargetza ciljanje na trenutni aktivni zavihek oziroma novi zavihek, ki bo kmalu aktiven.
skriti.bs.tab Ta dogodek se sproži, ko je prikazan nov zavihek (in tako je prejšnji aktivni zavihek skrit). Uporabite event.targetin event.relatedTargetza ciljanje prejšnjega aktivnega zavihka oziroma novega aktivnega zavihka.
$('a[data-toggle="list"]').on('shown.bs.tab', function (event) {
  event.target // newly activated tab
  event.relatedTarget // previous active tab
})