Lewati ke konten
MarkasUI
Ketik untuk mencari

    Panduan

    MarkasUI

    Form

    Feedback

    Overlay

    Navigasi

    Data

    Section

    Animasi

    Latar

    Tombol

    Template

    Halaman

    Menubar

    Bar horizontal berisi beberapa menu seperti aplikasi desktop, berbasis Popover API, dengan keyboard sesuai pola WAI-ARIA Menubar.

    <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;
    }

    Contoh

    Dalam 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.

    Dengan tautan

    Item berbahaya dan nonaktif

    Instalasi

    npx markasui@latest add menubar

    Pemakaian

    <x-markas.menubar
        label="Menu aplikasi"
        :menus="[
            ['label' => 'Berkas', 'items' => [
                ['label' => 'Berkas baru', 'value' => 'baru'],
                ['label' => 'Simpan', 'value' => 'simpan'],
            ]],
            ['label' => 'Ubah', 'items' => [
                ['label' => 'Urungkan', 'value' => 'urungkan'],
                ['separator' => true],
                ['label' => 'Hapus', 'value' => 'hapus', 'danger' => true],
            ]],
            ['label' => 'Bantuan', 'items' => [
                ['label' => 'Dokumentasi', 'href' => '/docs'],
            ]],
        ]"
        x-on:markas-select="console.log($event.detail)"
    />

    Butuh Alpine.js. Item yang dipilih memancarkan event markas-select dengan $event.detail berisi value item. Di Livewire: x-on:markas-select="$wire.aksi($event.detail)".

    import { Menubar } from "@/components/markas/Menubar";
    
    <Menubar
      label="Menu aplikasi"
      menus={[
        {
          label: "Berkas",
          items: [
            { label: "Berkas baru", value: "baru" },
            { label: "Simpan", value: "simpan" },
          ],
        },
        {
          label: "Ubah",
          items: [
            { label: "Urungkan", value: "urungkan" },
            { separator: true },
            { label: "Hapus", value: "hapus", danger: true },
          ],
        },
        { label: "Bantuan", items: [{ label: "Dokumentasi", href: "/docs" }] },
      ]}
      onSelect={(value) => console.log(value)}
    />;
    <template>
      <Menubar
        label="Menu aplikasi"
        :menus="[
          {
            label: 'Berkas',
            items: [
              { label: 'Berkas baru', value: 'baru' },
              { label: 'Simpan', value: 'simpan' },
            ],
          },
          {
            label: 'Ubah',
            items: [
              { label: 'Urungkan', value: 'urungkan' },
              { separator: true },
              { label: 'Hapus', value: 'hapus', danger: true },
            ],
          },
          { label: 'Bantuan', items: [{ label: 'Dokumentasi', 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: "Berkas",
          items: [
            { label: "Berkas baru", value: "baru" },
            { label: "Simpan", value: "simpan" },
          ],
        },
        {
          label: "Ubah",
          items: [
            { label: "Urungkan", value: "urungkan" },
            { separator: true },
            { label: "Hapus", value: "hapus", danger: true },
          ],
        },
        { label: "Bantuan", items: [{ label: "Dokumentasi", href: "/docs" }] },
      ];
    </script>
    
    <Menubar
      label="Menu aplikasi"
      {menus}
      onselect={(value) => console.log(value)}
    />
    ---
    import Menubar from "@/components/markas/Menubar.astro";
    ---
    
    <Menubar
      label="Menu aplikasi"
      id="app-menu"
      menus={[
        {
          label: "Berkas",
          items: [
            { label: "Berkas baru", value: "baru" },
            { label: "Simpan", value: "simpan" },
          ],
        },
        {
          label: "Ubah",
          items: [
            { label: "Urungkan", value: "urungkan" },
            { separator: true },
            { label: "Hapus", value: "hapus", danger: true },
          ],
        },
        { label: "Bantuan", items: [{ label: "Dokumentasi", href: "/docs" }] },
      ]}
    />
    
    <script>
      document
        .getElementById("app-menu")
        ?.addEventListener("markas-select", (event) =>
          console.log((event as CustomEvent<string>).detail),
        );
    </script>

    Satu script kecil yang dibundel menghidupkan setiap menubar di halaman, termasuk setelah view transition. Pilihan item memancarkan event markas-select (bubble) dengan value di detail, sama seperti Blade.

    import { Component } from "@angular/core";
    import { Menubar, type MenubarMenu } from "./markas/menubar.component";
    
    @Component({
      selector: "app-editor-menu",
      imports: [Menubar],
      template: `
        <markas-menubar
          label="Menu aplikasi"
          [menus]="menus"
          (selected)="onSelected($event)"
        />
      `,
    })
    export class EditorMenu {
      protected readonly menus: MenubarMenu[] = [
        {
          label: "Berkas",
          items: [
            { label: "Berkas baru", value: "baru" },
            { label: "Simpan", value: "simpan" },
          ],
        },
        {
          label: "Ubah",
          items: [
            { label: "Urungkan", value: "urungkan" },
            { separator: true },
            { label: "Hapus", value: "hapus", danger: true },
          ],
        },
        { label: "Bantuan", items: [{ label: "Dokumentasi", href: "/docs" }] },
      ];
    
      protected onSelected(value: string) {
        console.log(value);
      }
    }
    • Item menu memakai bentuk yang sama dengan item Dropdown Menu: value, href, danger, disabled, atau { separator: true }.
    • Kalau value kosong, callback menerima label item.
    • Menu tampil di top layer lewat Popover API, jadi tidak terpotong oleh overflow: hidden induknya. Hanya satu menu terbuka dalam satu waktu.
    • Nama aksesibel bar default dalam bahasa Inggris (“Menu”). Isi label dengan “Menu aplikasi” untuk situs berbahasa Indonesia.

    Props

    NamaTipeDefaultKeterangan
    menus{ label, items: ({ label, value?, href?, danger?, disabled? } | { separator: true })[] }[][]Daftar menu di bar. Setiap menu punya label dan item dengan bentuk sama seperti item Dropdown Menu.
    labelstringMenuNama aksesibel bar (aria-label). Default "Menu", isi misalnya "Menu aplikasi" untuk situs berbahasa Indonesia.
    onSelect / @select / markas-select(value: string) => void-Dipanggil saat item dipilih dengan value item (atau label bila value kosong). Blade memancarkan event markas-select.
    idstringautoId bar. Pemicu dan menu memakai id ini dengan akhiran -trigger-<indeks> dan -menu-<indeks>.
    selectedoutput<string>-Khusus Angular. Dipancarkan dengan value item (atau label) saat item dipilih. Svelte memakai prop onselect, Astro memancarkan event markas-select seperti Blade.

    Aksesibilitas

    • Bar memakai role=menubar dengan aria-label; setiap tombol tingkat atas adalah menuitem dengan aria-haspopup=menu, aria-expanded, dan aria-controls.
    • Hanya satu item tingkat atas yang masuk urutan Tab (roving tabindex). Panah kiri dan kanan berpindah di antaranya, Home dan End ke ujung.
    • Enter, Spasi, atau panah bawah membuka menu dan memfokuskan item pertama; panah atas memfokuskan item terakhir. Panah atas dan bawah berpindah di dalam menu, melewati item nonaktif.
    • Saat menu terbuka, panah kiri dan kanan menutupnya lalu membuka menu di sebelahnya. Escape menutup menu dan mengembalikan fokus ke item tingkat atasnya.

    Komponen terkait

    Komponen navigasi lain dengan class yang sama di setiap framework.