menubar

A visually persistent bar of command menus, as found in desktop applications.

PreviousNext
import { ChangeDetectionStrategy, Component, signal } from '@angular/core';

import { ZardMenubarImports } from '@/shared/components/menubar/menubar.imports';

@Component({
  selector: 'z-demo-menubar-preview',
  imports: [ZardMenubarImports],
  template: `
    <z-menubar class="w-72">
      <button type="button" z-menubar-trigger [zMenubarMenu]="fileMenu">File</button>
      <button type="button" z-menubar-trigger [zMenubarMenu]="editMenu">Edit</button>
      <button type="button" z-menubar-trigger [zMenubarMenu]="viewMenu">View</button>
      <button type="button" z-menubar-trigger [zMenubarMenu]="profilesMenu">Profiles</button>
    </z-menubar>

    <z-dropdown-menu-content #fileMenu="zDropdownMenuContent">
      <z-dropdown-menu-group>
        <z-dropdown-menu-item>
          New Tab
          <z-dropdown-menu-shortcut>⌘T</z-dropdown-menu-shortcut>
        </z-dropdown-menu-item>
        <z-dropdown-menu-item>
          New Window
          <z-dropdown-menu-shortcut>⌘N</z-dropdown-menu-shortcut>
        </z-dropdown-menu-item>
        <z-dropdown-menu-item zDisabled>New Incognito Window</z-dropdown-menu-item>
      </z-dropdown-menu-group>
      <z-dropdown-menu-separator />
      <z-dropdown-menu-sub-trigger [zSubMenu]="shareMenu">Share</z-dropdown-menu-sub-trigger>
      <z-dropdown-menu-sub-content #shareMenu="zDropdownMenuSubContent">
        <z-dropdown-menu-item>Email link</z-dropdown-menu-item>
        <z-dropdown-menu-item>Messages</z-dropdown-menu-item>
        <z-dropdown-menu-item>Notes</z-dropdown-menu-item>
      </z-dropdown-menu-sub-content>
      <z-dropdown-menu-separator />
      <z-dropdown-menu-item>
        Print...
        <z-dropdown-menu-shortcut>⌘P</z-dropdown-menu-shortcut>
      </z-dropdown-menu-item>
    </z-dropdown-menu-content>

    <z-dropdown-menu-content #editMenu="zDropdownMenuContent">
      <z-dropdown-menu-group>
        <z-dropdown-menu-item>
          Undo
          <z-dropdown-menu-shortcut>⌘Z</z-dropdown-menu-shortcut>
        </z-dropdown-menu-item>
        <z-dropdown-menu-item>
          Redo
          <z-dropdown-menu-shortcut>⇧⌘Z</z-dropdown-menu-shortcut>
        </z-dropdown-menu-item>
      </z-dropdown-menu-group>
      <z-dropdown-menu-separator />
      <z-dropdown-menu-sub-trigger [zSubMenu]="findMenu">Find</z-dropdown-menu-sub-trigger>
      <z-dropdown-menu-sub-content #findMenu="zDropdownMenuSubContent">
        <z-dropdown-menu-item>Search the web</z-dropdown-menu-item>
        <z-dropdown-menu-separator />
        <z-dropdown-menu-item>Find...</z-dropdown-menu-item>
        <z-dropdown-menu-item>Find Next</z-dropdown-menu-item>
        <z-dropdown-menu-item>Find Previous</z-dropdown-menu-item>
      </z-dropdown-menu-sub-content>
      <z-dropdown-menu-separator />
      <z-dropdown-menu-group>
        <z-dropdown-menu-item>Cut</z-dropdown-menu-item>
        <z-dropdown-menu-item>Copy</z-dropdown-menu-item>
        <z-dropdown-menu-item>Paste</z-dropdown-menu-item>
      </z-dropdown-menu-group>
    </z-dropdown-menu-content>

    <z-dropdown-menu-content #viewMenu="zDropdownMenuContent" class="w-44">
      <z-dropdown-menu-group>
        <z-dropdown-menu-checkbox-item [(zChecked)]="bookmarksBar">Bookmarks Bar</z-dropdown-menu-checkbox-item>
        <z-dropdown-menu-checkbox-item [(zChecked)]="fullUrls">Full URLs</z-dropdown-menu-checkbox-item>
      </z-dropdown-menu-group>
      <z-dropdown-menu-separator />
      <z-dropdown-menu-group>
        <z-dropdown-menu-item zInset>
          Reload
          <z-dropdown-menu-shortcut>⌘R</z-dropdown-menu-shortcut>
        </z-dropdown-menu-item>
        <z-dropdown-menu-item zInset zDisabled>
          Force Reload
          <z-dropdown-menu-shortcut>⇧⌘R</z-dropdown-menu-shortcut>
        </z-dropdown-menu-item>
      </z-dropdown-menu-group>
      <z-dropdown-menu-separator />
      <z-dropdown-menu-item zInset>Toggle Fullscreen</z-dropdown-menu-item>
      <z-dropdown-menu-separator />
      <z-dropdown-menu-item zInset>Hide Sidebar</z-dropdown-menu-item>
    </z-dropdown-menu-content>

    <z-dropdown-menu-content #profilesMenu="zDropdownMenuContent">
      <z-dropdown-menu-radio-group [(zValue)]="profile">
        <z-dropdown-menu-radio-item zValue="andy">Andy</z-dropdown-menu-radio-item>
        <z-dropdown-menu-radio-item zValue="benoit">Benoit</z-dropdown-menu-radio-item>
        <z-dropdown-menu-radio-item zValue="luis">Luis</z-dropdown-menu-radio-item>
      </z-dropdown-menu-radio-group>
      <z-dropdown-menu-separator />
      <z-dropdown-menu-item zInset>Edit...</z-dropdown-menu-item>
      <z-dropdown-menu-separator />
      <z-dropdown-menu-item zInset>Add Profile...</z-dropdown-menu-item>
    </z-dropdown-menu-content>
  `,
  changeDetection: ChangeDetectionStrategy.OnPush,
})
export class ZardDemoMenubarPreviewComponent {
  protected readonly bookmarksBar = signal(false);
  protected readonly fullUrls = signal(true);
  protected readonly profile = signal('benoit');
}

