Bootstrap 4 Tutorial

BS4 List Groups

Last modified on: October 26, 2024

<p>Bootstrap 4's list group component is used to display a series of items, such as links, buttons, or text, in a list format. This component is perfect for displaying navigation links, to-do lists, and more, and it comes with various styles and customization options.</p>
<hr />
<h1>Bootstrap 4 List Groups</h1>
<p>The basic structure of a list group is achieved with the <code>.list-group</code> and <code>.list-group-item</code> classes.</p>
<h2>Basic List Group</h2>
<p>A simple, unstyled list group can be created as follows:</p>
<div class="contain-inline-size rounded-md border-[0.5px] border-token-border-medium relative bg-token-sidebar-surface-primary dark:bg-gray-950">
<div class="flex items-center text-token-text-secondary px-4 py-2 text-xs font-sans justify-between rounded-t-md h-9 bg-token-sidebar-surface-primary dark:bg-token-main-surface-secondary">html</div>
<div class="sticky top-9 md:top-[5.75rem]">
<div class="absolute bottom-0 right-2 flex h-9 items-center">
<div class="flex items-center rounded bg-token-sidebar-surface-primary px-2 font-sans text-xs text-token-text-secondary dark:bg-token-main-surface-secondary">
<pre class="language-markup"><code>&lt;ul class="list-group"&gt;
    &lt;li class="list-group-item"&gt;Item 1&lt;/li&gt;
    &lt;li class="list-group-item"&gt;Item 2&lt;/li&gt;
    &lt;li class="list-group-item"&gt;Item 3&lt;/li&gt;
&lt;/ul&gt;
</code></pre>
</div>
</div>
</div>
</div>
<h2>List Group with Active and Disabled Items</h2>
<p>Using <code>.active</code> and <code>.disabled</code> classes on list items allows you to indicate the current item and disable others.</p>
<div class="contain-inline-size rounded-md border-[0.5px] border-token-border-medium relative bg-token-sidebar-surface-primary dark:bg-gray-950">
<div class="flex items-center text-token-text-secondary px-4 py-2 text-xs font-sans justify-between rounded-t-md h-9 bg-token-sidebar-surface-primary dark:bg-token-main-surface-secondary">html</div>
<div class="sticky top-9 md:top-[5.75rem]">
<div class="absolute bottom-0 right-2 flex h-9 items-center">
<div class="flex items-center rounded bg-token-sidebar-surface-primary px-2 font-sans text-xs text-token-text-secondary dark:bg-token-main-surface-secondary">
<pre class="language-markup"><code>&lt;ul class="list-group"&gt;
    &lt;li class="list-group-item active"&gt;Active Item&lt;/li&gt;
    &lt;li class="list-group-item"&gt;Item 2&lt;/li&gt;
    &lt;li class="list-group-item disabled"&gt;Disabled Item&lt;/li&gt;
&lt;/ul&gt;
</code></pre>
</div>
</div>
</div>
</div>
<h2>List Group with Links</h2>
<p>Turn list group items into clickable links by using <code>&lt;a&gt;</code> tags with <code>.list-group-item</code> and <code>.list-group-item-action</code> classes.</p>
<div class="contain-inline-size rounded-md border-[0.5px] border-token-border-medium relative bg-token-sidebar-surface-primary dark:bg-gray-950">
<div class="flex items-center text-token-text-secondary px-4 py-2 text-xs font-sans justify-between rounded-t-md h-9 bg-token-sidebar-surface-primary dark:bg-token-main-surface-secondary">html</div>
<div class="sticky top-9 md:top-[5.75rem]">
<div class="absolute bottom-0 right-2 flex h-9 items-center">
<div class="flex items-center rounded bg-token-sidebar-surface-primary px-2 font-sans text-xs text-token-text-secondary dark:bg-token-main-surface-secondary">
<pre class="language-markup"><code>&lt;div class="list-group"&gt;
    &lt;a href="#" class="list-group-item list-group-item-action active"&gt;Active Link&lt;/a&gt;
    &lt;a href="#" class="list-group-item list-group-item-action"&gt;Link Item 2&lt;/a&gt;
    &lt;a href="#" class="list-group-item list-group-item-action disabled"&gt;Disabled Link&lt;/a&gt;
&lt;/div&gt;
</code></pre>
</div>
</div>
</div>
</div>
<h2>List Group with Buttons</h2>
<p>For button-style list items, use <code>&lt;button&gt;</code> elements with <code>.list-group-item</code> and <code>.list-group-item-action</code> classes.</p>
<div class="contain-inline-size rounded-md border-[0.5px] border-token-border-medium relative bg-token-sidebar-surface-primary dark:bg-gray-950">
<div class="flex items-center text-token-text-secondary px-4 py-2 text-xs font-sans justify-between rounded-t-md h-9 bg-token-sidebar-surface-primary dark:bg-token-main-surface-secondary">html</div>
<div class="sticky top-9 md:top-[5.75rem]">
<div class="absolute bottom-0 right-2 flex h-9 items-center">
<div class="flex items-center rounded bg-token-sidebar-surface-primary px-2 font-sans text-xs text-token-text-secondary dark:bg-token-main-surface-secondary">
<pre class="language-markup"><code>&lt;div class="list-group"&gt;
    &lt;button type="button" class="list-group-item list-group-item-action active"&gt;Active Button&lt;/button&gt;
    &lt;button type="button" class="list-group-item list-group-item-action"&gt;Button Item 2&lt;/button&gt;
    &lt;button type="button" class="list-group-item list-group-item-action" disabled&gt;Disabled Button&lt;/button&gt;
