# Dropdown

<figure><img src="https://3723856256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGnixyIfIYFWroNtVmZo6%2Fuploads%2Fgit-blob-0b240e5cedf4767c695b8f077a2c7eccb565b768%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Overview

A customizable dropdown overlay component that creates an accessible, animated dropdown menu triggered by a button. Provides flexible positioning, styling, and responsive behavior options.

## Common use cases

* Create navigation menus with dropdown submenus
* Build interactive forms with dropdown options
* Display additional content on hover or click
* Organize related content in collapsible dropdowns
* Create mobile-friendly navigation patterns

## Compatible blocks

The following blocks can be nested within this block:

* [Container](https://help.brickspacelab.com/slab/content/blocks/layout/container)

## Block settings

### General

| Setting                | Description                                                           | Options                   |
| ---------------------- | --------------------------------------------------------------------- | ------------------------- |
| Show advanced settings | Reveals direction, horizontal position, show on hover, and visibility | Checkbox (default: false) |

### Spacing

| Setting                   | Description                                   | Options                   |
| ------------------------- | --------------------------------------------- | ------------------------- |
| Enable horizontal padding | Adds horizontal padding inside the container  | Checkbox (default: false) |
| Enable top padding        | Adds top padding                              | Checkbox (default: false) |
| Enable bottom padding     | Adds bottom padding                           | Checkbox (default: false) |
| Enable internal padding   | Adds padding inside the dropdown content area | Checkbox (default: true)  |

### Layout

| Setting              | Description                                                             | Options                                                                                                                 |
| -------------------- | ----------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| Width                | Controls the width of the dropdown                                      | 100 - 400 px (default: 130)                                                                                             |
| Direction            | Controls whether the dropdown opens up or down                          | <p>• Up (default)<br>• Down</p><p><br><br>Visible when <strong>Show advanced settings</strong> is on</p>                |
| Horizontal position  | Controls horizontal positioning of the dropdown relative to the trigger | <p>• Left (default)<br>• Center<br>• Right</p><p><br><br>Visible when <strong>Show advanced settings</strong> is on</p> |
| Horizontal alignment | Controls horizontal alignment of the dropdown trigger                   | <p>• Left (default)<br>• Center<br>• Right</p>                                                                          |
| Show on hover        | Only displays the dropdown on hover                                     | <p>Checkbox (default: false)<br><br>Visible when <strong>Show advanced settings</strong> is on</p>                      |

### Display

| Setting    | Description                        | Options                                                                                                                            |
| ---------- | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Visibility | Controls when the block is visible | <p>• All (default)<br>• Mobile only<br>• Desktop only</p><p><br><br>Visible when <strong>Show advanced settings</strong> is on</p> |