Lijst groep
Lijstgroepen zijn een flexibel en krachtig onderdeel voor het weergeven van een reeks inhoud. Pas ze aan en breid ze uit om zo ongeveer alle inhoud te ondersteunen.
Basis voorbeeld
De meest elementaire lijstgroep is een ongeordende lijst met lijstitems en de juiste klassen. Bouw erop voort met de opties die volgen, of met uw eigen CSS indien nodig.
- Een item
- Een tweede item
- Een derde item
- Een vierde item
- En een vijfde
<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>
Actieve items
Toevoegen .active
aan a .list-group-item
om de huidige actieve selectie aan te geven.
- Een actief item
- Een tweede item
- Een derde item
- Een vierde item
- En een vijfde
<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>
Uitgeschakelde items
Toevoegen .disabled
aan a .list-group-item
om het uitgeschakeld te laten lijken . Merk op dat sommige elementen met .disabled
ook aangepast JavaScript nodig hebben om hun klikgebeurtenissen (bijv. links) volledig uit te schakelen.
- Een uitgeschakeld item
- Een tweede item
- Een derde item
- Een vierde item
- En een vijfde
<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>
Links en knoppen
Gebruik <a>
s of <button>
s om bruikbare lijstgroepsitems te maken met zwevende, uitgeschakelde en actieve statussen door toe te voegen .list-group-item-action
. We scheiden deze pseudo-klassen om ervoor te zorgen dat lijstgroepen die zijn gemaakt van niet-interactieve elementen (zoals <li>
s of <div>
s) geen klik- of tikprijs bieden.
Zorg ervoor dat u hier niet de standaardklassen .btn
gebruikt .
<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>
Met <button>
s kun je ook gebruik maken van het disabled
attribuut in plaats van de .disabled
klasse. Helaas <a>
ondersteunen s het kenmerk uitgeschakeld niet.
<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>
doorspoelen
Toevoegen .list-group-flush
om enkele randen en afgeronde hoeken te verwijderen om lijstgroepitems van rand tot rand in een bovenliggende container weer te geven (bijv. kaarten).
- Een item
- Een tweede item
- Een derde item
- Een vierde item
- En een vijfde
<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>
Horizontaal
Toevoegen .list-group-horizontal
om de lay-out van lijstgroepitems te wijzigen van verticaal naar horizontaal voor alle onderbrekingspunten. U kunt ook een responsieve variant kiezen .list-group-horizontal-{sm|md|lg|xl}
om een lijstgroep horizontaal te maken vanaf het breekpunt van dat breekpunt min-width
. Momenteel kunnen horizontale lijstgroepen niet worden gecombineerd met doorspoellijstgroepen.
ProTip: Wilt u lijstgroepitems van gelijke breedte als ze horizontaal zijn? Voeg toe .flex-fill
aan elk lijstgroepsitem.
- Een item
- Een tweede item
- Een derde item
- Een item
- Een tweede item
- Een derde item
- Een item
- Een tweede item
- Een derde item
- Een item
- Een tweede item
- Een derde item
- Een item
- Een tweede item
- Een derde item
<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>
Contextuele lessen
Gebruik contextuele klassen om lijstitems op te maken met een stateful achtergrond en kleur.
- Een eenvoudig standaardlijstgroepsitem
- Een eenvoudig primair lijstgroepsitem
- Een eenvoudig secundair lijstgroepsitem
- Een eenvoudig groepsitem van de succeslijst
- Een eenvoudig groepsitem op de gevarenlijst
- Een eenvoudig groepsitem op de waarschuwingslijst
- Een eenvoudig groepsitem in de infolijst
- Een eenvoudig groepsitem voor de lichtlijst
- Een eenvoudig groepsitem op een donkere lijst
<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>
Contextuele lessen werken ook met .list-group-item-action
. Let op de toevoeging van de zweefstijlen die hier niet aanwezig waren in het vorige voorbeeld. Ook ondersteund wordt de .active
staat; pas het toe om een actieve selectie op een contextueel lijstgroepsitem aan te geven.
<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>
Betekenis overbrengen aan ondersteunende technologieën
Het gebruik van kleur om betekenis toe te voegen geeft alleen een visuele indicatie, die niet wordt overgebracht aan gebruikers van ondersteunende technologieën, zoals schermlezers. Zorg ervoor dat informatie die wordt aangegeven met de kleur ofwel duidelijk is uit de inhoud zelf (bijv. de zichtbare tekst), of op alternatieve manieren wordt opgenomen, zoals extra tekst die verborgen is bij de .sr-only
klasse.
Met insignes
Voeg badges toe aan elk lijstgroepitem om ongelezen tellingen, activiteit en meer te tonen met behulp van enkele hulpprogramma's .
- Een lijstitem14
- Een tweede lijstitem2
- Een derde lijstitem1
<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>
Aangepaste inhoud
Voeg bijna elke HTML toe, zelfs voor gekoppelde lijstgroepen zoals die hieronder, met behulp van flexbox-hulpprogramma's .
Kop van groepsitem weergeven
3 dagen geledenSommige tijdelijke inhoud in een alinea.
En wat kleine lettertjes.Kop van groepsitem weergeven
3 dagen geledenSommige tijdelijke inhoud in een alinea.
En wat gedempte kleine lettertjes.Kop van groepsitem weergeven
3 dagen geledenSommige tijdelijke inhoud in een alinea.
En wat gedempte kleine lettertjes.<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-gedrag
Gebruik de JavaScript-plug-in voor tabbladen - neem deze afzonderlijk of via het gecompileerde bootstrap.js
bestand op - om onze lijstgroep uit te breiden om tabbare vensters met lokale inhoud te maken.
<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>
Gegevenskenmerken gebruiken
U kunt een lijstgroepnavigatie activeren zonder JavaScript te schrijven door simpelweg data-toggle="list"
of op een element te specificeren. Gebruik deze gegevensattributen op .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>
Via JavaScript
Lijstitem met tabs inschakelen via JavaScript (elk lijstitem moet afzonderlijk worden geactiveerd):
$('#myList a').on('click', function (event) {
event.preventDefault()
$(this).tab('show')
})
U kunt afzonderlijke lijstitems op verschillende manieren activeren:
$('#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-effect
Als u het tabbladenpaneel wilt laten infaden, voegt u .fade
aan elk toe .tab-pane
. Het eerste tabblad moet ook .show
de initiële inhoud zichtbaar maken.
<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>
Methoden:
$().tab
Activeert een lijstitemelement en inhoudcontainer. Tab moet een data-target
of een href
gericht hebben op een containerknooppunt in de 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('toon')
Selecteert het opgegeven lijstitem en toont het bijbehorende venster. Elk ander lijstitem dat eerder was geselecteerd, wordt gedeselecteerd en het bijbehorende paneel wordt verborgen. Keert terug naar de beller voordat het tabblad daadwerkelijk is weergegeven (bijvoorbeeld voordat de shown.bs.tab
gebeurtenis plaatsvindt).
$('#someListItem').tab('show')
Evenementen
Wanneer een nieuw tabblad wordt weergegeven, worden de gebeurtenissen in de volgende volgorde geactiveerd:
hide.bs.tab
(op het huidige actieve tabblad)show.bs.tab
(op het te tonen tabblad)hidden.bs.tab
(op het vorige actieve tabblad, hetzelfde als voor hethide.bs.tab
evenement)shown.bs.tab
(op het nieuw actieve tabblad dat zojuist is weergegeven, dezelfde als voor deshow.bs.tab
gebeurtenis)
Als er al geen tabblad actief was, worden de gebeurtenissen hide.bs.tab
en hidden.bs.tab
niet geactiveerd.
Evenementtype | Beschrijving |
---|---|
toon.bs.tabblad | Deze gebeurtenis wordt geactiveerd bij tabshow, maar voordat het nieuwe tabblad is weergegeven. Gebruik event.target en event.relatedTarget om respectievelijk het actieve tabblad en het vorige actieve tabblad (indien beschikbaar) te targeten. |
getoond.bs.tabblad | Deze gebeurtenis wordt geactiveerd bij tabshow nadat een tabblad is weergegeven. Gebruik event.target en event.relatedTarget om respectievelijk het actieve tabblad en het vorige actieve tabblad (indien beschikbaar) te targeten. |
verberg.bs.tab | Deze gebeurtenis wordt geactiveerd wanneer een nieuw tabblad moet worden weergegeven (en dus het vorige actieve tabblad moet worden verborgen). Gebruik event.target en om respectievelijk event.relatedTarget het huidige actieve tabblad en het nieuwe binnenkort actieve tabblad te targeten. |
verborgen.bs.tabblad | Deze gebeurtenis wordt geactiveerd nadat een nieuw tabblad is weergegeven (en dus het vorige actieve tabblad is verborgen). Gebruik event.target en event.relatedTarget om respectievelijk het vorige actieve tabblad en het nieuwe actieve tabblad te targeten. |
$('a[data-toggle="list"]').on('shown.bs.tab', function (event) {
event.target // newly activated tab
event.relatedTarget // previous active tab
})