ki-sidebar-group
@kimen/elements/ki-sidebar-group- Source
- Agent reference
Place related destinations in a group inside a Sidebar. Its heading names the list in both expanded and collapsed modes.
<ki-sidebar label="Main"><ki-sidebar-group label="Workspace"> <ki-sidebar-item href="#members" current>Members</ki-sidebar-item> <ki-sidebar-item href="#billing">Billing</ki-sidebar-item></ki-sidebar-group></ki-sidebar>When to use: give related sidebar destinations a common heading.
When not to use: as a destination or outside ki-sidebar.
Properties & attributes
| Attribute | Property | Type | Default | Description |
|---|---|---|---|---|
label | label | string | – | Visible group heading and accessible name of the nested list. |
Slots
| Slot | Description |
|---|---|
| (default) | One or more ki-sidebar-item routes. |
CSS parts
| Part | Description |
|---|---|
heading | Group heading, visually hidden in the rail. |
list | List named by the group heading. |
CSS custom properties
The public styling contract of ki-sidebar-group: reassign these tokens at :root or on a subtree — never override internals.
| Token | Description |
|---|---|
--ki-sidebar-font-family | Typeface of sidebar controls and copy. |
--ki-sidebar-group-backdrop-filter | Complete backdrop filter behind the group heading. |
--ki-sidebar-group-bg | Group heading background. |
--ki-sidebar-group-bg-image | Optional image over the heading background. |
--ki-sidebar-group-fg | Group heading ink, with contrast-more support. |
--ki-sidebar-group-font-family | Group heading typeface. |
--ki-sidebar-group-font-size | Group heading font size. |
--ki-sidebar-group-gap | Space before a group of routes. |
--ki-sidebar-group-line-height | Group heading line height. |
--ki-sidebar-item-gap | Gap between rows. |
--ki-sidebar-item-padding | Inline inset of an expanded row. |
--ki-sidebar-item-weight | Weight of the navigation label. |