Installation

Copy
npx zard-cli@latest add menubar

Usage

import { ZardMenubarImports } from '@/shared/components/menubar/menubar.imports';
Copy
<z-menubar>
  <button type="button" z-menubar-trigger [zMenubarMenu]="fileMenu">File</button>
  <button type="button" z-menubar-trigger [zMenubarMenu]="editMenu">Edit</button>
</z-menubar>

<z-dropdown-menu-content #fileMenu="zDropdownMenuContent" class="w-56">
  <z-dropdown-menu-item>
    New Tab
    <z-dropdown-menu-shortcut>⌘T</z-dropdown-menu-shortcut>
  </z-dropdown-menu-item>
  <z-dropdown-menu-item>New Window</z-dropdown-menu-item>
  <z-dropdown-menu-separator />
  <z-dropdown-menu-item>Print...</z-dropdown-menu-item>
</z-dropdown-menu-content>

<z-dropdown-menu-content #editMenu="zDropdownMenuContent" class="w-56">
  <z-dropdown-menu-item>Undo</z-dropdown-menu-item>
  <z-dropdown-menu-item>Redo</z-dropdown-menu-item>
</z-dropdown-menu-content>
Copy

Examples

Checkbox

Use z-dropdown-menu-checkbox-item for toggleable options.
import { ChangeDetectionStrategy, Component, signal } from '@angular/core';

import { ZardMenubarImports } from '@/shared/components/menubar/menubar.imports';

