in English

Listgrupp

Listgrupper är en flexibel och kraftfull komponent för att visa en serie innehåll. Ändra och utöka dem för att stödja nästan vilket innehåll som helst.

Grundläggande exempel

Den mest grundläggande listgruppen är en oordnad lista med listobjekt och de rätta klasserna. Bygg på det med alternativen som följer, eller med din egen CSS efter behov.

Ett föremål
Ett andra föremål
En tredje sak
En fjärde punkt
Och 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>

Aktiva föremål

Lägg .activetill ett .list-group-itemför att indikera det aktuella aktiva valet.

Ett aktivt objekt
Ett andra föremål
En tredje sak
En fjärde punkt
Och 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>

Inaktiverade objekt

Lägg .disabledtill ett .list-group-itemför att få det att verka inaktiverat. Observera att vissa element med .disabledäven kommer att kräva anpassad JavaScript för att helt inaktivera sina klickhändelser (t.ex. länkar).

Ett inaktiverat föremål
Ett andra föremål
En tredje sak
En fjärde punkt
Och 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>

Länkar och knappar

Använd <a>s eller <button>s för att skapa handlingsbara listgruppobjekt med hovra, inaktiverade och aktiva tillstånd genom att lägga till .list-group-item-action. Vi separerar dessa pseudoklasser för att säkerställa att listgrupper gjorda av icke-interaktiva element (som <li>s eller <div>s) inte ger ett klick eller tryck.

Se till att inte använda standardklasserna .btnhär .

Det aktuella länkobjektet Ett andra länkobjekt Ett tredje länkobjekt Ett fjärde länkobjekt Ett inaktiverat länkobjekt

<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 också använda disabledattributet istället för .disabledklassen. Tyvärr <a>stöder inte attributet disabled.

<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>

Spola

Lägg .list-group-flushtill för att ta bort vissa kanter och rundade hörn för att rendera listgruppobjekt kant-till-kant i en överordnad behållare (t.ex. kort).

Ett föremål
Ett andra föremål
En tredje sak
En fjärde punkt
Och 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>

Horisontell

Lägg .list-group-horizontaltill för att ändra layouten för listgruppobjekt från vertikal till horisontell över alla brytpunkter. Alternativt kan du välja en responsiv variant .list-group-horizontal-{sm|md|lg|xl}för att göra en listgrupp horisontell med början vid den brytpunktens min-width. För närvarande kan horisontella listgrupper inte kombineras med spollistgrupper.

ProTip: Vill du ha lika breda listgruppobjekt när de är horisontella? Lägg .flex-filltill i varje lista gruppobjekt.

Ett föremål
Ett andra föremål
En tredje sak

Ett föremål
Ett andra föremål
En tredje sak

Ett föremål
Ett andra föremål
En tredje sak

Ett föremål
Ett andra föremål
En tredje sak

Ett föremål
Ett andra föremål
En tredje sak

<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>

Kontextuella klasser

Använd kontextuella klasser för att utforma listobjekt med en tilltalande bakgrund och färg.

En enkel standardlista gruppobjekt
Ett enkelt primärt listgruppobjekt
En enkel sekundär listgrupppost
Ett enkelt gruppobjekt med framgångslista
En enkel farolista gruppobjekt
En enkel varningslista gruppobjekt
En enkel informationslista gruppobjekt
En enkel grupppost för ljuslista
En enkel mörk lista gruppobjekt

<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>

Kontextuella klasser arbetar också med .list-group-item-action. Notera tillägget av svävstilarna här som inte finns i föregående exempel. Även staten stöds .active; tillämpa den för att indikera ett aktivt val på ett kontextuellt listgruppobjekt.

En enkel standardlista gruppobjekt Ett enkelt primärt listgruppobjekt En enkel sekundär listgrupppost Ett enkelt gruppobjekt med framgångslista En enkel farolista gruppobjekt En enkel varningslista gruppobjekt En enkel informationslista gruppobjekt En enkel grupppost för ljuslista En enkel mörk lista gruppobjekt

<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>

Förmedla mening till hjälpmedel

Att använda färg för att lägga till mening ger bara en visuell indikation, som inte kommer att förmedlas till användare av hjälpmedel – som skärmläsare. Se till att information som betecknas med färgen antingen är uppenbar från själva innehållet (t.ex. den synliga texten), eller är inkluderad på andra sätt, såsom ytterligare text gömd med .sr-onlyklassen.

Med märken

Lägg till märken till valfritt listgruppobjekt för att visa olästa antal, aktivitet och mer med hjälp av några verktyg .

Ett listobjekt14
Ett andra listobjekt2
En tredje lista1

