Dropdown

Example

Wrap both the dropdown's trigger element (such as an <i-button>) and the <i-dropdown-menu> inside a <i-dropdown> component. The dropdown component will always choose the first child element as a trigger and the last child element as the defined dropdown menu.

Dropdown Example

Placement

Trigger dropdown menus at the top, bottom, left or right of elements by adding the placement property to the parent <i-dropdown> element.

Each of the positions also has a -start or -end variant (top-start, top-end, bottom-start, bottom-end, etc.) that sets the dropdown to the start or end of the placement instead of centering it.

Dropdown Placement

Freeform Dropdown

You're not required to use any dropdown-specific components inside of <i-dropdown-menu>. You can add your own HTML markup without any issues. You might need additional size styles to constrain the content width

Freeform Dropdown

Trigger type

You can use the trigger property to trigger the dropdown on hover or click. By default, dropdowns are triggered on click, a design decision made to improve user experience.

Dropdown Trigger

Sizes

You're able to use the size modifier to control the size of your dropdown menus, using one of the available sizes: sm, md, and lg. The default size is set to md.

Dropdown Sizes

Variants

Inkline includes two predefined dropdown styles, each serving its own semantic purpose. You can set the style of a <i-dropdown-menu> using the variant property, which can have a value of light or dark. By default, dropdown menus use the light variant.

Dropdown Variants

Recursive Dropdowns

Inkline allows you to have virtually infinite recursive dropdown submenus structure by defining another <i-dropdown> inside of a <i-dropdown-menu>. This awesome feature gives you great design flexibility.

Recursive Dropdown

Components API

Here you can find a list of the various customization options you can use for the dropdown components as props, as well as available slots and events.

Dropdown API
Dropdown Menu API
Dropdown Item API

Sass Variables

Here you can find a list of the Sass variables you can use for the dropdown components. If you're looking to find common variables that these rely on, you should take a look at the Sass Variables page.

Dropdown