List Group - Flowbite Vue
Use the list group component to display a series of items, buttons or links inside a single element
List Group - Flowbite
Original reference: https://flowbite.com/docs/components/list-group/
The list group component can be used to display a series of elements, buttons, or links inside a single card component — similar to a sidebar or menu.
Default List Group
Use FwbListGroup as a wrapper and place FwbListGroupItem elements inside it to render a basic bordered list.
- Item 1
- Item 2
- Item 3
- Item 4
- Item 5
<template>
<fwb-list-group>
<fwb-list-group-item>Item 1</fwb-list-group-item>
<fwb-list-group-item>Item 2</fwb-list-group-item>
<fwb-list-group-item>Item 3</fwb-list-group-item>
<fwb-list-group-item>Item 4</fwb-list-group-item>
<fwb-list-group-item>Item 5</fwb-list-group-item>
</fwb-list-group>
</template>
<script setup>
import { FwbListGroup, FwbListGroupItem } from 'flowbite-vue'
</script>Link Items
Use the href prop for external links or the to prop for Vue Router navigation. Items with either prop automatically receive hover styling. Use target to control the link target (e.g. _blank). Add the active prop to highlight the currently selected item.
- Link with href (active) External link Router link
- Regular item (no hover)
<template>
<fwb-list-group>
<fwb-list-group-item active href="#">
Link with href (active)
</fwb-list-group-item>
<fwb-list-group-item href="https://flowbite.com" target="__blank">
External link (target blank)
</fwb-list-group-item>
<fwb-list-group-item to="#">
Router link
</fwb-list-group-item>
<fwb-list-group-item>
Regular item (no hover)
</fwb-list-group-item>
</fwb-list-group>
</template>
<script setup>
import { FwbListGroup, FwbListGroupItem } from 'flowbite-vue'
</script>Items with Icons
Use the prefix slot to render an icon before the item label, or the suffix slot to render one after it.
- Profile
- Settings
- Messages
- Download
<template>
<fwb-list-group>
<fwb-list-group-item>
<template #prefix>
<svg class="w-4 h-4 fill-current" fill="currentColor" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
<path clip-rule="evenodd" d="M18 10a8 8 0 11-16 0 8 8 0 0116 0zm-6-3a2 2 0 11-4 0 2 2 0 014 0zm-2 4a5 5 0 00-4.546 2.916A5.986 5.986 0 0010 16a5.986 5.986 0 004.546-2.084A5 5 0 0010 11z" fill-rule="evenodd" />
</svg>
</template>
Profile
</fwb-list-group-item>
<fwb-list-group-item>
<template #prefix>
<svg class="w-4 h-4 fill-current" fill="currentColor" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
<path d="M5 4a1 1 0 00-2 0v7.268a2 2 0 000 3.464V16a1 1 0 102 0v-1.268a2 2 0 000-3.464V4zM11 4a1 1 0 10-2 0v1.268a2 2 0 000 3.464V16a1 1 0 102 0V8.732a2 2 0 000-3.464V4zM16 3a1 1 0 011 1v7.268a2 2 0 010 3.464V16a1 1 0 11-2 0v-1.268a2 2 0 010-3.464V4a1 1 0 011-1z" />
</svg>
</template>
Settings
</fwb-list-group-item>
<fwb-list-group-item>
<template #prefix>
<svg class="w-4 h-4 fill-current" fill="currentColor" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
<path clip-rule="evenodd" d="M5 3a2 2 0 00-2 2v10a2 2 0 002 2h10a2 2 0 002-2V5a2 2 0 00-2-2H5zm0 2h10v7h-2l-1 2H8l-1-2H5V5z" fill-rule="evenodd" />
</svg>
</template>
Messages
</fwb-list-group-item>
<fwb-list-group-item>
<template #suffix>
<svg class="w-4 h-4 fill-current" fill="currentColor" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
<path clip-rule="evenodd" d="M2 9.5A3.5 3.5 0 005.5 13H9v2.586l-1.293-1.293a1 1 0 00-1.414 1.414l3 3a1 1 0 001.414 0l3-3a1 1 0 00-1.414-1.414L11 15.586V13h2.5a4.5 4.5 0 10-.616-8.958 4.002 4.002 0 10-7.753 1.977A3.5 3.5 0 002 9.5zm9 3.5H9V8a1 1 0 012 0v5z" fill-rule="evenodd" />
</svg>
</template>
Download
</fwb-list-group-item>
</fwb-list-group>
</template>
<script setup>
import { FwbListGroup, FwbListGroupItem } from 'flowbite-vue'
</script>Disabled Items
Add the disabled prop to a FwbListGroupItem to apply muted styles and prevent interaction.
- Profile
- Settings
- Messages
- Download
<template>
<fwb-list-group>
<fwb-list-group-item>
<template #prefix>
<svg class="w-4 h-4 fill-current" fill="currentColor" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
<path clip-rule="evenodd" d="M18 10a8 8 0 11-16 0 8 8 0 0116 0zm-6-3a2 2 0 11-4 0 2 2 0 014 0zm-2 4a5 5 0 00-4.546 2.916A5.986 5.986 0 0010 16a5.986 5.986 0 004.546-2.084A5 5 0 0010 11z" fill-rule="evenodd" />
</svg>
</template>
Profile
</fwb-list-group-item>
<fwb-list-group-item>
<template #prefix>
<svg class="w-4 h-4 fill-current" fill="currentColor" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
<path d="M5 4a1 1 0 00-2 0v7.268a2 2 0 000 3.464V16a1 1 0 102 0v-1.268a2 2 0 000-3.464V4zM11 4a1 1 0 10-2 0v1.268a2 2 0 000 3.464V16a1 1 0 102 0V8.732a2 2 0 000-3.464V4zM16 3a1 1 0 011 1v7.268a2 2 0 010 3.464V16a1 1 0 11-2 0v-1.268a2 2 0 010-3.464V4a1 1 0 011-1z" />
</svg>
</template>
Settings
</fwb-list-group-item>
<fwb-list-group-item>
<template #prefix>
<svg class="w-4 h-4 fill-current" fill="currentColor" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
<path clip-rule="evenodd" d="M5 3a2 2 0 00-2 2v10a2 2 0 002 2h10a2 2 0 002-2V5a2 2 0 00-2-2H5zm0 2h10v7h-2l-1 2H8l-1-2H5V5z" fill-rule="evenodd" />
</svg>
</template>
Messages
</fwb-list-group-item>
<fwb-list-group-item disabled>
<template #prefix>
<svg class="w-4 h-4 fill-current" fill="currentColor" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
<path clip-rule="evenodd" d="M2 9.5A3.5 3.5 0 005.5 13H9v2.586l-1.293-1.293a1 1 0 00-1.414 1.414l3 3a1 1 0 001.414 0l3-3a1 1 0 00-1.414-1.414L11 15.586V13h2.5a4.5 4.5 0 10-.616-8.958 4.002 4.002 0 10-7.753 1.977A3.5 3.5 0 002 9.5zm9 3.5H9V8a1 1 0 012 0v5z" fill-rule="evenodd" />
</svg>
</template>
Download
</fwb-list-group-item>
</fwb-list-group>
</template>
<script setup>
import { FwbListGroup, FwbListGroupItem } from 'flowbite-vue'
</script>List Group component API
FwbListGroup Slots
| Name | Description |
|---|---|
| default | One or more FwbListGroupItem components. |
FwbListGroupItem Props
| Name | Type | Default | Description |
|---|---|---|---|
| active | Boolean | false | Highlights the item as the currently active entry. |
| disabled | Boolean | false | Applies muted styles and prevents interaction. |
| href | String | null | Renders the item as an <a> and sets the href attribute. |
| tag | String | 'li' | Override the root element tag (e.g. 'button', 'router-link', 'nuxt-link'). |
| target | String | '_self' | Sets the target attribute when href is used. |
| to | String | Object | null | Renders the item as a <RouterLink> and sets the to prop. |
FwbListGroupItem Slots
| Name | Description |
|---|---|
| default | The item label content. |
| prefix | Icon or element rendered before the label. |
| suffix | Icon or element rendered after the label. |