# Menu dropdown

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

## Overview

A container component that handles menu dropdown functionality and styling. Provides a flexible menu system with support for nested links, dropdowns, and featured content blocks. Uses Alpine.js for dropdown menu interactions and positioning, supports full-width dropdowns for specified menu columns, and handles nested menu items up to grandchild level.

## Common use cases

* Use for main navigation menus that require dropdowns
* Configure menu\_columns setting for full-width mega menus
* Add navigation images to enhance visual hierarchy
* Customize fonts and spacing to match site design
* Leverage blocks to add featured content in dropdowns

## Compatible blocks

The following blocks can be nested within this block:

* [Menu item](https://help.brickspacelab.com/slab/content/blocks/navigation/menus/menu-dropdown/menu-item)

## Block settings

### General

| Setting                | Description                                                                                 | Options                   |
| ---------------------- | ------------------------------------------------------------------------------------------- | ------------------------- |
| Show advanced settings | Reveals 10 advanced options including enable dropdown icons, enable click to open, and more | Checkbox (default: false) |

### Content

| Setting | Description                | Options                               |
| ------- | -------------------------- | ------------------------------------- |
| Menu    | Select the menu to display | Link list picker (default: main-menu) |

### Parent links

| Setting               | Description                                       | Options                                                                                                                                                           |
| --------------------- | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Font family           | Font family for parent menu links                 | <p>• Standard<br>• Heading<br>• Subheading<br>• Accent<br><br>Visible when parent font size contains type--</p>                                                   |
| Font size             | Font size for parent menu links                   | <p>• Smaller<br>• Small<br>• Default (default)<br>• Big<br>• Bigger<br>• Heading 1<br>• Heading 2<br>• Heading 3<br>• Heading 4<br>• Heading 5<br>• Heading 6</p> |
| Enable dropdown icons | Shows chevron icons for menu items with dropdowns | <p>Checkbox (default: true)<br><br>Visible when <strong>Show advanced settings</strong> is on</p>                                                                 |
| Enable click to open  | Opens dropdowns on click instead of hover only    | <p>Checkbox (default: false)<br><br>Visible when <strong>Show advanced settings</strong> is on</p>                                                                |
| Enable link as button | Converts parent links with children to buttons    | Checkbox (default: false)                                                                                                                                         |

### Child links

| Setting     | Description                      | Options                                                                                                                                                           |
| ----------- | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Font family | Font family for child menu links | <p>• Standard<br>• Heading<br>• Subheading<br>• Accent<br><br>Visible when child font size contains type--</p>                                                    |
| Font size   | Font size for child menu links   | <p>• Smaller<br>• Small<br>• Default (default)<br>• Big<br>• Bigger<br>• Heading 1<br>• Heading 2<br>• Heading 3<br>• Heading 4<br>• Heading 5<br>• Heading 6</p> |

### Grandchild links

| Setting     | Description                           | Options                                                                                                                                                           |
| ----------- | ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Font family | Font family for grandchild menu links | <p>• Standard<br>• Heading<br>• Subheading<br>• Accent<br><br>Visible when grandchild font size contains type--</p>                                               |
| Font size   | Font size for grandchild menu links   | <p>• Smaller<br>• Small<br>• Default (default)<br>• Big<br>• Bigger<br>• Heading 1<br>• Heading 2<br>• Heading 3<br>• Heading 4<br>• Heading 5<br>• Heading 6</p> |

### Dropdown

| Setting                 | Description                                                         | Options                                                                                                                                          |
| ----------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Layout                  | Layout style for dropdown menus                                     | <p>• Stacked (default)<br>• Inline</p>                                                                                                           |
| Enable internal padding | Adds internal padding to dropdown content                           | Checkbox (default: true)                                                                                                                         |
| Enable margin           | Applies margin for full-width dropdown columns                      | <p>Checkbox (default: true)<br><br>Visible when <strong>Menu columns</strong> is not blank and <strong>Show advanced settings</strong> is on</p> |
| Gap size                | Spacing between dropdown menu items                                 | <p>• None<br>• Default (default)<br>• XS<br>• SM<br>• MD<br>• LG<br>• XL</p>                                                                     |
| Menu columns            | Comma-separated list of menu items to display as full-width columns | Text input                                                                                                                                       |

### Dropdown colors

These settings appear in the theme editor when **Show advanced settings** is on. They control the dropdown panel surface.

| Setting            | Description                                     | Options                                                                                                                                                                                                                                                                                              |
| ------------------ | ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Type               | Custom scheme vs preset dropdown colors         | <p>• Custom<br>• Base (default)</p><p><br><br>Visible when <strong>Show advanced settings</strong> is on and <strong>Enable inheritance</strong> is off (dropdown colors)</p>                                                                                                                        |
| Color scheme       | Background and text pairing                     | <p>Color scheme picker<br><br>Visible when dropdown type is <strong>Custom</strong>, <strong>Show advanced settings</strong> is on, and <strong>Enable inheritance</strong> is off (dropdown colors)</p>                                                                                             |
| Color scheme       | Preset background pairing                       | <p>• Body background (default)<br>• Body foreground<br>• Accent 1–3<br>• Shade 1–3<br>• Blur<br>• Transparent</p><p><br><br>Visible when dropdown type is <strong>Base</strong>, <strong>Show advanced settings</strong> is on, and <strong>Enable inheritance</strong> is off (dropdown colors)</p> |
| Border             | Dropdown panel border                           | <p>• None<br>• Subtle (default)<br>• Strong</p><p><br><br>Visible when <strong>Show advanced settings</strong> is on, dropdown type is <strong>Base</strong>, and <strong>Enable inheritance</strong> is off (dropdown colors)</p>                                                                   |
| Divider            | Divider between stacked dropdown items          | <p>• None<br>• Subtle (default)<br>• Strong</p><p><br><br>Visible when <strong>Show advanced settings</strong> is on, dropdown type is <strong>Base</strong>, and <strong>Enable inheritance</strong> is off (dropdown colors)</p>                                                                   |
| Enable inheritance | Inherit dropdown colors from the closest parent | <p>Checkbox (default: false)<br><br>Visible when <strong>Show advanced settings</strong> is on</p>                                                                                                                                                                                                   |

### Link colors

These settings appear when **Show advanced settings** is on. They control parent, child, and grandchild link text colors.

| Setting            | Description                                 | Options                                                                                                                                                                                                                                                                 |
| ------------------ | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Type               | Custom scheme vs preset link text colors    | <p>• Custom<br>• Base (default)</p><p><br><br>Visible when <strong>Show advanced settings</strong> is on and <strong>Enable inheritance</strong> is off (link colors)</p>                                                                                               |
| Text               | Text color pairing                          | <p>Color scheme picker<br><br>Visible when link type is <strong>Custom</strong>, <strong>Show advanced settings</strong> is on, and <strong>Enable inheritance</strong> is off (link colors)</p>                                                                        |
| Text               | Preset text color                           | <p>• Default (default)<br>• Alternative<br>• Link<br>• Error<br>• Success<br>• Shade 1–3</p><p><br><br>Visible when link type is <strong>Base</strong>, <strong>Show advanced settings</strong> is on, and <strong>Enable inheritance</strong> is off (link colors)</p> |
| Enable inheritance | Inherit link colors from the closest parent | <p>Checkbox (default: true)<br><br>Visible when <strong>Show advanced settings</strong> is on</p>                                                                                                                                                                       |

### Spacing

| Setting                   | Description                                 | Options                                                                      |
| ------------------------- | ------------------------------------------- | ---------------------------------------------------------------------------- |
| Top spacing               | Padding space at the top of parent links    | 0 - 30 px (default: 15)                                                      |
| Bottom spacing            | Padding space at the bottom of parent links | 0 - 30 px (default: 15)                                                      |
| Enable horizontal padding | Adds horizontal padding around the menu     | Checkbox (default: false)                                                    |
| Gap size                  | Spacing between menu items                  | <p>• None<br>• Default (default)<br>• XS<br>• SM<br>• MD<br>• LG<br>• XL</p> |

### Layout

| Setting              | Description                               | Options                                        |
| -------------------- | ----------------------------------------- | ---------------------------------------------- |
| Horizontal alignment | Controls horizontal alignment of the menu | <p>• Left (default)<br>• Center<br>• Right</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> |
