Repository navigation
Radial Menu 2.0
A ground-up rewrite on Lit 3 and TypeScript. Existing 1.6 configs keep working.
Fixed
- Size:
size: 100%now scales with the parent and stays square (#15). - Colors and transitions: items accept their own
color, and there are new theme variables for hover color, hover background and transition (#23). - Dead dependency: the unmaintained
mwc-rippledependency is gone (#24). Pressed items now dim instead of rippling. default_open: it works in panel views and when Home Assistant loads the card late (#26).- Docs: the README examples were corrected and now match real configs (#27).
New
- Layout:
start_angleandarclet a menu fan out as a half circle or any slice.sizeaccepts any CSS length or a number of pixels. - Outside click:
close_on_outside_clickcloses the menu on a click or tap anywhere outside it. It's on by default. - Entity state: items and the menu button with an
entitynow show the entity's state, such as on/off colors.iconstill sets the icon, andcoloroverrides the state color. - Actions:
perform-actionworks, and so does the 1.6service_datashape. - Visual editor: menu options and regular items can be edited in the dashboard editor.
card:items stay YAML-only. - Gestures: tap, hold and double tap are reworked. Hold fires after half a second, including touch long-presses. Sliding a finger off an item cancels the press.
- Theme variables:
--radial-menu-item-hover-color,--radial-menu-item-hover-backgroundand--radial-menu-transition.
Upgrading
- Centered cards: embedded
card:items are now centered on their position. In 1.6 they sat about 10px right and 25px down, so cards may shift slightly. - Outside click: a menu with
default_open: truethat should stay open now closes on an outside click. Setclose_on_outside_click: falseto keep the old behavior. - card-mod: each
card:item is wrapped in adiv.customthat holds its position. CSS targeting.customnow hits the wrapper, not the card.
Known limitation
An action's confirmation uses the browser's own prompt through custom-card-helpers. The Home Assistant companion app doesn't show that prompt, so the action doesn't run there. Use a script for confirmations in the app.
Requires Home Assistant 2024.1.0 or newer.