Skip to content
MarkasUI
Type to search

    Guide

    MarkasUI

    Form

    Feedback

    Overlay

    Navigation

    Data

    Sections

    Animations

    Backgrounds

    Buttons

    Templates

    Pages

    Menubar

    Horizontal bar of menus like a desktop app, built on the Popover API, with keyboard support following the WAI-ARIA Menubar pattern.

    <x-markas.menubar
        :menus="[
            ['label' => 'File', 'items' => [
                ['label' => 'New file', 'value' => 'new'],
                ['label' => 'Open', 'value' => 'open'],
                ['label' => 'Save', 'value' => 'save'],
                ['separator' => true],
                ['label' => 'Close window', 'value' => 'close'],
            ]],
            ['label' => 'Edit', 'items' => [
                ['label' => 'Undo', 'value' => 'undo'],
                ['label' => 'Redo', 'value' => 'redo'],
                ['separator' => true],
                ['label' => 'Cut', 'value' => 'cut'],
                ['label' => 'Copy', 'value' => 'copy'],
                ['label' => 'Paste', 'value' => 'paste'],
            ]],
            ['label' => 'View', 'items' => [
                ['label' => 'Zoom in', 'value' => 'zoom-in'],
                ['label' => 'Zoom out', 'value' => 'zoom-out'],
                ['label' => 'Full screen', 'value' => 'full-screen', 'disabled' => true],
            ]],
            ['label' => 'Help', 'items' => [
                ['label' => 'Documentation', 'href' => '/docs'],
                ['label' => 'About', 'value' => 'about'],
            ]],
        ]"
    />
    import { Menubar } from "@/components/markas/Menubar";
    
    const menus = [
      {
        label: "File",
        items: [
          {
            label: "New file",
            value: "new",
          },
          {
            label: "Open",
            value: "open",
          },
          {
            label: "Save",
            value: "save",
          },
          {
            separator: true as const,
          },
          {
            label: "Close window",
            value: "close",
          },
        ],
      },
      {
        label: "Edit",
        items: [
          {
            label: "Undo",
            value: "undo",
          },
          {
            label: "Redo",
            value: "redo",
          },
          {
            separator: true as const,
          },
          {
            label: "Cut",
            value: "cut",
          },
          {
            label: "Copy",
            value: "copy",
          },
          {
            label: "Paste",
            value: "paste",
          },
        ],
      },
      {
        label: "View",
        items: [
          {
            label: "Zoom in",
            value: "zoom-in",
          },
          {
            label: "Zoom out",
            value: "zoom-out",
          },
          {
            label: "Full screen",
            value: "full-screen",
            disabled: true,
          },
        ],
      },
      {
        label: "Help",
        items: [
          {
            label: "Documentation",
            href: "/docs",
          },
          {
            label: "About",
            value: "about",
          },
        ],
      },
    ];
    
    export default function MenubarExample() {
      return <Menubar menus={menus} />;
    }
    <script setup lang="ts">
    import Menubar from "@/components/markas/Menubar.vue";
    
    const menus = [
      {
        label: "File",
        items: [
          {
            label: "New file",
            value: "new",
          },
          {
            label: "Open",
            value: "open",
          },
          {
            label: "Save",
            value: "save",
          },
          {
            separator: true as const,
          },
          {
            label: "Close window",
            value: "close",
          },
        ],
      },
      {
        label: "Edit",
        items: [
          {
            label: "Undo",
            value: "undo",
          },
          {
            label: "Redo",
            value: "redo",
          },
          {
            separator: true as const,
          },
          {
            label: "Cut",
            value: "cut",
          },
          {
            label: "Copy",
            value: "copy",
          },
          {
            label: "Paste",
            value: "paste",
          },
        ],
      },
      {
        label: "View",
        items: [
          {
            label: "Zoom in",
            value: "zoom-in",
          },
          {
            label: "Zoom out",
            value: "zoom-out",
          },
          {
            label: "Full screen",
            value: "full-screen",
            disabled: true,
          },
        ],
      },
      {
        label: "Help",
        items: [
          {
            label: "Documentation",
            href: "/docs",
          },
          {
            label: "About",
            value: "about",
          },
        ],
      },
    ];
    </script>
    
    <template>
      <Menubar :menus="menus" />
    </template>
    <script lang="ts">
      import Menubar from "$lib/components/markas/Menubar.svelte";
    
      const menus = [
        {
          label: "File",
          items: [
            {
              label: "New file",
              value: "new",
            },
            {
              label: "Open",
              value: "open",
            },
            {
              label: "Save",
              value: "save",
            },
            {
              separator: true as const,
            },
            {
              label: "Close window",
              value: "close",
            },
          ],
        },
        {
          label: "Edit",
          items: [
            {
              label: "Undo",
              value: "undo",
            },
            {
              label: "Redo",
              value: "redo",
            },
            {
              separator: true as const,
            },
            {
              label: "Cut",
              value: "cut",
            },
            {
              label: "Copy",
              value: "copy",
            },
            {
              label: "Paste",
              value: "paste",
            },
          ],
        },
        {
          label: "View",
          items: [
            {
              label: "Zoom in",
              value: "zoom-in",
            },
            {
              label: "Zoom out",
              value: "zoom-out",
            },
            {
              label: "Full screen",
              value: "full-screen",
              disabled: true,
            },
          ],
        },
        {
          label: "Help",
          items: [
            {
              label: "Documentation",
              href: "/docs",
            },
            {
              label: "About",
              value: "about",
            },
          ],
        },
      ];
    </script>
    
    <Menubar {menus} />
    ---
    import Menubar from "@/components/markas/Menubar.astro";
    
    const menus = [
      {
        label: "File",
        items: [
          {
            label: "New file",
            value: "new",
          },
          {
            label: "Open",
            value: "open",
          },
          {
            label: "Save",
            value: "save",
          },
          {
            separator: true as const,
          },
          {
            label: "Close window",
            value: "close",
          },
        ],
      },
      {
        label: "Edit",
        items: [
          {
            label: "Undo",
            value: "undo",
          },
          {
            label: "Redo",
            value: "redo",
          },
          {
            separator: true as const,
          },
          {
            label: "Cut",
            value: "cut",
          },
          {
            label: "Copy",
            value: "copy",
          },
          {
            label: "Paste",
            value: "paste",
          },
        ],
      },
      {
        label: "View",
        items: [
          {
            label: "Zoom in",
            value: "zoom-in",
          },
          {
            label: "Zoom out",
            value: "zoom-out",
          },
          {
            label: "Full screen",
            value: "full-screen",
            disabled: true,
          },
        ],
      },
      {
        label: "Help",
        items: [
          {
            label: "Documentation",
            href: "/docs",
          },
          {
            label: "About",
            value: "about",
          },
        ],
      },
    ];
    ---
    
    <Menubar menus={menus} />
    import { Component } from "@angular/core";
    import { Menubar } from "./markas/menubar.component";
    
    const menus = [
      {
        label: "File",
        items: [
          {
            label: "New file",
            value: "new",
          },
          {
            label: "Open",
            value: "open",
          },
          {
            label: "Save",
            value: "save",
          },
          {
            separator: true as const,
          },
          {
            label: "Close window",
            value: "close",
          },
        ],
      },
      {
        label: "Edit",
        items: [
          {
            label: "Undo",
            value: "undo",
          },
          {
            label: "Redo",
            value: "redo",
          },
          {
            separator: true as const,
          },
          {
            label: "Cut",
            value: "cut",
          },
          {
            label: "Copy",
            value: "copy",
          },
          {
            label: "Paste",
            value: "paste",
          },
        ],
      },
      {
        label: "View",
        items: [
          {
            label: "Zoom in",
            value: "zoom-in",
          },
          {
            label: "Zoom out",
            value: "zoom-out",
          },
          {
            label: "Full screen",
            value: "full-screen",
            disabled: true,
          },
        ],
      },
      {
        label: "Help",
        items: [
          {
            label: "Documentation",
            href: "/docs",
          },
          {
            label: "About",
            value: "about",
          },
        ],
      },
    ];
    
    @Component({
      selector: "markas-example",
      imports: [Menubar],
      template: ` <markas-menubar [menus]="menus" /> `,
    })
    export default class MenubarFixture {
      protected readonly menus = menus;
    }

    Examples

    In an editor

    notes.md

    Version 2.4

    Faster search, a new export dialog, and dark mode for the editor.

    notes.md

    Version 2.4

    Faster search, a new export dialog, and dark mode for the editor.

    notes.md

    Version 2.4

    Faster search, a new export dialog, and dark mode for the editor.

    notes.md

    Version 2.4

    Faster search, a new export dialog, and dark mode for the editor.

    notes.md

    Version 2.4

    Faster search, a new export dialog, and dark mode for the editor.

    With links

    Destructive and disabled items

    Installation

    npx markasui@latest add menubar

    Usage

    <x-markas.menubar
        :menus="[
            ['label' => 'File', 'items' => [
                ['label' => 'New file', 'value' => 'new'],
                ['label' => 'Save', 'value' => 'save'],
            ]],
            ['label' => 'Edit', 'items' => [
                ['label' => 'Undo', 'value' => 'undo'],
                ['separator' => true],
                ['label' => 'Delete', 'value' => 'delete', 'danger' => true],
            ]],
            ['label' => 'Help', 'items' => [
                ['label' => 'Documentation', 'href' => '/docs'],
            ]],
        ]"
        x-on:markas-select="console.log($event.detail)"
    />

    Needs Alpine.js. Selecting an item dispatches a markas-select event with the item value in $event.detail. In Livewire: x-on:markas-select="$wire.handle($event.detail)".

    import { Menubar } from "@/components/markas/Menubar";
    
    <Menubar
      menus={[
        {
          label: "File",
          items: [
            { label: "New file", value: "new" },
            { label: "Save", value: "save" },
          ],
        },
        {
          label: "Edit",
          items: [
            { label: "Undo", value: "undo" },
            { separator: true },
            { label: "Delete", value: "delete", danger: true },
          ],
        },
        { label: "Help", items: [{ label: "Documentation", href: "/docs" }] },
      ]}
      onSelect={(value) => console.log(value)}
    />;
    <template>
      <Menubar
        :menus="[
          {
            label: 'File',
            items: [
              { label: 'New file', value: 'new' },
              { label: 'Save', value: 'save' },
            ],
          },
          {
            label: 'Edit',
            items: [
              { label: 'Undo', value: 'undo' },
              { separator: true },
              { label: 'Delete', value: 'delete', danger: true },
            ],
          },
          { label: 'Help', items: [{ label: 'Documentation', href: '/docs' }] },
        ]"
        @select="(value) => console.log(value)"
      />
    </template>
    <script lang="ts">
      import Menubar, {
        type MenubarMenu,
      } from "$lib/components/markas/Menubar.svelte";
    
      const menus: MenubarMenu[] = [
        {
          label: "File",
          items: [
            { label: "New file", value: "new" },
            { label: "Save", value: "save" },
          ],
        },
        {
          label: "Edit",
          items: [
            { label: "Undo", value: "undo" },
            { separator: true },
            { label: "Delete", value: "delete", danger: true },
          ],
        },
        { label: "Help", items: [{ label: "Documentation", href: "/docs" }] },
      ];
    </script>
    
    <Menubar {menus} onselect={(value) => console.log(value)} />
    ---
    import Menubar from "@/components/markas/Menubar.astro";
    ---
    
    <Menubar
      id="app-menu"
      menus={[
        {
          label: "File",
          items: [
            { label: "New file", value: "new" },
            { label: "Save", value: "save" },
          ],
        },
        {
          label: "Edit",
          items: [
            { label: "Undo", value: "undo" },
            { separator: true },
            { label: "Delete", value: "delete", danger: true },
          ],
        },
        { label: "Help", items: [{ label: "Documentation", href: "/docs" }] },
      ]}
    />
    
    <script>
      document
        .getElementById("app-menu")
        ?.addEventListener("markas-select", (event) =>
          console.log((event as CustomEvent<string>).detail),
        );
    </script>

    A small bundled script powers every menubar on the page, also after view transitions. Selecting an item dispatches a bubbling markas-select event with the value in detail, like Blade.

    import { Component } from "@angular/core";
    import { Menubar, type MenubarMenu } from "./markas/menubar.component";
    
    @Component({
      selector: "app-editor-menu",
      imports: [Menubar],
      template: `
        <markas-menubar [menus]="menus" (selected)="onSelected($event)" />
      `,
    })
    export class EditorMenu {
      protected readonly menus: MenubarMenu[] = [
        {
          label: "File",
          items: [
            { label: "New file", value: "new" },
            { label: "Save", value: "save" },
          ],
        },
        {
          label: "Edit",
          items: [
            { label: "Undo", value: "undo" },
            { separator: true },
            { label: "Delete", value: "delete", danger: true },
          ],
        },
        { label: "Help", items: [{ label: "Documentation", href: "/docs" }] },
      ];
    
      protected onSelected(value: string) {
        console.log(value);
      }
    }
    • Menu items take the same shape as Dropdown Menu items: value, href, danger, disabled, or { separator: true }.
    • When value is empty, the callback receives the item label.
    • Menus render in the top layer through the Popover API, so a parent with overflow: hidden never clips them. Only one menu is open at a time.
    • The bar’s accessible name defaults to “Menu”. Translate it with label.

    Props

    NameTypeDefaultDescription
    menus{ label, items: ({ label, value?, href?, danger?, disabled? } | { separator: true })[] }[][]Menus in the bar. Each menu has a label and items in the same shape as Dropdown Menu items.
    labelstringMenuAccessible name of the bar (aria-label).
    onSelect / @select / markas-select(value: string) => void-Called when an item is selected, with the item value (or label when value is empty). Blade dispatches a markas-select event.
    idstringautoBar id. Triggers and menus use it with -trigger-<index> and -menu-<index> suffixes.
    selectedoutput<string>-Angular only. Emits the item value (or label) when an item is selected. Svelte uses the onselect prop, Astro dispatches a markas-select event like Blade.

    Accessibility

    • The bar uses role=menubar with an aria-label; each top-level button is a menuitem with aria-haspopup=menu, aria-expanded, and aria-controls.
    • Only one top-level item is in the tab order (roving tabindex). Arrow Left and Arrow Right move between them, Home and End jump to the ends.
    • Enter, Space, or Arrow Down opens a menu and focuses the first item; Arrow Up focuses the last item. Arrow Up and Arrow Down move inside the menu, skipping disabled items.
    • With a menu open, Arrow Left and Arrow Right close it and open the neighboring menu. Escape closes the menu and returns focus to its top-level item.

    Related components

    More navigation components with the same classes in every framework.