Overlays

DropdownLabel

Non-interactive heading row that groups related dropdown-item rows inside a dropdown-menu.

import { DropdownLabel } from '@lostgradient/cinder/dropdown-label';
overlaymenu
01

Overview

Non-interactive section heading within a dropdown menu for grouping related items.

Usage

DropdownLabel is a compose-only leaf of Dropdown. The idiomatic API is Dropdown.Label, reached through the parent namespace — see the dropdown README for the composed snippet. The flat @lostgradient/cinder/dropdown-label subpath remains exported for à-la-carte builds that import the leaf directly.

02

When to use

Use when
  • Labeling a group of related menu items with a short heading.
  • Providing a visual section title above a cluster of dropdown-item rows.
Avoid when
  • Rendering a selectable row — use dropdown-item.
  • Visually dividing groups without a heading — use dropdown-separator.
03

Props

Props for dropdown-label
Name Type Default Required Bindable Description
children snippet