> ## Documentation Index
> Fetch the complete documentation index at: https://help.standards.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Dropdown

Dropdowns are flexible elements used to organize other elements. They are similar to Buttons in that they can be styled in many ways, but additionally they can show and hide their contents.

<Frame>
  <img src="https://mintcdn.com/standards/S7mbK4aPO1b_SIXF/images/dropdown-example.gif?s=96a9a06cb99198be627e5c2ca72d1e0d" alt="Various design examples of dropdowns in use for menu groups and accordions" width="1200" height="600" data-path="images/dropdown-example.gif" />
</Frame>

***

## Dropdown basics

**Dropdowns** are an element that can be added to your project layout and menu, and consists of four + parts: the **dropdown** container, the **controls** container, **text** content in controls, and the **icon** content in controls. Additional elements can be added into Dropdowns, such at **Text** and **Media**.

### Adding dropdowns

<Frame>
  <img src="https://mintcdn.com/standards/Tc_43o4c3o0PZCiL/images/dropdown-add-menu.png?fit=max&auto=format&n=Tc_43o4c3o0PZCiL&q=85&s=9cdbf49d571aa4b33f0439051f2e8520" alt="Add menu dropdown open showing a list of all options" width="1200" height="600" data-path="images/dropdown-add-menu.png" />
</Frame>

<Steps>
  <Step title="Select the dropdown add tool">
    From within the editor, select **Dropdown** from the `+` menu in the top bar, or use the hotkey <kbd>D</kbd>
  </Step>

  <Step title="Add dropdown">
    Select a point in the project body by selecting between layouts, click + dragging within, or selecting a point inside a column.
  </Step>

  <Step title="Add items within">
    To nest content inside a dropdown, select the dropdown first, then use the `+` menu to add content the same way you would anywhere else.
  </Step>
</Steps>

### Dropdown states

**Dropdowns** have a range of states that can be styled individually, or synced together. Both closed and open have rest and hover states.

* **Closed:** All content other than **controls** are hidden.
* **Open:** All content is exposed.

### Settings within dropdown states

Each state can have fill and stroke settings altered independently from another, or synced together.

***

## Controls

**Controls** are an essential part of **dropdowns** with their own settings. **Controls** share many similarities with **buttons**, but are special because they trigger open & close behaviors on the **dropdown.**

### Controls settings

While selecting the **controls** part of a **dropdown**, the right sidebar will display the available settings for styling them.

### Controls states

**Controls** have a range of states that can be styled individually, or synced together. Both open and closed have rest and hover states.

* **Closed:** When the **dropdown** is closed.
* **Open:** When the **dropdown** is open.

***

## Dropdown behavior settings

Dropdowns can be used for a wide range of applications, and much of their core behavior is controlled within the settings accessed from the in-body toolbar.

<Frame>
  <img src="https://mintcdn.com/standards/k0vlOjFwa-BsNrBE/images/dropdown-in-body-toolbar-1.png?fit=max&auto=format&n=k0vlOjFwa-BsNrBE&q=85&s=e2aa99eed5b1eef39275acdd98e87dcc" alt="Dropdown In Body Toolbar" width="1800" height="900" data-path="images/dropdown-in-body-toolbar-1.png" />
</Frame>

### Open on pages

When on, the dropdown will stay open if an item within is linked to a page that the viewer is currently viewing. This is great for navigations where the page and page sections are linked.

### Active on pages

Similar to open on pages, enabling active on pages will show the active state of the dropdown if an item within is linked to a page that the viewer is currently viewing.

### Always open

The state of the dropdown will stay in open.

### Open over content

When opened, the dropdown will show over content below it. This is ideal when using dropdowns in-body. When turned off, dropdowns will push content down when open, often preferred in navigation menus.

***

## Examples

**Dropdowns** have a wide range of use. Here are common uses:

<Frame>
  <img src="https://mintcdn.com/standards/S7mbK4aPO1b_SIXF/images/dropdown-01.gif?s=52e22cb43aa1cf06b9e73372daf06a2f" alt="Menu group showing and hiding menu items within" width="1200" height="600" data-path="images/dropdown-01.gif" />
</Frame>

### Menu groups

Building menus with **dropdowns** is a great way to create grouping related items together. For example, a **dropdown** could contain links to the sections of a page, or links to multiple pages in a section.

<Frame>
  <img src="https://mintcdn.com/standards/S7mbK4aPO1b_SIXF/images/accordion-01.gif?s=cd73ecf755a78c51de8eb3366f41c6a0" alt="Accordion showing and hiding a paragraph within" width="1200" height="600" data-path="images/accordion-01.gif" />
</Frame>

### Accordions

**Dropdowns** can be used throughout the main body of Standards sites, and used to show and hide content within.