@Component({
  selector: 'z-demo-menubar-checkbox',
  imports: [ZardMenubarImports],
  template: `
    <z-menubar class="w-72">
      <button type="button" z-menubar-trigger [zMenubarMenu]="viewMenu">View</button>
      <button type="button" z-menubar-trigger [zMenubarMenu]="formatMenu">Format</button>
    </z-menubar>

    <z-dropdown-menu-content #viewMenu="zDropdownMenuContent" class="w-64">
      <z-dropdown-menu-checkbox-item [(zChecked)]="showBookmarks">
        Always Show Bookmarks Bar
      </z-dropdown-menu-checkbox-item>
      <z-dropdown-menu-checkbox-item [(zChecked)]="showFullUrls">Always Show Full URLs</z-dropdown-menu-checkbox-item>
      <z-dropdown-menu-separator />
      <z-dropdown-menu-item zInset>
        Reload
        <z-dropdown-menu-shortcut>⌘R</z-dropdown-menu-shortcut>
      </z-dropdown-menu-item>
      <z-dropdown-menu-item zInset zDisabled>
        Force Reload
        <z-dropdown-menu-shortcut>⇧⌘R</z-dropdown-menu-shortcut>
      </z-dropdown-menu-item>
    </z-dropdown-menu-content>

    <z-dropdown-menu-content #formatMenu="zDropdownMenuContent">
      <z-dropdown-menu-checkbox-item [(zChecked)]="strikethrough">Strikethrough</z-dropdown-menu-checkbox-item>
      <z-dropdown-menu-checkbox-item [(zChecked)]="code">Code</z-dropdown-menu-checkbox-item>
      <z-dropdown-menu-checkbox-item [(zChecked)]="superscript">Superscript</z-dropdown-menu-checkbox-item>
    </z-dropdown-menu-content>
  `,
  changeDetection: ChangeDetectionStrategy.OnPush,
})
export class ZardDemoMenubarCheckboxComponent {
  protected readonly showBookmarks = signal(false);
  protected readonly showFullUrls = signal(true);
  protected readonly strikethrough = signal(true);
  protected readonly code = signal(false);
  protected readonly superscript = signal(false);
}

Radio

Use z-dropdown-menu-radio-group with z-dropdown-menu-radio-item for exclusive choices.
import { ChangeDetectionStrategy, Component, signal } from '@angular/core';

import { ZardMenubarImports } from '@/shared/components/menubar/menubar.imports';

@Component({
  selector: 'z-demo-menubar-radio',
  imports: [ZardMenubarImports],
  template: `
    <z-menubar class="w-72">
      <button type="button" z-menubar-trigger [zMenubarMenu]="profilesMenu">Profiles</button>
      <button type="button" z-menubar-trigger [zMenubarMenu]="themeMenu">Theme</button>
    </z-menubar>

    <z-dropdown-menu-content #profilesMenu="zDropdownMenuContent">
      <z-dropdown-menu-radio-group [(zValue)]="user">
        <z-dropdown-menu-radio-item zValue="andy">Andy</z-dropdown-menu-radio-item>
        <z-dropdown-menu-radio-item zValue="benoit">Benoit</z-dropdown-menu-radio-item>
        <z-dropdown-menu-radio-item zValue="luis">Luis</z-dropdown-menu-radio-item>
      </z-dropdown-menu-radio-group>
      <z-dropdown-menu-separator />
      <z-dropdown-menu-item zInset>Edit...</z-dropdown-menu-item>
      <z-dropdown-menu-item zInset>Add Profile...</z-dropdown-menu-item>
    </z-dropdown-menu-content>

    <z-dropdown-menu-content #themeMenu="zDropdownMenuContent">
      <z-dropdown-menu-radio-group [(zValue)]="theme">
        <z-dropdown-menu-radio-item zValue="light">Light</z-dropdown-menu-radio-item>
        <z-dropdown-menu-radio-item zValue="dark">Dark</z-dropdown-menu-radio-item>
        <z-dropdown-menu-radio-item zValue="system">System</z-dropdown-menu-radio-item>
      </z-dropdown-menu-radio-group>
    </z-dropdown-menu-content>
  `,
  changeDetection: ChangeDetectionStrategy.OnPush,
})
export class ZardDemoMenubarRadioComponent {
  protected readonly user = signal('benoit');
  protected readonly theme = signal('system');
}

Submenu

Use z-dropdown-menu-sub-trigger with a z-dropdown-menu-sub-content to nest secondary actions.
import { ChangeDetectionStrategy, Component } from '@angular/core';

import { ZardMenubarImports } from '@/shared/components/menubar/menubar.imports';

