Listegruppe
Listegrupper er en fleksibel og kraftig komponent for å vise en rekke innhold. Endre og utvide dem til å støtte omtrent alt innhold i dem.
Grunnleggende eksempel
Den mest grunnleggende listegruppen er en uordnet liste med listeelementer og de riktige klassene. Bygg videre på det med alternativene som følger, eller med din egen CSS etter behov.
- En ting
- Et annet element
- Et tredje element
- Et fjerde element
- Og en femte
<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>
Aktive elementer
Legg .active
til en .list-group-item
for å angi gjeldende aktive valg.
- Et aktivt element
- Et annet element
- Et tredje element
- Et fjerde element
- Og en femte
<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>
Deaktiverte elementer
Legg .disabled
til en .list-group-item
for å få den til å virke deaktivert. Merk at noen elementer med .disabled
også vil kreve tilpasset JavaScript for å deaktivere klikkhendelsene deres (f.eks. koblinger).
- Et deaktivert element
- Et annet element
- Et tredje element
- Et fjerde element
- Og en femte
<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>
Lenker og knapper
Bruk <a>
s eller <button>
s for å lage handlingsbare listegruppeelementer med hover, deaktivert og aktive tilstander ved å legge til .list-group-item-action
. Vi skiller disse pseudoklassene for å sikre at listegrupper laget av ikke-interaktive elementer (som <li>
s eller <div>
s) ikke gir et klikk eller trykk.
Pass på at du ikke bruker standardklassene .btn
her .
<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>
Med <button>
s kan du også bruke disabled
attributtet i stedet for .disabled
klassen. Dessverre <a>
støtter s ikke attributtet deaktivert.
<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>
Skyll
Legg .list-group-flush
til for å fjerne noen kanter og avrundede hjørner for å gjengi listegruppeelementer kant-til-kant i en overordnet beholder (f.eks. kort).
- En ting
- Et annet element
- Et tredje element
- Et fjerde element
- Og en femte
<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>
Horisontal
Legg .list-group-horizontal
til for å endre oppsettet til listegruppeelementer fra vertikal til horisontal på tvers av alle bruddpunkter. Alternativt kan du velge en responsiv variant .list-group-horizontal-{sm|md|lg|xl}
for å gjøre en listegruppe horisontal som starter ved det bruddpunktet min-width
. Foreløpig kan horisontale listegrupper ikke kombineres med flushlistegrupper.
ProTip: Vil du ha lik breddelistegruppeelementer når de er horisontale? Legg .flex-fill
til hvert listegruppeelement.
- En ting
- Et annet element
- Et tredje element
- En ting
- Et annet element
- Et tredje element
- En ting
- Et annet element
- Et tredje element
- En ting
- Et annet element
- Et tredje element
- En ting
- Et annet element
- Et tredje element
<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>
Kontekstuelle klasser
Bruk kontekstuelle klasser for å style listeelementer med en statisk bakgrunn og farge.
- Et enkelt standard listegruppeelement
- Et enkelt element i primærlistegruppen
- Et enkelt sekundært listegruppeelement
- Et enkelt gruppeelement for suksessliste
- Et enkelt gruppeelement for fareliste
- Et enkelt gruppeelement på en advarselsliste
- En enkel informasjonslistegruppeelement
- Et enkelt lyslistegruppeelement
- Et enkelt gruppeelement på mørk liste
<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>
Kontekstuelle klasser jobber også med .list-group-item-action
. Legg merke til tillegget av svevestilene her som ikke er til stede i forrige eksempel. Også støttet er .active
staten; bruk den for å indikere et aktivt valg på et kontekstuell listegruppeelement.
<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>
Formidle mening til hjelpeteknologier
Å bruke farger for å legge til mening gir bare en visuell indikasjon, som ikke vil bli formidlet til brukere av hjelpeteknologier – for eksempel skjermlesere. Sørg for at informasjon angitt med fargen enten er åpenbar fra selve innholdet (f.eks. den synlige teksten), eller er inkludert på alternative måter, for eksempel ekstra tekst skjult i .sr-only
klassen.
Med merker
Legg til merker til et hvilket som helst listegruppeelement for å vise antall uleste, aktivitet og mer ved hjelp av noen verktøy .
- Et listeelement14
- Et annet listeelement2
- Et tredje listeelement1
<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>
Egendefinert innhold
Legg til nesten hvilken som helst HTML innenfor, selv for koblede listegrupper som den nedenfor, ved hjelp av flexbox-verktøy .
Listegruppeelementoverskrift
3 dager sidenNoe plassholderinnhold i et avsnitt.
Og litt liten skrift.Listegruppeelementoverskrift
3 dager sidenNoe plassholderinnhold i et avsnitt.
Og litt dempet liten skrift.Listegruppeelementoverskrift
3 dager sidenNoe plassholderinnhold i et avsnitt.
Og litt dempet liten skrift.<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-adferd
Bruk JavaScript-plugin-fanen – inkluder den individuelt eller gjennom den kompilerte bootstrap.js
filen – for å utvide listegruppen vår til å lage tabulatorer med lokalt innhold.
<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>
Bruk av dataattributter
Du kan aktivere en listegruppenavigasjon uten å skrive noe JavaScript ved å spesifisere data-toggle="list"
eller på et element. Bruk disse dataattributtene på .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
Aktiver tabulatorlisteelement via JavaScript (hvert listeelement må aktiveres individuelt):
$('#myList a').on('click', function (event) {
event.preventDefault()
$(this).tab('show')
})
Du kan aktivere individuelle listeelementer på flere måter:
$('#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-effekt
For å få fanepanelet til å tone inn, legg .fade
til hver .tab-pane
. Den første faneruten må også .show
gjøre det opprinnelige innholdet synlig.
<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>
Metoder
$().tab
Aktiverer et listeelementelement og innholdsbeholder. Tab skal ha enten en data-target
eller en href
målrettet beholdernode i 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('vis')
Velger det gitte listeelementet og viser tilhørende rute. Ethvert annet listeelement som tidligere ble valgt, blir opphevet og tilhørende rute er skjult. Går tilbake til den som ringer før faneruten faktisk har blitt vist (for eksempel før shown.bs.tab
hendelsen inntreffer).
$('#someListItem').tab('show')
arrangementer
Når du viser en ny fane, utløses hendelsene i følgende rekkefølge:
hide.bs.tab
(på gjeldende aktive fane)show.bs.tab
(på fanen som skal vises)hidden.bs.tab
(på den forrige aktive fanen, den samme som forhide.bs.tab
arrangementet)shown.bs.tab
(på den nylig aktive fanen som nettopp er vist, den samme som forshow.bs.tab
arrangementet)
Hvis ingen fane allerede var aktiv, vil ikke hide.bs.tab
og hidden.bs.tab
-hendelsene bli utløst.
Hendelsestype | Beskrivelse |
---|---|
show.bs.tab | Denne hendelsen utløses på fanevisning, men før den nye fanen har blitt vist. Bruk event.target og event.relatedTarget for å målrette henholdsvis den aktive fanen og den forrige aktive fanen (hvis tilgjengelig). |
vist.bs.tab | Denne hendelsen utløses på fanevisning etter at en fane er vist. Bruk event.target og event.relatedTarget for å målrette henholdsvis den aktive fanen og den forrige aktive fanen (hvis tilgjengelig). |
hide.bs.tab | Denne hendelsen utløses når en ny fane skal vises (og dermed skal den forrige aktive fanen skjules). Bruk event.target og event.relatedTarget for å målrette henholdsvis den gjeldende aktive fanen og den nye snart-aktive fanen. |
hidden.bs.tab | Denne hendelsen utløses etter at en ny fane vises (og dermed er den forrige aktive fanen skjult). Bruk event.target og event.relatedTarget for å målrette henholdsvis den forrige aktive fanen og den nye aktive fanen. |
$('a[data-toggle="list"]').on('shown.bs.tab', function (event) {
event.target // newly activated tab
event.relatedTarget // previous active tab
})