Overview sample detail
Sample project summary. Filtering does not reset the selected record.
A list group presents related rows with consistent spacing, boundaries and optional metadata. Choose semantics from the row's job: plain list items for information, links for navigation and buttons for local actions. Styling a row as active or disabled does not supply those behaviors. A list group is not automatically a menu, tablist or listbox.
Select Overview or Activity to update a local detail and pressed state. Archive is a real disabled button. Switch bordered, flush or horizontal appearance; horizontal stacks on small screens. Filter to see matching rows or an explicit empty result. Filtering preserves the selected detail. Reset restores the defaults. The separate linked list goes to this guide's actual sections. All counts and records are fictitious; selection performs no request or navigation.
Fictitious local list. No navigation or request occurs when selecting an item.
Selected: Overview. Counts are fictitious.
Sample project summary. Filtering does not reset the selected record.
| Part | Purpose |
|---|---|
| List | ul/li structure for related sample sections. |
| Row control | Native button with name, pressed state and disabled behavior. |
| Supporting text | Short sample description below each label. |
| Badge | Fictitious count with a spoken unit. |
| Detail/status | Local selected record and feedback, independent of filtering. |
| Linked list | Separate real anchors to guide sections. |
ListGroupUsageDemo.vue has no props or emits. items is a fixed array of { id, label, count, description, disabled }. Overview has 3 items, Activity 12 and unavailable Archive 0. selected starts at overview; query is empty; variant starts bordered. filtered matches case-insensitive label substrings. active derives the selected record from the original array, so filtering does not silently change detail.
Clicking an enabled button changes selected. The native disabled Archive never runs that handler. Reset restores selection, query and appearance. There is no network, timer, storage or router mutation; unmount needs no cleanup. The linked anchors use browser navigation to this page's anatomy/source headings.
<script setup>
import ListGroupUsageDemo from './.vitepress/theme/ListGroupUsageDemo.vue'
</script>
<template><ListGroupUsageDemo /></template>For a dynamic host, keep stable IDs and decide what happens when the selected record is removed or disabled. A navigation record might use { id, label, href, current }, not the same API as a local action record. Those are integration models, not verified package exports.
| Source | Actual implementation |
|---|---|
| Lustro UI kit, Components, Lustro guide | Static ul/li rows with descriptive text and badges. They are not a shared interactive selection API. |
| Lustro expanded, Felix expanded, Scopecraft expanded | .lg-list/.it div specimens for active, disabled, contextual colors, badge, horizontal and flush. The bsx handler targets other anchor patterns, not these .it div rows; do not promise these specimens navigate or enforce disabled state. |
| Lumen expanded | Gallery iframe supplies the rendered examples. A heading alone does not prove a live linked-list controller. |
| Bastion lists | Native ul/li log-text specimens, no row actions. |
| Studio catalogs | Catalog shows static rich notification/list items. Extended has native action buttons, a real disabled button and local notice changes; the active class is presentation, not a selection manager. |
| Pulsefit HTML | Anchor specimens use href=# and active/disabled classes, plus static contextual rows. Inspect actual navigation and disabled handling before reuse; styling is not an application destination or a native disabled anchor. |
This guide adds a separate local example. Preserve each source's tokens and actual semantics rather than assuming a universal ListGroup component API.
The guide changes row background over 150ms; reduced motion removes that transition. Selection/focus updates are immediate and independent of motion. Tab reaches enabled native buttons; Enter/Space selects. No custom arrow-key behavior is claimed because this is an ordinary list of buttons, not a composite widget. Linked rows keep normal link keyboard behavior.
Test selection, disabled nonactivation, badges, filter/no-match/reset, preserved detail, all appearances, mobile stacking and actual section links. Check visible focus, text wrapping and reduced motion. Do not make an entire rich row an ambiguous click target containing unrelated nested controls. Validate the intended screen-reader pattern when adapting to a menu or selection widget.
Use stable keys, validate destinations, preserve useful focus after updates and do not apply stale results to a new selection. Sanitize external row text. Keep count units and unavailable reasons visible. Every record and count here is fictitious and local.
Open a detail panel without losing the page behind it. This shared pattern follows the current template's colors. Fictitious data; actions stay local.