Action menu

A dropdown is triggered by the interaction with a button or other control. Once displayed, the action dropdown presents users with a list of actions they can perform. The list can be as simple as a few actions, or as complex as a three-section menu with headings and a search bar.

UX/UI Guidelines

Check the design documentation of the component in ZeroHeight.

Implementations

The component ActionMenu is available in the following technologies:

CSS Components

Web Components

Parameters

Parameters

Parameters are the attributes that can be used to customize the component when using it in a project. They apply to the WebComponents implementation and wrappers and to the Vue and React CSS implementations. Some parameters names change between the implementations, in order to follow the conventions of each technology and framework.

For example, the param model is named ngModel in Angular, modelValue in Vue, but stays as model in React.

By default, all the parameters are optional or can be set in different, except for the ones marked as required

The parametrization of the component can be done with the following custom params or properties:

Name	Type	Slottable	Description
config	string
content	string	✅	Text of the dropdown
elements	Object[]		Array of dropdown elements
custom	object		A record of key-value pairs to set the CSS custom tokens. It's a complex attribute set as an JS object in stringified JSON format. Example: <z-action-menu custom='{"fill":"#06e7a3"}' />
custom-str	string		The stringified version of the custom property. It follows the pattern key:value;key:value;, with the possibility of setting multiple values and spaces between the punctuation characters. Example: <z-action-menu custom-str="fill:#06e7a3" />
z-theme	string		Sets the theme of the component. The possible values are light and dark. <z-action-menu z-theme="dark" />

From Figma to code

You can check the Figma implementation here. The available properties are:

• Type (select)
• Section-02 (boolean)
• Section-03 (boolean)
• Search bar (boolean)
• Scroll bar (boolean)

With the nested instances:

• Section-01
• Section-02
• Section-03

Customization

INFO

Check everything about the customization mechanics in the "How it works" documentation.

CSS Variable	Type	Description
--z-action-menu--heading-color	color	Color of the section heading
--z-action-menu--color	color	Color for the action menu options
--z-action-menu--color--hover	color	Color for the action menu options on hover
--z-action-menu--bg	color	Background for the options in the action menu
--z-action-menu--bg--hover	color	Background for the options in the action menu on hover
--z-action-menu--radius	distance	Border radius of the action menu
--z-action-menu--shadow	shadow	Shadow of the action menu

The color and background of the action menu options can be customized using the --z-action-menu--color ,--z-action-menu--bg and --z-action-menu--color--hover and --z-action-menu--bg--hover custom properties.

Also the heading color, radius and shadow of the action menu can be customized using the --z-action-menu--heading--color, --z-action-menu--radius and --z-action-menu--shadow custom properties.

Accessibility

...

Related components