@Component({
  selector: 'z-demo-menubar-submenu',
  imports: [ZardMenubarImports],
  template: `
    <z-menubar class="w-72">
      <button type="button" z-menubar-trigger [zMenubarMenu]="fileMenu">File</button>
      <button type="button" z-menubar-trigger [zMenubarMenu]="editMenu">Edit</button>
    </z-menubar>

    <z-dropdown-menu-content #fileMenu="zDropdownMenuContent">
      <z-dropdown-menu-sub-trigger [zSubMenu]="shareMenu">Share</z-dropdown-menu-sub-trigger>
      <z-dropdown-menu-sub-content #shareMenu="zDropdownMenuSubContent">
        <z-dropdown-menu-item>Email link</z-dropdown-menu-item>
        <z-dropdown-menu-item>Messages</z-dropdown-menu-item>
        <z-dropdown-menu-item>Notes</z-dropdown-menu-item>
      </z-dropdown-menu-sub-content>
      <z-dropdown-menu-separator />
      <z-dropdown-menu-item>
        Print...
        <z-dropdown-menu-shortcut>⌘P</z-dropdown-menu-shortcut>
      </z-dropdown-menu-item>
    </z-dropdown-menu-content>

    <z-dropdown-menu-content #editMenu="zDropdownMenuContent">
      <z-dropdown-menu-item>
        Undo
        <z-dropdown-menu-shortcut>⌘Z</z-dropdown-menu-shortcut>
      </z-dropdown-menu-item>
      <z-dropdown-menu-item>
        Redo
        <z-dropdown-menu-shortcut>⇧⌘Z</z-dropdown-menu-shortcut>
      </z-dropdown-menu-item>
      <z-dropdown-menu-separator />
      <z-dropdown-menu-sub-trigger [zSubMenu]="findMenu">Find</z-dropdown-menu-sub-trigger>
      <z-dropdown-menu-sub-content #findMenu="zDropdownMenuSubContent">
        <z-dropdown-menu-item>Find...</z-dropdown-menu-item>
        <z-dropdown-menu-item>Find Next</z-dropdown-menu-item>
        <z-dropdown-menu-item>Find Previous</z-dropdown-menu-item>
      </z-dropdown-menu-sub-content>
      <z-dropdown-menu-separator />
      <z-dropdown-menu-item>Cut</z-dropdown-menu-item>
      <z-dropdown-menu-item>Copy</z-dropdown-menu-item>
      <z-dropdown-menu-item>Paste</z-dropdown-menu-item>
    </z-dropdown-menu-content>
  `,
  changeDetection: ChangeDetectionStrategy.OnPush,
})
export class ZardDemoMenubarSubmenuComponent {}

Icons

Place an icon before the label of an item; zType="destructive" marks a dangerous action.
import { ChangeDetectionStrategy, Component } from '@angular/core';

import { NgIcon, provideIcons } from '@ng-icons/core';
import { lucideCircleHelp, lucideFile, lucideFolder, lucideSave, lucideSettings, lucideTrash } from '@ng-icons/lucide';

import { ZardMenubarImports } from '@/shared/components/menubar/menubar.imports';

@Component({
  selector: 'z-demo-menubar-icons',
  imports: [ZardMenubarImports, NgIcon],
  template: `
    <z-menubar class="w-72">
      <button type="button" z-menubar-trigger [zMenubarMenu]="fileMenu">File</button>
      <button type="button" z-menubar-trigger [zMenubarMenu]="moreMenu">More</button>
    </z-menubar>

    <z-dropdown-menu-content #fileMenu="zDropdownMenuContent">
      <z-dropdown-menu-item>
        <ng-icon name="lucideFile" />
        New File
        <z-dropdown-menu-shortcut>⌘N</z-dropdown-menu-shortcut>
      </z-dropdown-menu-item>
      <z-dropdown-menu-item>
        <ng-icon name="lucideFolder" />
        Open Folder
      </z-dropdown-menu-item>
      <z-dropdown-menu-separator />
      <z-dropdown-menu-item>
        <ng-icon name="lucideSave" />
        Save
        <z-dropdown-menu-shortcut>⌘S</z-dropdown-menu-shortcut>
      </z-dropdown-menu-item>
    </z-dropdown-menu-content>

    <z-dropdown-menu-content #moreMenu="zDropdownMenuContent">
      <z-dropdown-menu-group>
        <z-dropdown-menu-item>
          <ng-icon name="lucideSettings" />
          Settings
        </z-dropdown-menu-item>
        <z-dropdown-menu-item>
          <ng-icon name="lucideCircleHelp" />
          Help
        </z-dropdown-menu-item>
        <z-dropdown-menu-separator />
        <z-dropdown-menu-item zType="destructive">
          <ng-icon name="lucideTrash" />
          Delete
        </z-dropdown-menu-item>
      </z-dropdown-menu-group>
    </z-dropdown-menu-content>
  `,
  changeDetection: ChangeDetectionStrategy.OnPush,
  viewProviders: [
    provideIcons({ lucideFile, lucideFolder, lucideSave, lucideSettings, lucideCircleHelp, lucideTrash }),
  ],
})
export class ZardDemoMenubarIconsComponent {}

