Skip to content
Kimenpre-v1documentation home
Color scheme

ki-fab-menu-item

Place this element directly inside a ki-fab-menu. Use its default slot for a short, visible action label and icon-name for a decorative glyph. Provide href for native navigation or handle the menu’s ki-select event for commands. Set value when a command needs a stable identifier across translations.

When to use: as a direct child of ki-fab-menu, with a short, visible action label.

When not to use: for a standalone action, a form control, or a container of interactive content.

Properties & attributes

AttributePropertyTypeDefaultDescription
hrefhrefstring | undefined–A nonempty destination renders a native link and preserves relative URL resolution.
icon-nameiconNamestring | undefined–Registered Lucide glyph. Import the desired icon before rendering.
valuevaluestring | undefined–Stable selection identifier. When omitted, the menu reports the trimmed visible label.

Events

EventDetail typeDescription
ki-selectCustomEvent<KiFabMenuSelectDetail>Local command selection for a direct action binding. Links use native navigation.

Slots

SlotDescription
(default)The visible action label.

CSS parts

PartDescription
controlThe native action button or link.
iconThe decorative glyph next to the label.

CSS custom properties

The public styling contract of ki-fab-menu-item: reassign these tokens at :root or on a subtree — never override internals.

TokenDescription
--ki-density-target-minThe smallest pointer target any density may produce: 24 x 24 CSS px by default and in compact (WCAG 2.5.8 AA), 44 x 44 in touch (WCAG 2.5.5). It floors a shrinking control but never lifts what a control paints: a control painted smaller extends its target to it, invisibly; rows and tabs grow to it (spec 045 A1).
--ki-fab-forced-colors-border-widthBoundary width for the FAB in forced colors.
--ki-fab-menu-item-backdrop-filterComplete optional filter behind the action.
--ki-fab-menu-item-bgTinted surface of a floating action.
--ki-fab-menu-item-bg-imageOptional image painted above the action fill.
--ki-fab-menu-item-content-gapSpace between the action glyph and label.
--ki-fab-menu-item-fgLabel and icon ink on the tinted action surface.
--ki-fab-menu-item-font-familyTypeface for action labels.
--ki-fab-menu-item-font-sizeText size for action labels.
--ki-fab-menu-item-font-weightText weight of an action label.
--ki-fab-menu-item-heightMinimum block size and inline target of an action.
--ki-fab-menu-item-hover-shadowElevation of a hovered action.
--ki-fab-menu-item-icon-sizeSize of the glyph preceding an action label.
--ki-fab-menu-item-line-heightLine height of an action label.
--ki-fab-menu-item-padding-blockBlock padding for a wrapping action label.
--ki-fab-menu-item-padding-endInline-end padding of an action.
--ki-fab-menu-item-padding-startInline-start padding of an action.
--ki-fab-menu-item-radiusPill radius of an action.
--ki-fab-menu-item-shadowElevation of a resting action.
--ki-focus-ring-colorColour of the keyboard focus ring every focusable component draws: 3:1 or more against the page in every theme and scheme.
--ki-focus-ring-offsetGap between a focusable component and its keyboard focus ring.
--ki-focus-ring-widthThickness of the keyboard focus ring every focusable component draws (its outline). One token instead of one per component, so a mode or a theme changes every ring at once.