Nimekirja rühm
Loendirühmad on paindlik ja võimas komponent sisusarja kuvamiseks. Muutke ja laiendage neid, et toetada peaaegu mis tahes sisu.
Põhiline näide
Kõige elementaarsem loendirühm on järjestamata loend loendiüksuste ja õigete klassidega. Kasutage seda järgmiste valikute või vajaduse korral oma CSS-i abil.
- Asi
- Teine ese
- Kolmas ese
- Neljas ese
- Ja viies
<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>
Aktiivsed üksused
Lisa .active
a .list-group-item
-sse, et näidata praegust aktiivset valikut.
- Aktiivne üksus
- Teine ese
- Kolmas ese
- Neljas ese
- Ja viies
<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>
Keelatud üksused
Lisage .disabled
a .list-group-item
-sse, et see näiks keelatud. Pange tähele, et mõned elemendid, millel .disabled
on klõpsamissündmused (nt lingid), nõuavad ka kohandatud JavaScripti.
- Keelatud üksus
- Teine ese
- Kolmas ese
- Neljas ese
- Ja viies
<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>
Lingid ja nupud
Kasutage nuppe <a>
s või <button>
s, et luua toimivad loendirühma elemendid, millel on hõljutus, keelatud ja aktiivne olek, lisades .list-group-item-action
. Eraldame need pseudoklassid tagamaks, et mitteinteraktiivsetest elementidest (nt <li>
s või <div>
s) koostatud loendirühmad ei pakuks klõpsu või puudutuse tasuvust.
Kindlasti ära kasuta .btn
siin standardklasse .
<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- ga saate klassi asemel <button>
kasutada ka atribuuti. Kahjuks ei toeta see keelatud atribuuti.disabled
.disabled
<a>
<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>
Loputage
Lisa .list-group-flush
, et eemaldada mõned äärised ja ümarad nurgad, et renderdada loendirühma üksused emakonteineris (nt kaardid) servast servani.
- Asi
- Teine ese
- Kolmas ese
- Neljas ese
- Ja viies
<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>
Horisontaalne
Lisa .list-group-horizontal
, et muuta loendirühma üksuste paigutust vertikaalselt horisontaalseks kõigis katkestuspunktides. Teise võimalusena valige kohanemisvõimeline variant .list-group-horizontal-{sm|md|lg|xl}
, et muuta loendirühm horisontaalseks, alustades sellest katkestuspunktist min-width
. Praegu ei saa horisontaalseid loendirühmi kombineerida loputusloendi rühmadega.
ProTip. Kas soovite horisontaalselt võrdse laiusega loendiüksuseid? Lisage .flex-fill
igasse loendirühma üksus.
- Asi
- Teine ese
- Kolmas ese
- Asi
- Teine ese
- Kolmas ese
- Asi
- Teine ese
- Kolmas ese
- Asi
- Teine ese
- Kolmas ese
- Asi
- Teine ese
- Kolmas ese
<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>
Kontekstuaalsed klassid
Kasutage kontekstuaalseid klasse, et kujundada olekupõhise tausta ja värviga loendiüksused.
- Lihtne loendirühma vaikeüksus
- Lihtne esmase loendi rühma üksus
- Lihtne teisese loendi rühma üksus
- Lihtne eduloendi rühma üksus
- Lihtne ohunimekirja rühma üksus
- Lihtne hoiatusloendi rühma üksus
- Lihtne teabeloendi rühma üksus
- Lihtne kerge loendi rühma üksus
- Lihtne tumeda nimekirja rühma üksus
<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>
Kontekstuaalsed klassid töötavad ka .list-group-item-action
. Pange tähele hõljutusstiilide lisamist, mida eelmises näites ei esinenud. Toetatud on ka .active
riik; rakendab seda kontekstuaalse loendirühma üksuse aktiivse valiku tähistamiseks.
<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>
Abitehnoloogiate tähenduse edasiandmine
Värvi kasutamine tähenduse lisamiseks annab ainult visuaalse viite, mida ei edastata abitehnoloogiate (nt ekraanilugejate) kasutajatele. .sr-only
Veenduge, et värviga tähistatud teave oleks kas sisust endast ilmne (nt nähtav tekst) või kaasatud alternatiivsete vahenditega, näiteks klassiga peidetud lisatekst .
Märkidega
Lisage märgid mis tahes loendirühma üksustele, et kuvada mõne utiliiti abil lugemata arv, tegevusi ja muud .
- Loendi üksus14
- Teine loendi element2
- Kolmas loendi element1
<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>
Kohandatud sisu
Lisage flexboxi utiliitide abil peaaegu kõik HTML-id, isegi lingitud loendirühmade jaoks, nagu allolev .
Loendi rühma üksuse pealkiri
3 päeva tagasiMõni kohatäite sisu lõigus.
Ja väikeses kirjas.Loendi rühma üksuse pealkiri
3 päeva tagasiMõni kohatäite sisu lõigus.
Ja natuke vaigistatud väikeses kirjas.Loendi rühma üksuse pealkiri
3 päeva tagasiMõni kohatäite sisu lõigus.
Ja natuke vaigistatud väikeses kirjas.<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>
JavaScripti käitumine
Kasutage vahekaardi JavaScripti pistikprogrammi – lisage see eraldi või kompileeritud bootstrap.js
faili kaudu – meie loendirühma laiendamiseks, et luua kohaliku sisu vahekaartide paanid.
<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>
Andmeatribuutide kasutamine
Saate aktiveerida loendirühma navigeerimise ilma JavaScripti kirjutamata, lihtsalt määrates data-toggle="list"
või elemendi peal. Kasutage neid andmeatribuute saidil .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>
JavaScripti kaudu
Luba vahekaartide loendi üksus JavaScripti kaudu (iga loendiüksus tuleb eraldi aktiveerida):
$('#myList a').on('click', function (event) {
event.preventDefault()
$(this).tab('show')
})
Üksiku loendiüksuse saate aktiveerida mitmel viisil.
$('#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 efekt
Vahelehtede paneeli tuhmumiseks lisage .fade
igale .tab-pane
. Esimene vahelehepaan peab ka .show
esialgse sisu nähtavaks tegema.
<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>
meetodid
$().tab
Aktiveerib loendiüksuse elemendi ja sisu konteineri. Vahekaardil peaks olema DOM-is kas konteineri sõlm data-target
või sihtimispunkt.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')
Valib antud loendiüksuse ja näitab sellega seotud paani. Kõik muud varem valitud loendiüksused tühistatakse ja nendega seotud paan peidetakse. Naaseb helistaja juurde enne vahekaardipaani tegelikku kuvamist (näiteks enne shown.bs.tab
sündmuse toimumist).
$('#someListItem').tab('show')
Sündmused
Uue vahelehe kuvamisel käivituvad sündmused järgmises järjekorras.
hide.bs.tab
(praegusel aktiivsel vahekaardil)show.bs.tab
(näitataval vahekaardil)hidden.bs.tab
(eelmisel aktiivsel vahekaardil sama, mishide.bs.tab
sündmuse puhul)shown.bs.tab
(äsja aktiivsel just kuvatud vahekaardil sama, misshow.bs.tab
sündmuse puhul)
Kui ükski vahekaart ei olnud juba aktiivne, siis sündmusi hide.bs.tab
ja hidden.bs.tab
ei käivitata.
Sündmuse tüüp | Kirjeldus |
---|---|
show.bs.tab | See sündmus käivitub vahekaardi kuvamisel, kuid enne uue vahekaardi kuvamist. Kasutage event.target ja event.relatedTarget , et sihtida vastavalt aktiivset vahekaarti ja eelmist aktiivset vahekaarti (kui see on saadaval). |
näidatud.bs.tab | See sündmus käivitub vahekaardi kuvamisel pärast vahekaardi kuvamist. Kasutage event.target ja event.relatedTarget , et sihtida vastavalt aktiivset vahekaarti ja eelmist aktiivset vahekaarti (kui see on saadaval). |
hide.bs.tab | See sündmus käivitub, kui kuvatakse uus vahekaart (ja seega eelmine aktiivne vahekaart peidetakse). Kasutage event.target ja event.relatedTarget , et sihtida vastavalt praegust aktiivset vahekaarti ja uut peagi aktiivset vahekaarti. |
peidetud.bs.tab | See sündmus käivitub pärast uue vahekaardi kuvamist (ja seega on eelmine aktiivne vahekaart peidetud). Kasutage event.target ja event.relatedTarget , et sihtida vastavalt eelmist aktiivset vahekaarti ja uut aktiivset vahekaarti. |
$('a[data-toggle="list"]').on('shown.bs.tab', function (event) {
event.target // newly activated tab
event.relatedTarget // previous active tab
})