列表组

基础的列表组

最基本的列表组是包含列表项的无序列表：

如需创建基础列表组，请使用类为 .list-group 的 <ul> 元素和类为 .list-group-item 的 <li> 元素：

实例

<ul class="list-group">
  <li class="list-group-item">第一项</li>
  <li class="list-group-item">第二项</li>
  <li class="list-group-item">第三项</li>
</ul>

活动状态

请使用 .active 类突出显示当前项目：

实例

<ul class="list-group">
  <li class="list-group-item active">活动项目</li>
  <li class="list-group-item">第二项</li>
  <li class="list-group-item">第三项</li>
</ul>

包含链接项的列表组

如需创建带有链接项目的列表组，请使用 <div> 代替 <ul>，用 <a> 代替 <li>。可选地，如果您想要悬停时的灰色背景色，请添加 .list-group-item-action 类：

实例

<div class="list-group">
  <a href="#" class="list-group-item list-group-item-action">第一项</a>
  <a href="#" class="list-group-item list-group-item-action">第二项</a>
  <a href="#" class="list-group-item list-group-item-action">第三项</a>
</div>

禁用项目

.disabled 类为禁用的项目添加了较浅的文本颜色。当在链接上使用时，将去除悬停效果：

实例

<div class="list-group">
  <a href="#" class="list-group-item disabled">被禁用的项目</a>
  <a href="#" class="list-group-item disabled">被禁用的项目</a>
  <a href="#" class="list-group-item">第三项</a>
</div>

删除边框

使用 .list-group-flush 类删除边框和圆角：

实例

<ul class="list-group list-group-flush">
  <li class="list-group-item">第一项</li>
  <li class="list-group-item">第二项</li>
  <li class="list-group-item">第三项</li>
  <li class="list-group-item">第四项</li>
</ul>

带编号的列表组

使用 .list-group-numbered 类创建前面带有数字的列表项：

实例

<ol class="list-group list-group-numbered">
  <li class="list-group-item">第一项</li>
  <li class="list-group-item">第二项</li>
  <li class="list-group-item">第三项</li>
</ol>

水平列表组

如果您希望列表项水平显示而不是垂直显示（并排而不是堆叠），请将 .list-group-horizontal 类添加到 .list-group：

实例

<ul class="list-group list-group-horizontal">
  <li class="list-group-item">第一项</li>
  <li class="list-group-item">第二项</li>
  <li class="list-group-item">第三项</li>
  <li class="list-group-item">第四项</li>
</ul>

上下文类

上下文类可用于为列表项添加颜色：

为列表项着色的类是：

• .list-group-item-success
• .list-group-item-secondary
• .list-group-item-info
• .list-group-item-warning
• .list-group-item-danger
• .list-group-item-primary
• .list-group-item-dark
• .list-group-item-light

实例

<ul class="list-group">
  <li class="list-group-item list-group-item-success">Success item</li>
  <li class="list-group-item list-group-item-secondary">Secondary item</li>
  <li class="list-group-item list-group-item-info">Info item</li>
  <li class="list-group-item list-group-item-warning">Warning item</li>
  <li class="list-group-item list-group-item-danger">Danger item</li>
  <li class="list-group-item list-group-item-primary">Primary item</li>
  <li class="list-group-item list-group-item-dark">Dark item</li>
  <li class="list-group-item list-group-item-light">Light item</li>
</ul>

带有上下文类的链接项目

实例

<div class="list-group">
  <a href="#" class="list-group-item list-group-item-action">Action item</a>
  <a href="#" class="list-group-item list-group-item-action list-group-item-success">Success item</a>
  <a href="#" class="list-group-item list-group-item-action list-group-item-secondary">Secondary item</a>
  <a href="#" class="list-group-item list-group-item-action list-group-item-info">Info item</a>
  <a href="#" class="list-group-item list-group-item-action list-group-item-warning">Warning item</a>
  <a href="#" class="list-group-item list-group-item-action list-group-item-danger">Danger item</a>
  <a href="#" class="list-group-item list-group-item-action list-group-item-primary">Primary item</a>
  <a href="#" class="list-group-item list-group-item-action list-group-item-dark">Dark item</a>
  <a href="#" class="list-group-item list-group-item-action list-group-item-light">Light item</a>
</div>

带徽章的列表组

将 .badge 类与 utility/helper 类结合起来，可在列表组中添加徽章：

实例

<ul class="list-group">
  <li class="list-group-item d-flex justify-content-between align-items-center">
    收件箱
    <span class="badge bg-primary rounded-pill">12</span>
  </li>
  <li class="list-group-item d-flex justify-content-between align-items-center">
    广告邮件
    <span class="badge bg-primary rounded-pill">50</span>
  </li>
  <li class="list-group-item d-flex justify-content-between align-items-center">
    垃圾箱
    <span class="badge bg-primary rounded-pill">99</span>
  </li>
</ul>