&lt;/div&gt;
</code></pre>
</div>
</div>
</div>
</div>
<h2>List Group with Badges</h2>
<p>Use Bootstrap badges within list groups to show notifications or item counts.</p>
<div class="contain-inline-size rounded-md border-[0.5px] border-token-border-medium relative bg-token-sidebar-surface-primary dark:bg-gray-950">
<div class="flex items-center text-token-text-secondary px-4 py-2 text-xs font-sans justify-between rounded-t-md h-9 bg-token-sidebar-surface-primary dark:bg-token-main-surface-secondary">html</div>
<div class="sticky top-9 md:top-[5.75rem]">
<div class="absolute bottom-0 right-2 flex h-9 items-center">
<div class="flex items-center rounded bg-token-sidebar-surface-primary px-2 font-sans text-xs text-token-text-secondary dark:bg-token-main-surface-secondary">
<pre class="language-markup"><code>&lt;ul class="list-group"&gt;
    &lt;li class="list-group-item d-flex justify-content-between align-items-center"&gt;
        Item 1
        &lt;span class="badge badge-primary badge-pill"&gt;3&lt;/span&gt;
    &lt;/li&gt;
    &lt;li class="list-group-item d-flex justify-content-between align-items-center"&gt;
        Item 2
        &lt;span class="badge badge-primary badge-pill"&gt;5&lt;/span&gt;
    &lt;/li&gt;
    &lt;li class="list-group-item d-flex justify-content-between align-items-center"&gt;
        Item 3
        &lt;span class="badge badge-primary badge-pill"&gt;7&lt;/span&gt;
    &lt;/li&gt;
&lt;/ul&gt;
</code></pre>
</div>
</div>
</div>
</div>
<h2>List Group Contextual Classes</h2>
<p>Use contextual classes like <code>.list-group-item-primary</code>, <code>.list-group-item-success</code>, <code>.list-group-item-danger</code>, etc., to add color to list items.</p>
<div class="contain-inline-size rounded-md border-[0.5px] border-token-border-medium relative bg-token-sidebar-surface-primary dark:bg-gray-950">
<div class="flex items-center text-token-text-secondary px-4 py-2 text-xs font-sans justify-between rounded-t-md h-9 bg-token-sidebar-surface-primary dark:bg-token-main-surface-secondary">html</div>
<div class="sticky top-9 md:top-[5.75rem]">
<div class="absolute bottom-0 right-2 flex h-9 items-center">
<div class="flex items-center rounded bg-token-sidebar-surface-primary px-2 font-sans text-xs text-token-text-secondary dark:bg-token-main-surface-secondary">
<pre class="language-markup"><code>&lt;ul class="list-group"&gt;
    &lt;li class="list-group-item list-group-item-primary"&gt;Primary Item&lt;/li&gt;
    &lt;li class="list-group-item list-group-item-success"&gt;Success Item&lt;/li&gt;
    &lt;li class="list-group-item list-group-item-danger"&gt;Danger Item&lt;/li&gt;
    &lt;li class="list-group-item list-group-item-warning"&gt;Warning Item&lt;/li&gt;
&lt;/ul&gt;
</code></pre>
</div>
</div>
</div>
</div>
<h2>Horizontal List Group</h2>
<p>To display a horizontal list group (in a row), add <code>.list-group-horizontal</code> to the <code>.list-group</code> container. Horizontal list groups work best on larger screens and revert to vertical on smaller screens.</p>
<div class="contain-inline-size rounded-md border-[0.5px] border-token-border-medium relative bg-token-sidebar-surface-primary dark:bg-gray-950">
<div class="flex items-center text-token-text-secondary px-4 py-2 text-xs font-sans justify-between rounded-t-md h-9 bg-token-sidebar-surface-primary dark:bg-token-main-surface-secondary">html</div>
<div class="sticky top-9 md:top-[5.75rem]">
<div class="absolute bottom-0 right-2 flex h-9 items-center">
<div class="flex items-center rounded bg-token-sidebar-surface-primary px-2 font-sans text-xs text-token-text-secondary dark:bg-token-main-surface-secondary">
<pre class="language-markup"><code>&lt;ul class="list-group list-group-horizontal"&gt;
    &lt;li class="list-group-item"&gt;Item 1&lt;/li&gt;
    &lt;li class="list-group-item"&gt;Item 2&lt;/li&gt;
    &lt;li class="list-group-item"&gt;Item 3&lt;/li&gt;