RTL

To enable RTL support in zard/ui, see the RTL configuration guide.
// You will notice this example is rendered inside a wrapper that sets the dir and data-lang attributes, and
// reads its text from a translations helper. This is because this site is not RTL by default.
// In your application you won't need either: set dir="rtl" on <html> (or use the CDK Dir directive on a subtree)
// and write the text of your own language. See the RTL guide: https://zardui.com/docs/rtl

import { ChangeDetectionStrategy, Component, signal } from '@angular/core';

import { ZardMenubarImports } from '@/shared/components/menubar/menubar.imports';
import { injectRtlTranslation, type ZardRtlTranslations } from '@/shared/demo-utils/rtl-translation';

interface MenubarRtlValues {
  file: string;
  edit: string;
  view: string;
  profiles: string;
  newTab: string;
  newWindow: string;
  share: string;
  emailLink: string;
  messages: string;
  print: string;
  undo: string;
  redo: string;
  cut: string;
  copy: string;
  paste: string;
  showBookmarks: string;
  showFullUrls: string;
  andy: string;
  benoit: string;
  luis: string;
}

const translations: ZardRtlTranslations<MenubarRtlValues> = {
  en: {
    dir: 'ltr',
    values: {
      file: 'File',
      edit: 'Edit',
      view: 'View',
      profiles: 'Profiles',
      newTab: 'New Tab',
      newWindow: 'New Window',
      share: 'Share',
      emailLink: 'Email link',
      messages: 'Messages',
      print: 'Print...',
      undo: 'Undo',
      redo: 'Redo',
      cut: 'Cut',
      copy: 'Copy',
      paste: 'Paste',
      showBookmarks: 'Always Show Bookmarks Bar',
      showFullUrls: 'Always Show Full URLs',
      andy: 'Andy',
      benoit: 'Benoit',
      luis: 'Luis',
    },
  },
  ar: {
    dir: 'rtl',
    values: {
      file: 'ملف',
      edit: 'تحرير',
      view: 'عرض',
      profiles: 'الملفات الشخصية',
      newTab: 'علامة تبويب جديدة',
      newWindow: 'نافذة جديدة',
      share: 'مشاركة',
      emailLink: 'رابط البريد الإلكتروني',
      messages: 'الرسائل',
      print: 'طباعة...',
      undo: 'تراجع',
      redo: 'إعادة',
      cut: 'قص',
      copy: 'نسخ',
      paste: 'لصق',
      showBookmarks: 'إظهار شريط الإشارات دائمًا',
      showFullUrls: 'إظهار العناوين الكاملة دائمًا',
      andy: 'أندي',
      benoit: 'بنوا',
      luis: 'لويس',
    },
  },
  he: {
    dir: 'rtl',
    values: {
      file: 'קובץ',
      edit: 'עריכה',
      view: 'תצוגה',
      profiles: 'פרופילים',
      newTab: 'לשונית חדשה',
      newWindow: 'חלון חדש',
      share: 'שיתוף',
      emailLink: 'קישור באימייל',
      messages: 'הודעות',
      print: 'הדפסה...',
      undo: 'בטל',
      redo: 'בצע שוב',
      cut: 'גזור',
      copy: 'העתק',
      paste: 'הדבק',
      showBookmarks: 'הצג תמיד את סרגל הסימניות',
      showFullUrls: 'הצג תמיד כתובות מלאות',
      andy: 'אנדי',
      benoit: 'בנואה',
      luis: 'לואיס',
    },
  },
};

