List Group
The most basic list group is an unordered list with list items and the proper classes. Build upon it with the options that follow, or with your own CSS as needed.
- Cras justo odio
- Dapibus ac facilisis in
- Morbi leo risus
- Porta ac consectetur ac
- Vestibulum at eros
<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>Active & Disabled items
Add .active to a .list-group-item to indicate the current active selection.
Add .disabled to a .list-group-item to indicate the current active selection.
- Cras justo odio
- Dapibus ac facilisis in
- Morbi leo risus
- Porta ac consectetur ac
- Vestibulum at eros
<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 disabled">Vestibulum at eros</li>
</ul>Links & Buttons
Use <a>s or <button>s to create actionable list group items with hover, disabled, and active states by adding .list-group-item-action. We separate these pseudo-classes to ensure list groups made of non-interactive elements (like <li>s or <div>s) don’t provide a click or tap affordance.
Be sure to not use the standard .btn classes here.
<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
>
<button class="list-group-item list-group-item-action">
Porta ac consectetur ac
</button>
<a href="#" class="list-group-item list-group-item-action disabled"
>Vestibulum at eros</a
>
</div>With buttons you can use the disabled attribute instead of the .disabled class;
Sizes
- Cras justo odio
- Dapibus ac facilisis in
- Morbi leo risus
- Porta ac consectetur ac
- Vestibulum at eros
- Cras justo odio
- Dapibus ac facilisis in
- Morbi leo risus
- Porta ac consectetur ac
- Vestibulum at eros
<ul class="list-group list-group-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>
<li class="list-group-item">Porta ac consectetur ac</li>
<li class="list-group-item">Vestibulum at eros</li>
</ul>
<ul class="list-group list-group-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>
<li class="list-group-item">Porta ac consectetur ac</li>
<li class="list-group-item">Vestibulum at eros</li>
</ul>Colors
Use contextual classes to style list items with a stateful background and color.
- Dapibus ac facilisis in
- This is a primary list group item
- This is a secondary list group item
- This is a success list group item
- This is a danger list group item
- This is a warning list group item
- This is a info list group item
- This is a light list group item
- This is a dark list group item
<ul class="list-group">
<li class="list-group-item">Dapibus ac facilisis in</li>
<li class="list-group-item list-group-item-primary">
This is a primary list group item
</li>
<li class="list-group-item list-group-item-secondary">
This is a secondary list group item
</li>
<li class="list-group-item list-group-item-success">
This is a success list group item
</li>
<li class="list-group-item list-group-item-danger">
This is a danger list group item
</li>
<li class="list-group-item list-group-item-warning">
This is a warning list group item
</li>
<li class="list-group-item list-group-item-info">
This is a info list group item
</li>
<li class="list-group-item list-group-item-light">
This is a light list group item
</li>
<li class="list-group-item list-group-item-dark">
This is a dark list group item
</li>
</ul>With badges
- Cras justo odio 14
- Dapibus ac facilisis in 2
- Morbi leo risus 1
<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-round">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-round">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-round">1</span>
</li>
</ul>With icons
- Cras justo odio
- Dapibus ac facilisis in
- Morbi leo risus
<ul class="list-group">
<li
class="list-group-item list-group-item-branded d-flex justify-content-between align-items-center">
<Icon class="icon flex-shrink-0 mr-4" />
<span class="flex-grow-1">Cras justo odio</span>
<svg
viewBox="0 0 16 16"
xmlns="http://www.w3.org/2000/svg"
class="icon">
<path
clip-rule="evenodd"
d="M9.1 7.9L4.1 3l1.5-1.4 6.3 6.3-6.3 6.5L4.1 13z"
fill-rule="evenodd" />
</svg>
</li>
<li
class="list-group-item d-flex justify-content-between align-items-center">
<span class="flex-grow-1">Dapibus ac facilisis in</span>
<svg
viewBox="0 0 16 16"
xmlns="http://www.w3.org/2000/svg"
class="icon">
<path
clip-rule="evenodd"
d="M9.1 7.9L4.1 3l1.5-1.4 6.3 6.3-6.3 6.5L4.1 13z"
fill-rule="evenodd" />
</svg>
</li>
<li
class="list-group-item d-flex justify-content-between align-items-center">
<span class="flex-grow-1">Morbi leo risus</span>
<svg
viewBox="0 0 16 16"
xmlns="http://www.w3.org/2000/svg"
class="icon">
<path
clip-rule="evenodd"
d="M9.1 7.9L4.1 3l1.5-1.4 6.3 6.3-6.3 6.5L4.1 13z"
fill-rule="evenodd" />
</svg>
</li>
</ul>