&lt;/ul&gt;
</code></pre>
</div>
</div>
</div>
</div>
<hr />
<h2>Complete Example: Bootstrap 4 List Groups</h2>
<p>Here&rsquo;s a complete example demonstrating various Bootstrap 4 list group features:</p>
<div class="contain-inline-size rounded-md border-[0.5px] border-token-border-medium relative bg-token-sidebar-surface-primary dark:bg-gray-950">
<div class="flex items-center text-token-text-secondary px-4 py-2 text-xs font-sans justify-between rounded-t-md h-9 bg-token-sidebar-surface-primary dark:bg-token-main-surface-secondary">html</div>
<div class="sticky top-9 md:top-[5.75rem]">
<div class="absolute bottom-0 right-2 flex h-9 items-center">
<div class="flex items-center rounded bg-token-sidebar-surface-primary px-2 font-sans text-xs text-token-text-secondary dark:bg-token-main-surface-secondary">
<pre class="language-markup"><code>&lt;!DOCTYPE html&gt;
&lt;html lang="en"&gt;
&lt;head&gt;
    &lt;meta charset="UTF-8"&gt;
    &lt;meta name="viewport" content="width=device-width, initial-scale=1.0"&gt;
    &lt;title&gt;Bootstrap 4 List Groups Example&lt;/title&gt;
    &lt;link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/css/bootstrap.min.css"&gt;
&lt;/head&gt;
&lt;body&gt;

&lt;div class="container mt-5"&gt;
        &lt;h1&gt;Bootstrap 4 List Groups Examples&lt;/h1&gt;

&lt;!-- Basic List Group --&gt;
        &lt;h2&gt;Basic List Group&lt;/h2&gt;
        &lt;ul class="list-group"&gt;
            &lt;li class="list-group-item"&gt;Item 1&lt;/li&gt;
            &lt;li class="list-group-item"&gt;Item 2&lt;/li&gt;
            &lt;li class="list-group-item"&gt;Item 3&lt;/li&gt;
        &lt;/ul&gt;

&lt;!-- List Group with Active and Disabled Items --&gt;
        &lt;h2&gt;List Group with Active and Disabled Items&lt;/h2&gt;
        &lt;ul class="list-group"&gt;
            &lt;li class="list-group-item active"&gt;Active Item&lt;/li&gt;
            &lt;li class="list-group-item"&gt;Item 2&lt;/li&gt;
            &lt;li class="list-group-item disabled"&gt;Disabled Item&lt;/li&gt;
        &lt;/ul&gt;

&lt;!-- List Group with Links --&gt;
        &lt;h2&gt;List Group with Links&lt;/h2&gt;
        &lt;div class="list-group"&gt;
            &lt;a href="#" class="list-group-item list-group-item-action active"&gt;Active Link&lt;/a&gt;
            &lt;a href="#" class="list-group-item list-group-item-action"&gt;Link Item 2&lt;/a&gt;
            &lt;a href="#" class="list-group-item list-group-item-action disabled"&gt;Disabled Link&lt;/a&gt;
        &lt;/div&gt;

&lt;!-- List Group with Badges --&gt;
        &lt;h2&gt;List Group with Badges&lt;/h2&gt;
        &lt;ul class="list-group"&gt;
            &lt;li class="list-group-item d-flex justify-content-between align-items-center"&gt;
                Item 1
                &lt;span class="badge badge-primary badge-pill"&gt;3&lt;/span&gt;
            &lt;/li&gt;
            &lt;li class="list-group-item d-flex justify-content-between align-items-center"&gt;
                Item 2
                &lt;span class="badge badge-primary badge-pill"&gt;5&lt;/span&gt;
            &lt;/li&gt;
            &lt;li class="list-group-item d-flex justify-content-between align-items-center"&gt;
                Item 3
                &lt;span class="badge badge-primary badge-pill"&gt;7&lt;/span&gt;
            &lt;/li&gt;
        &lt;/ul&gt;

&lt;!-- Horizontal List Group --&gt;
        &lt;h2&gt;Horizontal List Group&lt;/h2&gt;
        &lt;ul class="list-group list-group-horizontal"&gt;
            &lt;li class="list-group-item"&gt;Item 1&lt;/li&gt;
            &lt;li class="list-group-item"&gt;Item 2&lt;/li&gt;
            &lt;li class="list-group-item"&gt;Item 3&lt;/li&gt;
        &lt;/ul&gt;
    &lt;/div&gt;

&lt;script src="https://code.jquery.com/jquery-3.5.1.slim.min.js"&gt;&lt;/script&gt;
    &lt;script src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.9.2/dist/umd/popper.min.js"&gt;&lt;/script&gt;
    &lt;script src="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/js/bootstrap.min.js"&gt;&lt;/script&gt;
&lt;/body&gt;
&lt;/html&gt;
</code></pre>
</div>
</div>
</div>
</div>
<hr />
<h2>&nbsp;</h2>

Web Technology View More