@Component({
  selector: 'z-demo-menubar-rtl',
  imports: [ZardMenubarImports],
  template: `
    <z-menubar class="w-72">
      <button type="button" z-menubar-trigger [zMenubarMenu]="fileMenu">{{ i18n.t().file }}</button>
      <button type="button" z-menubar-trigger [zMenubarMenu]="editMenu">{{ i18n.t().edit }}</button>
      <button type="button" z-menubar-trigger [zMenubarMenu]="viewMenu">{{ i18n.t().view }}</button>
      <button type="button" z-menubar-trigger [zMenubarMenu]="profilesMenu">{{ i18n.t().profiles }}</button>
    </z-menubar>

    <z-dropdown-menu-content #fileMenu="zDropdownMenuContent" class="w-56">
      <z-dropdown-menu-item>
        {{ i18n.t().newTab }}
        <z-dropdown-menu-shortcut>⌘T</z-dropdown-menu-shortcut>
      </z-dropdown-menu-item>
      <z-dropdown-menu-item>
        {{ i18n.t().newWindow }}
        <z-dropdown-menu-shortcut>⌘N</z-dropdown-menu-shortcut>
      </z-dropdown-menu-item>
      <z-dropdown-menu-separator />
      <z-dropdown-menu-sub-trigger [zSubMenu]="shareMenu">{{ i18n.t().share }}</z-dropdown-menu-sub-trigger>
      <z-dropdown-menu-sub-content #shareMenu="zDropdownMenuSubContent" class="w-44">
        <z-dropdown-menu-item>{{ i18n.t().emailLink }}</z-dropdown-menu-item>
        <z-dropdown-menu-item>{{ i18n.t().messages }}</z-dropdown-menu-item>
      </z-dropdown-menu-sub-content>
      <z-dropdown-menu-separator />
      <z-dropdown-menu-item>
        {{ i18n.t().print }}
        <z-dropdown-menu-shortcut>⌘P</z-dropdown-menu-shortcut>
      </z-dropdown-menu-item>
    </z-dropdown-menu-content>

    <z-dropdown-menu-content #editMenu="zDropdownMenuContent" class="w-56">
      <z-dropdown-menu-item>
        {{ i18n.t().undo }}
        <z-dropdown-menu-shortcut>⌘Z</z-dropdown-menu-shortcut>
      </z-dropdown-menu-item>
      <z-dropdown-menu-item>
        {{ i18n.t().redo }}
        <z-dropdown-menu-shortcut>⇧⌘Z</z-dropdown-menu-shortcut>
      </z-dropdown-menu-item>
      <z-dropdown-menu-separator />
      <z-dropdown-menu-item>{{ i18n.t().cut }}</z-dropdown-menu-item>
      <z-dropdown-menu-item>{{ i18n.t().copy }}</z-dropdown-menu-item>
      <z-dropdown-menu-item>{{ i18n.t().paste }}</z-dropdown-menu-item>
    </z-dropdown-menu-content>

    <z-dropdown-menu-content #viewMenu="zDropdownMenuContent" class="w-64">
      <z-dropdown-menu-checkbox-item [(zChecked)]="showBookmarks">
        {{ i18n.t().showBookmarks }}
      </z-dropdown-menu-checkbox-item>
      <z-dropdown-menu-checkbox-item [(zChecked)]="showFullUrls">
        {{ i18n.t().showFullUrls }}
      </z-dropdown-menu-checkbox-item>
    </z-dropdown-menu-content>

    <z-dropdown-menu-content #profilesMenu="zDropdownMenuContent" class="w-44">
      <z-dropdown-menu-radio-group [(zValue)]="profile">
        <z-dropdown-menu-radio-item zValue="andy">{{ i18n.t().andy }}</z-dropdown-menu-radio-item>
        <z-dropdown-menu-radio-item zValue="benoit">{{ i18n.t().benoit }}</z-dropdown-menu-radio-item>
        <z-dropdown-menu-radio-item zValue="luis">{{ i18n.t().luis }}</z-dropdown-menu-radio-item>
      </z-dropdown-menu-radio-group>
    </z-dropdown-menu-content>
  `,
  changeDetection: ChangeDetectionStrategy.OnPush,
})
export class ZardDemoMenubarRtlComponent {
  protected readonly i18n = injectRtlTranslation(translations);

