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.
- Cras justo odio
- Dapibus ac facilisis in
- Morbi leo risus
- Porta ac consectetur ac
- Vestibulums un eross
<ul class="list-group">
<li class="list-group-item">Cras justo odio</li>
<li class="list-group-item">Dapibus ac facilisis in</li>
<li class="list-group-item">Morbi leo risus</li>
<li class="list-group-item">Porta ac consectetur ac</li>
<li class="list-group-item">Vestibulum at eros</li>
</ul>
Aktīvie vienumi
Pievienot .active
a .list-group-item
, lai norādītu pašreizējo aktīvo atlasi.
- Cras justo odio
- Dapibus ac facilisis in
- Morbi leo risus
- Porta ac consectetur ac
- Vestibulums un eross
<ul class="list-group">
<li class="list-group-item active">Cras justo odio</li>
<li class="list-group-item">Dapibus ac facilisis in</li>
<li class="list-group-item">Morbi leo risus</li>
<li class="list-group-item">Porta ac consectetur ac</li>
<li class="list-group-item">Vestibulum at eros</li>
</ul>
Atspējotie priekšmeti
Pievienojiet .disabled
a .list-group-item
, lai tas izskatītos atspējots. Ņemiet vērā, ka dažiem elementiem ar .disabled
būs nepieciešams arī pielāgots JavaScript, lai pilnībā atspējotu klikšķu notikumus (piemēram, saites).
- Cras justo odio
- Dapibus ac facilisis in
- Morbi leo risus
- Porta ac consectetur ac
- Vestibulums un eross
<ul class="list-group">
<li class="list-group-item disabled" aria-disabled="true">Cras justo odio</li>
<li class="list-group-item">Dapibus ac facilisis in</li>
<li class="list-group-item">Morbi leo risus</li>
<li class="list-group-item">Porta ac consectetur ac</li>
<li class="list-group-item">Vestibulum at eros</li>
</ul>
Saites un pogas
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 .btn
klases šeit .
<div class="list-group">
<a href="#" class="list-group-item list-group-item-action active">
Cras justo odio
</a>
<a href="#" class="list-group-item list-group-item-action">Dapibus ac facilisis in</a>
<a href="#" class="list-group-item list-group-item-action">Morbi leo risus</a>
<a href="#" class="list-group-item list-group-item-action">Porta ac consectetur ac</a>
<a href="#" class="list-group-item list-group-item-action disabled" tabindex="-1" aria-disabled="true">Vestibulum at eros</a>
</div>
Izmantojot s, klases vietā <button>
varat izmantot arī disabled
atribūtu . .disabled
Diemžēl <a>
s neatbalsta atspējoto atribūtu.
<div class="list-group">
<button type="button" class="list-group-item list-group-item-action active">
Cras justo odio
</button>
<button type="button" class="list-group-item list-group-item-action">Dapibus ac facilisis in</button>
<button type="button" class="list-group-item list-group-item-action">Morbi leo risus</button>
<button type="button" class="list-group-item list-group-item-action">Porta ac consectetur ac</button>
<button type="button" class="list-group-item list-group-item-action" disabled>Vestibulum at eros</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).
- Cras justo odio
- Dapibus ac facilisis in
- Morbi leo risus
- Porta ac consectetur ac
- Vestibulums un eross
<ul class="list-group list-group-flush">
<li class="list-group-item">Cras justo odio</li>
<li class="list-group-item">Dapibus ac facilisis in</li>
<li class="list-group-item">Morbi leo risus</li>
<li class="list-group-item">Porta ac consectetur ac</li>
<li class="list-group-item">Vestibulum at eros</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-fill
katram saraksta grupas vienumam.
- Cras justo odio
- Dapibus ac facilisis in
- Morbi leo risus
<ul class="list-group list-group-horizontal">
<li class="list-group-item">Cras justo odio</li>
<li class="list-group-item">Dapibus ac facilisis in</li>
<li class="list-group-item">Morbi leo risus</li>
</ul>
- Cras justo odio
- Dapibus ac facilisis in
- Morbi leo risus
<ul class="list-group list-group-horizontal-sm">
<li class="list-group-item">Cras justo odio</li>
<li class="list-group-item">Dapibus ac facilisis in</li>
<li class="list-group-item">Morbi leo risus</li>
</ul>
- Cras justo odio
- Dapibus ac facilisis in
- Morbi leo risus
<ul class="list-group list-group-horizontal-md">
<li class="list-group-item">Cras justo odio</li>
<li class="list-group-item">Dapibus ac facilisis in</li>
<li class="list-group-item">Morbi leo risus</li>
</ul>
- Cras justo odio
- Dapibus ac facilisis in
- Morbi leo risus
<ul class="list-group list-group-horizontal-lg">
<li class="list-group-item">Cras justo odio</li>
<li class="list-group-item">Dapibus ac facilisis in</li>
<li class="list-group-item">Morbi leo risus</li>
</ul>
- Cras justo odio
- Dapibus ac facilisis in
- Morbi leo risus
<ul class="list-group list-group-horizontal-xl">
<li class="list-group-item">Cras justo odio</li>
<li class="list-group-item">Dapibus ac facilisis in</li>
<li class="list-group-item">Morbi leo risus</li>
</ul>
Kontekstuālās klases
Izmantojiet kontekstuālās klases, lai veidotu saraksta vienumus ar statusu un krāsu.
- Dapibus ac facilisis in
- 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">Dapibus ac facilisis in</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ī .active
valsts; lietot to, lai norādītu aktīvo atlasi kontekstuālā saraksta grupas vienumā.
<div class="list-group">
<a href="#" class="list-group-item list-group-item-action">Dapibus ac facilisis in</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-only
klasi 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 .
- Cras justo odio14
- Dapibus ac facilisis in2
- Morbi leo risus1
<ul class="list-group">
<li class="list-group-item d-flex justify-content-between align-items-center">
Cras justo odio
<span class="badge badge-primary badge-pill">14</span>
</li>
<li class="list-group-item d-flex justify-content-between align-items-center">
Dapibus ac facilisis in
<span class="badge badge-primary badge-pill">2</span>
</li>
<li class="list-group-item d-flex justify-content-between align-items-center">
Morbi leo risus
<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āmDonec id elit non mi porta gravida un eget metus. Maecenas sed diam eget risus varius blandit.
Donec id elit non mi porta.Saraksta grupas vienumu virsraksts
pirms 3 dienāmDonec id elit non mi porta gravida un eget metus. Maecenas sed diam eget risus varius blandit.
Donec id elit non mi porta.Saraksta grupas vienumu virsraksts
pirms 3 dienāmDonec id elit non mi porta gravida un eget metus. Maecenas sed diam eget risus varius blandit.
Donec id elit non mi porta.<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">Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.</p>
<small>Donec id elit non mi porta.</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">Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.</p>
<small class="text-muted">Donec id elit non mi porta.</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">Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.</p>
<small class="text-muted">Donec id elit non mi porta.</small>
</a>
</div>
JavaScript uzvedība
Izmantojiet cilnes JavaScript spraudni — iekļaujiet to atsevišķi vai izmantojot apkopoto bootstrap.js
failu — lai paplašinātu mūsu sarakstu grupu un izveidotu vietējā satura cilnes rūtis.
<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
.
<!-- 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>
Izmantojot JavaScript
Iespējot cilnes saraksta vienumu, izmantojot JavaScript (katrs saraksta vienums ir jāaktivizē atsevišķi):
$('#myList a').on('click', function (e) {
e.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 .fade
katram .tab-pane
. Arī pirmajā cilnes rūtī .show
sākotnējais saturs ir jāpadara redzams.
<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-target
vai 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.tab
notikuma).
$('#someListItem').tab('show')
Pasākumi
Rādot jaunu cilni, notikumi tiek aktivizēti šādā secībā:
hide.bs.tab
(pašreizējā aktīvajā cilnē)show.bs.tab
(cilnē, kas jāparāda)hidden.bs.tab
(iepriekšējā aktīvajā cilnē tā pati, kashide.bs.tab
pasākumam)shown.bs.tab
(jaunaktīvā tikko parādītajā cilnē tā pati, kasshow.bs.tab
notikumam)
Ja neviena cilne jau nebija aktīva, hide.bs.tab
un hidden.bs.tab
notikumi 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.target un 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.target un 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.target un 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.target un 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 (e) {
e.target // newly activated tab
e.relatedTarget // previous active tab
})