Lewati ke konten
MarkasUI
Ketik untuk mencari

    Panduan

    MarkasUI

    Form

    Feedback

    Overlay

    Navigasi

    Data

    Section

    Animasi

    Latar

    Tombol

    Template

    Halaman

    Dropdown Menu

    Menu aksi berbasis Popover API dengan navigasi keyboard sesuai pola WAI-ARIA Menu Button.

    <x-markas.dropdown-menu
        label="Actions"
        :items="[
            ['label' => 'Edit', 'value' => 'edit'],
            ['label' => 'Duplicate', 'value' => 'duplicate'],
            ['label' => 'Archive', 'value' => 'archive', 'disabled' => true],
            ['separator' => true],
            ['label' => 'Delete', 'value' => 'delete', 'danger' => true],
        ]"
    />
    import { DropdownMenu } from "@/components/markas/DropdownMenu";
    
    const items = [
      { label: "Edit", value: "edit" },
      { label: "Duplicate", value: "duplicate" },
      { label: "Archive", value: "archive", disabled: true },
      { separator: true as const },
      { label: "Delete", value: "delete", danger: true },
    ];
    
    export default function DropdownMenuExample() {
      return <DropdownMenu label="Actions" items={items} />;
    }
    <script setup lang="ts">
    import DropdownMenu from "@/components/markas/DropdownMenu.vue";
    
    const items = [
      { label: "Edit", value: "edit" },
      { label: "Duplicate", value: "duplicate" },
      { label: "Archive", value: "archive", disabled: true },
      { separator: true as const },
      { label: "Delete", value: "delete", danger: true },
    ];
    </script>
    
    <template>
      <DropdownMenu label="Actions" :items="items" />
    </template>
    <script lang="ts">
      import DropdownMenu from "$lib/components/markas/DropdownMenu.svelte";
    
      const items = [
        { label: "Edit", value: "edit" },
        { label: "Duplicate", value: "duplicate" },
        { label: "Archive", value: "archive", disabled: true },
        { separator: true as const },
        { label: "Delete", value: "delete", danger: true },
      ];
    </script>
    
    <DropdownMenu label="Actions" {items} />
    ---
    import DropdownMenu from "@/components/markas/DropdownMenu.astro";
    
    const items = [
      { label: "Edit", value: "edit" },
      { label: "Duplicate", value: "duplicate" },
      { label: "Archive", value: "archive", disabled: true },
      { separator: true as const },
      { label: "Delete", value: "delete", danger: true },
    ];
    ---
    
    <DropdownMenu label="Actions" items={items} />
    import { Component } from "@angular/core";
    import { DropdownMenu } from "./markas/dropdown-menu.component";
    
    @Component({
      selector: "markas-example",
      imports: [DropdownMenu],
      template: ` <markas-dropdown-menu label="Actions" [items]="items" /> `,
    })
    export default class DropdownMenuExample {
      protected readonly items = [
        { label: "Edit", value: "edit" },
        { label: "Duplicate", value: "duplicate" },
        { label: "Archive", value: "archive", disabled: true },
        { separator: true as const },
        { label: "Delete", value: "delete", danger: true },
      ];
    }

    Contoh

    Dengan tautan

    Item berbahaya

    Item nonaktif

    Pemicu ikon

    Dalam toolbar

    Instalasi

    npx markasui@latest add dropdown-menu

    Pemakaian

    <x-markas.dropdown-menu
        label="Aksi"
        :items="[
            ['label' => 'Ubah', 'value' => 'ubah'],
            ['label' => 'Lihat detail', 'href' => '/proyek/1'],
            ['separator' => true],
            ['label' => 'Hapus', 'value' => 'hapus', 'danger' => true],
        ]"
        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)".

    Livewire

    <x-markas.dropdown-menu label="Actions" :items="$actions" wire:markas-select="run($event.detail)" />

    Memilih item memancarkan markas-select dengan value; wire:markas-select memanggil action Livewire dengan value itu. Menu yang terbuka tetap di posisinya saat komponen dirender ulang.

    import { DropdownMenu } from "@/components/markas/DropdownMenu";
    
    <DropdownMenu
      label="Aksi"
      items={[
        { label: "Ubah", value: "ubah" },
        { label: "Lihat detail", href: "/proyek/1" },
        { separator: true },
        { label: "Hapus", value: "hapus", danger: true },
      ]}
      onSelect={(value) => console.log(value)}
    />;
    <template>
      <DropdownMenu
        label="Aksi"
        :items="[
          { label: 'Ubah', value: 'ubah' },
          { label: 'Lihat detail', href: '/proyek/1' },
          { separator: true },
          { label: 'Hapus', value: 'hapus', danger: true },
        ]"
        @select="(value) => console.log(value)"
      />
    </template>
    <script lang="ts">
      import DropdownMenu from "$lib/components/markas/DropdownMenu.svelte";
    </script>
    
    <DropdownMenu
      label="Actions"
      items={[
        { label: "Edit", value: "edit" },
        { label: "View details", href: "/projects/1" },
        { separator: true },
        { label: "Delete", value: "delete", danger: true },
      ]}
      onselect={(value) => console.log(value)}
    />
    ---
    import DropdownMenu from "@/components/markas/DropdownMenu.astro";
    ---
    
    <DropdownMenu
      label="Actions"
      items={[
        { label: "Edit", value: "edit" },
        { label: "View details", href: "/projects/1" },
        { separator: true },
        { label: "Delete", value: "delete", danger: true },
      ]}
    />
    
    <script>
      document.addEventListener("markas-select", (event) =>
        console.log((event as CustomEvent<string>).detail),
      );
    </script>

    Satu script kecil yang dibundel menjalankan semua dropdown menu di halaman, juga setelah view transition. Memilih item memancarkan event markas-select (bubble) dengan value item di detail.

    import { Component } from "@angular/core";
    import { DropdownMenu } from "./markas/dropdown-menu.component";
    
    @Component({
      selector: "app-project-actions",
      imports: [DropdownMenu],
      template: `
        <markas-dropdown-menu
          label="Actions"
          [items]="items"
          (selected)="onSelect($event)"
        />
      `,
    })
    export class ProjectActions {
      readonly items = [
        { label: "Edit", value: "edit" },
        { label: "View details", href: "/projects/1" },
        { separator: true as const },
        { label: "Delete", value: "delete", danger: true },
      ];
    
      onSelect(value: string) {}
    }

    Isi tombol pemicu bisa diganti dengan elemen beratribut trigger (ng-container juga bisa).

    • Isi tombol bisa diganti lewat slot trigger (Blade dan Vue) atau prop trigger (React). Ikon panah tetap ditampilkan.
    • Kalau value kosong, callback menerima label item.
    • Panel menu tampil di top layer lewat Popover API, jadi tidak terpotong oleh overflow: hidden induknya.
    • Teks tombol pemicu default dalam bahasa Inggris (“Options”). Isi label dengan “Opsi” atau “Aksi” untuk situs berbahasa Indonesia.

    Props

    NamaTipeDefaultKeterangan
    items{ label, value?, href?, danger?, disabled? }[] or { separator: true }[]Daftar item menu. Item dengan href dirender sebagai link, separator menjadi garis pemisah.
    labelstringOptionsTeks tombol pemicu. Default "Options", isi misalnya "Opsi" atau "Aksi" untuk situs berbahasa Indonesia.
    triggerslot / ReactNode / snippet-Isi tombol pemicu kustom, menggantikan label. Angular: elemen dengan atribut trigger.
    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 panel menu. Tombol pemicu memakai id ini dengan akhiran -trigger.
    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

    • Tombol pemicu memakai aria-haspopup=menu, aria-expanded, dan aria-controls ke panel role=menu.
    • Enter, Spasi, atau panah bawah membuka menu dan memfokuskan item pertama; panah atas memfokuskan item terakhir.
    • Panah atas dan bawah berpindah item (berputar di ujung), Home dan End ke item pertama dan terakhir, item nonaktif dilewati.
    • Escape menutup menu dan mengembalikan fokus ke pemicu. Klik di luar menutup menu (light dismiss Popover API).

    Komponen terkait

    Komponen overlay lain dengan class yang sama di setiap framework.