  protected readonly showBookmarks = signal(true);
  protected readonly showFullUrls = signal(false);
  protected readonly profile = signal('benoit');
}

API Reference

z-menubar

The bar. Keeps a single tab stop over its triggers, moves between them with ←/→ and switches the open menu on hover.

Prop
[class]

Custom CSS classes

Type
ClassValue
Default
''

[z-menubar-trigger]

One menu of the bar: put it on a button inside z-menubar.

Prop
[zMenubarMenu]

Menu content opened by this trigger (#ref="zDropdownMenuContent"). Opens 4px further than its zSideOffset, as in shadcn

Type
ZardDropdownMenuContentComponent
Default
—
[zDisabled]

Disables the trigger; arrow navigation skips it

Type
boolean
Default
false
[zVisible]

Opens or closes this menu

Type
boolean
Default
false
[(zVisible)]

Open state of this menu, two-way bound

Type
boolean
Default
false
[class]

Custom CSS classes

Type
ClassValue
Default
''

z-dropdown-menu-content

Menu surface; the rows are the same z-dropdown-menu-* primitives the dropdown uses.

Prop
[class]

Custom CSS classes

Type
ClassValue
Default
''
[zSide]

Trigger edge the menu opens from

Type
'top' | 'right' | 'bottom' | 'left'
Default
'bottom'
[zAlign]

Alignment along that edge

Type
'start' | 'center' | 'end'
Default
'start'
[zSideOffset]

Gap from the trigger in px

Type
number
Default
4

z-dropdown-menu-item

Clickable row that closes the menu on select.

Prop
[zType]

Visual style

Type
'default' | 'destructive'
Default
'default'
[zInset]

Adds start padding for alignment

Type
boolean
Default
false
[zDisabled]

Disables the item

Type
boolean
Default
false
[class]

Custom CSS classes

Type
ClassValue
Default
''

z-dropdown-menu-checkbox-item

Row with a checked state.

Prop
[(zChecked)]

Checked state

Type
boolean
Default
false
[zDisabled]

Disables the item

Type
boolean
Default
false
[zType]

Visual style

Type
'default' | 'destructive'
Default
'default'
[class]

Custom CSS classes

Type
ClassValue
Default
''

z-dropdown-menu-radio-group

Wrapper for radio items.

Prop
[(zValue)]

Selected value

Type
string | undefined
Default
—
[class]

Custom CSS classes

Type
ClassValue
Default
''

z-dropdown-menu-radio-item

Row with radio semantics.

Prop
[zValue]

Item value

Type
string
Default
—
[zDisabled]

Disables the item

Type
boolean
Default
false
[zType]

Visual style

Type
'default' | 'destructive'
Default
'default'
[class]

Custom CSS classes

Type
ClassValue
Default
''

z-dropdown-menu-sub-trigger

Row that opens a nested menu.

Prop
[zSubMenu]

Submenu content (#ref="zDropdownMenuSubContent")

Type
ZardDropdownMenuSubContentComponent | TemplateRef<unknown>
Default
—
[zInset]

Adds start padding for alignment

Type
boolean
Default
false
[zDisabled]

Disables the sub-trigger

Type
boolean
Default
false
[class]

Custom CSS classes

Type
ClassValue
Default
''

z-dropdown-menu-sub-content

Submenu surface; opens beside its trigger and flips when needed.

Prop
[class]

Custom CSS classes

Type
ClassValue
Default
''

z-dropdown-menu-label

Group label.

Prop
[inset]

Adds start padding for alignment

Type
boolean
Default
false
[class]

Custom CSS classes

Type
ClassValue
Default
''

z-dropdown-menu-group

Groups related rows.

Prop
[class]

Custom CSS classes

Type
ClassValue
Default
''

z-dropdown-menu-separator

Divider between sections.

Prop
[class]

Custom CSS classes

Type
ClassValue
Default
''

z-dropdown-menu-shortcut

Keyboard hint inside a row.

Prop
[class]

Custom CSS classes

Type
ClassValue
Default
''
github iconwhatsapp icondiscord iconX icon

Made with ❤ in Brazil. Open source and available on GitHub .