Dropdown menu displays a list of actions or selectable options for a user. Dropdown uses popout component internally to create the overlay functionality.
Controls whether the toggle slot expands to fill the width of its container.
boolean
false
size
size
The size of the dropdown. This affects the minimum and maximum inline-size of the dropdown.
"s" | "m" | "l"
"m"
open
open
Controls whether the component is open or not.
boolean
false
align
align
Set the alignment in relation to the toggle (or anchor) depending on the position. start will align it to the left of the toggle (or anchor). end will align it to the right of the toggle (or anchor). Setting the position to inline-start or inline-end will switch start and end to the top and bottom respectively.
"start" | "end"
"start"
position
position
Set the position in relation to the toggle (or anchor). Options follow logical properties. block-start and block-end referring to top and bottom respectively, inline-start and inline-end referring to left and right respectively.
moveFocusToButton: A boolean option to move the focus to the original button that opens the dropdown.
Hide the dropdown programmatically. This method delegates to the Dropdown's internal Popout component. See Popout's hide() method for more details.
show() => Promise<TransitionEvent | void>
N/A
Show the dropdown programmatically. This method delegates to the Dropdown's internal Popout component. See Popout's show() method for more details.
CSS Properties
CSS Custom Properties provide more fine grain control over component presentation. We advise utilizing existing properties on the component before using these.
Property
Description
Default
--n-dropdown-size
Controls the inline size, or width, of the dropdown. Will resize up to 1.5 times to account for larger content.
Dropdown menus are typically used when you have 5-15 items to choose from. They’re used for navigation or commands, where an action is initiated based on the selection.
When organizing dropdown menu items, sort the list in a logical order by putting the most selected option at the top.
Use for a “more” menu, where the control contains an icon.
Use for user profiles, where the control is an avatar.
Dropdown items should be always written in sentence case, not title case. The first word should be capitalized and the rest lowercase (unless a proper noun):
Create user
Create User
Dropdown items should always lead with a strong verb that encourages action. Use the {verb}+{noun} format except in the case of common actions like Save, Close or Cancel:
Edit row
Editing options
Avoid unnecessary words and articles in dropdown items, such as “the”, “an” or “a”:
Change theme
Change the theme
Avoid ending dropdown items in punctuation:
Switch user
Switch user.
Avoid all caps for dropdown items:
Rename
RENAME
Keep dropdown items to a single line of text:
Change theme
Change the theme of the veterinary application.
Integration
For integration guidelines, please see Web Components documentation. This documentation explains how to implement and use Nord Web Components across different technologies such as Vue.js, React, or Vanilla JavaScript.
Integration Guidelines
Troubleshooting
If you experience any issues while using Nord Web Components, please head over to the Support page for more guidelines and ways to contact us.