Zoznam skupiny
Skupiny zoznamov sú flexibilným a výkonným komponentom na zobrazenie série obsahu. Upravte a rozšírte ich tak, aby podporovali takmer akýkoľvek obsah.
Základný príklad
Najzákladnejšou skupinou zoznamov je neusporiadaný zoznam s položkami zoznamu a príslušnými triedami. Stavte na to pomocou nasledujúcich možností alebo podľa potreby pomocou vlastného CSS.
- Vec
- Druhá položka
- Tretia položka
- Štvrtá položka
- A piaty
<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ívne položky
Pridať .active
do a .list-group-item
na označenie aktuálneho aktívneho výberu.
- Aktívna položka
- Druhá položka
- Tretia položka
- Štvrtá položka
- A piaty
<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>
Zakázané položky
Pridajte .disabled
do a .list-group-item
, aby sa javil ako zakázaný. Všimnite si, že niektoré prvky s .disabled
budú tiež vyžadovať vlastný JavaScript, aby sa úplne zakázali ich udalosti kliknutia (napr. odkazy).
- Deaktivovaná položka
- Druhá položka
- Tretia položka
- Štvrtá položka
- A piaty
<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>
Odkazy a tlačidlá
Pomocou <a>
s alebo <button>
s vytvorte akcieschopné položky skupiny zoznamu so stavom kurzora, vypnutým a aktívnym stavom pridaním .list-group-item-action
. Tieto pseudotriedy oddeľujeme, aby sme zaistili, že skupiny zoznamov zložené z neinteraktívnych prvkov (ako <li>
s alebo <div>
s) nebudú poskytovať možnosť kliknutia alebo klepnutia.
Uistite sa , že tu nepoužívate štandardné .btn
triedy .
<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>
Pomocou <button>
s môžete disabled
namiesto .disabled
triedy použiť aj atribút. Bohužiaľ, <a>
s nepodporujú atribút vypnuté.
<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>
Spláchnuť
Pridať .list-group-flush
na odstránenie niektorých okrajov a zaoblených rohov na vykreslenie položiek skupiny zoznamu od okraja po okraj v nadradenom kontajneri (napr. karty).
- Vec
- Druhá položka
- Tretia položka
- Štvrtá položka
- A piaty
<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álne
Pridať .list-group-horizontal
, ak chcete zmeniť rozloženie položiek skupiny zoznamu z vertikálneho na horizontálne cez všetky body prerušenia. Prípadne vyberte responzívny variant .list-group-horizontal-{sm|md|lg|xl}
, aby bola skupina zoznamov horizontálna začínajúca na bode prerušenia min-width
. V súčasnosti sa skupiny horizontálnych zoznamov nedajú kombinovať so skupinami zarovnaných zoznamov.
ProTip: Chcete položky skupiny zoznamu rovnakej šírky, keď sú horizontálne? Pridať .flex-fill
do každej položky skupiny zoznamu.
- Vec
- Druhá položka
- Tretia položka
- Vec
- Druhá položka
- Tretia položka
- Vec
- Druhá položka
- Tretia položka
- Vec
- Druhá položka
- Tretia položka
- Vec
- Druhá položka
- Tretia položka
<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>
Kontextové triedy
Použite kontextové triedy na štýlovanie položiek zoznamu so stavovým pozadím a farbou.
- Jednoduchá predvolená položka skupiny zoznamu
- Jednoduchá primárna položka skupiny zoznamu
- Jednoduchá sekundárna položka skupiny zoznamu
- Jednoduchý zoznam úspešných položiek skupiny
- Jednoduchá položka skupiny zoznamu nebezpečenstiev
- Jednoduchá položka skupiny varovania
- Jednoduchá položka skupiny informačného zoznamu
- Jednoduchý zoznam položiek skupiny
- Jednoduchá položka skupiny tmavého zoznamu
<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>
Kontextové triedy pracujú aj s .list-group-item-action
. Všimnite si pridanie štýlov vznášania, ktoré sa nenachádzajú v predchádzajúcom príklade. Podporovaný je aj .active
štát; použiť ho na označenie aktívneho výberu na položke kontextovej skupiny zoznamu.
<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>
Odovzdanie významu asistenčným technológiám
Použitie farby na pridanie významu poskytuje iba vizuálnu indikáciu, ktorá nebude poskytnutá používateľom asistenčných technológií – ako sú čítačky obrazovky. Uistite sa, že informácia označená farbou je buď zrejmá zo samotného obsahu (napr. viditeľný text), alebo je zahrnutá alternatívnymi prostriedkami, ako je dodatočný text skrytý spolu s .sr-only
triedou.
S odznakmi
Pridajte odznaky do ľubovoľnej položky skupiny zoznamu, aby ste pomocou niektorých pomôcok zobrazovali neprečítané počty, aktivitu a ďalšie .
- Položka zoznamu14
- Druhá položka zoznamu2
- Tretia položka zoznamu1
<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>
Vlastný obsah
Pridajte takmer akýkoľvek kód HTML, dokonca aj pre skupiny prepojených zoznamov, ako je tá nižšie, pomocou nástrojov flexbox .
Záhlavie položky skupiny zoznamu
Pred 3 dňamiNejaký zástupný obsah v odseku.
A nejaké drobné písmo.Záhlavie položky skupiny zoznamu
Pred 3 dňamiNejaký zástupný obsah v odseku.
A nejaké tlmené malé písmo.Záhlavie položky skupiny zoznamu
Pred 3 dňamiNejaký zástupný obsah v odseku.
A nejaké tlmené malé písmo.<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>
Správanie JavaScriptu
Použite zásuvný modul JavaScript na karte – zahrňte ho jednotlivo alebo prostredníctvom skompilovaného bootstrap.js
súboru – na rozšírenie našej skupiny zoznamov na vytváranie tabel miestneho obsahu.
<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>
Používanie atribútov údajov
Navigáciu skupiny zoznamov môžete aktivovať bez písania akéhokoľvek JavaScriptu jednoduchým zadaním data-toggle="list"
alebo na prvku. Použite tieto atribúty údajov 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>
Cez JavaScript
Povoliť položku zoznamu s tabuľkami cez JavaScript (každá položka zoznamu musí byť aktivovaná samostatne):
$('#myList a').on('click', function (event) {
event.preventDefault()
$(this).tab('show')
})
Jednotlivé položky zoznamu môžete aktivovať niekoľkými spôsobmi:
$('#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
Efekt vyblednutia
Ak chcete, aby panel kariet vybledol, pridajte .fade
ku každému .tab-pane
. Prvá tabla karty musí tiež .show
zviditeľniť počiatočný obsah.
<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>
Metódy
$().tab
Aktivuje prvok položky zoznamu a kontajner obsahu. Karta by mala mať buď a data-target
alebo href
zacielenie na kontajnerový uzol 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('show')
Vyberie danú položku zoznamu a zobrazí príslušný panel. Akákoľvek iná položka zoznamu, ktorá bola predtým vybratá, sa zruší a jej priradená tabla sa skryje. Vráti sa k volajúcemu skôr, ako sa tabla kariet skutočne zobrazí (napríklad pred shown.bs.tab
výskytom udalosti).
$('#someListItem').tab('show')
Diania
Pri zobrazení novej karty sa udalosti spúšťajú v nasledujúcom poradí:
hide.bs.tab
(na aktuálnej aktívnej karte)show.bs.tab
(na karte, ktorá sa má zobraziť)hidden.bs.tab
(na predchádzajúcej aktívnej karte, rovnaká ako prihide.bs.tab
udalosti)shown.bs.tab
(na novo aktívnej práve zobrazenej karte, rovnakej ako prishow.bs.tab
udalosti)
Ak ešte nebola aktívna žiadna karta, udalosti hide.bs.tab
a hidden.bs.tab
sa nespustia.
Typ udalosti | Popis |
---|---|
zobraziť.bs.tab | Táto udalosť sa spustí pri zobrazení kariet, ale predtým, než sa zobrazí nová karta. Pomocou event.target a event.relatedTarget zacielite na aktívnu kartu a predchádzajúcu aktívnu kartu (ak je k dispozícii). |
zobrazené.bs.tab | Táto udalosť sa spustí pri zobrazení karty po zobrazení karty. Pomocou event.target a event.relatedTarget zacielite na aktívnu kartu a predchádzajúcu aktívnu kartu (ak je k dispozícii). |
skryť.bs.tab | Táto udalosť sa spustí, keď sa má zobraziť nová karta (a teda predchádzajúca aktívna karta má byť skrytá). Pomocou event.target a event.relatedTarget zacielite na aktuálnu aktívnu kartu a novú kartu, ktorá bude čoskoro aktívna. |
skryté.bs.tab | Táto udalosť sa spustí po zobrazení novej karty (a teda predchádzajúca aktívna karta je skrytá). Pomocou event.target a event.relatedTarget zacielite na predchádzajúcu aktívnu kartu a na novú aktívnu kartu. |
$('a[data-toggle="list"]').on('shown.bs.tab', function (event) {
event.target // newly activated tab
event.relatedTarget // previous active tab
})