<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>

Anpassat innehåll

Lägg till nästan vilken HTML som helst inom, även för länkade listgrupper som den nedan, med hjälp av flexbox-verktyg .

Rubrik för listgruppobjekt

3 dagar sedan

Viss platshållarinnehåll i ett stycke.

Och lite finstilt.

Rubrik för listgruppobjekt

3 dagar sedan

Viss platshållarinnehåll i ett stycke.

Och lite dämpat finstilt.

Rubrik för listgruppobjekt

3 dagar sedan

Viss platshållarinnehåll i ett stycke.

Och lite dämpat finstilt.

<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-beteende

Använd fliken JavaScript-plugin – inkludera den individuellt eller genom den kompilerade bootstrap.jsfilen – för att utöka vår listgrupp för att skapa flikar med lokalt innehåll.

Hem Profil Meddelanden inställningar

Viss platshållarinnehåll i ett stycke som relaterar till "Hem". Och lite mer innehåll, som används här bara för att fylla ut och fylla den här flikpanelen. I produktionen skulle du självklart ha mer verkligt innehåll här. Och inte bara text. Det kan vara vad som helst, egentligen. Text, bilder, formulär.

Some placeholder content in a paragraph relating to "Profile". And some more content, used here just to pad out and fill this tab panel. In production, you would obviously have more real content here. And not just text. It could be anything, really. Text, images, forms.

Some placeholder content in a paragraph relating to "Messages". And some more content, used here just to pad out and fill this tab panel. In production, you would obviously have more real content here. And not just text. It could be anything, really. Text, images, forms.

Some placeholder content in a paragraph relating to "Settings". And some more content, used here just to pad out and fill this tab panel. In production, you would obviously have more real content here. And not just text. It could be anything, really. Text, images, forms.

<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>

Använda dataattribut

Du kan aktivera en listgruppsnavigering utan att skriva något JavaScript genom att helt enkelt ange data-toggle="list"eller på ett element. Använd dessa dataattribut 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

Aktivera tabellobjekt via JavaScript (varje listobjekt måste aktiveras individuellt):

$('#myList a').on('click', function (event) {
  event.preventDefault()
  $(this).tab('show')
})

Du kan aktivera individuella listobjekt på flera sätt:

$('#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

Tona effekt

För att få flikpanelen att tona in, lägg .fadetill i varje .tab-pane. Den första flikrutan måste också .showgöra det ursprungliga innehållet synligt.

<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

Aktiverar ett listobjekt och innehållsbehållare. Tab ska ha antingen en data-targeteller en hrefinriktning på en containernod 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('show')

Väljer det givna listobjektet och visar dess tillhörande fönster. Alla andra listobjekt som tidigare valts avmarkeras och dess tillhörande ruta döljs. Återgår till den som ringer innan flikrutan faktiskt har visats (till exempel innan shown.bs.tabhändelsen inträffar).

$('#someListItem').tab('show')

evenemang

När en ny flik visas aktiveras händelserna i följande ordning:

hide.bs.tab(på den aktuella aktiva fliken)
show.bs.tab(på fliken som ska visas)
hidden.bs.tab(på föregående aktiva flik, samma som för hide.bs.tabhändelsen)
shown.bs.tab(på den nyligen aktiva fliken som just visades, samma som för show.bs.tabevenemanget)

Om ingen flik redan var aktiv kommer händelserna hide.bs.taboch hidden.bs.tabinte att aktiveras.

Event typ	Beskrivning
visa.bs.tab	Den här händelsen aktiveras vid flikvisning, men innan den nya fliken har visats. Använd `event.target`och `event.relatedTarget`för att rikta in den aktiva fliken respektive den föregående aktiva fliken (om tillgänglig).
visad.bs.tab	Den här händelsen aktiveras vid flikvisning efter att en flik har visats. Använd `event.target`och `event.relatedTarget`för att rikta in den aktiva fliken respektive den föregående aktiva fliken (om tillgänglig).
hide.bs.tab	Den här händelsen aktiveras när en ny flik ska visas (och därmed den tidigare aktiva fliken ska döljas). Använd `event.target`och `event.relatedTarget`för att rikta in den aktuella aktiva fliken respektive den nya snart-aktiva fliken.
hidden.bs.tab	Den här händelsen aktiveras efter att en ny flik har visats (och den tidigare aktiva fliken döljs därför). Använd `event.target`och `event.relatedTarget`för att rikta in den tidigare aktiva fliken respektive den nya aktiva fliken.

$('a[data-toggle="list"]').on('shown.bs.tab', function (event) {
  event.target // newly activated tab
  event.relatedTarget // previous active tab
})