Lewati ke konten
MarkasUI
Ketik untuk mencari

    Panduan

    MarkasUI

    Form

    Feedback

    Overlay

    Navigasi

    Data

    Section

    Animasi

    Latar

    Tombol

    Template

    Halaman

    Command Palette

    Daftar perintah yang bisa dicari di dalam dialog modal, tersaring saat mengetik, dengan navigasi panah dan pintasan Ctrl+K atau Cmd+K opsional.

    Suggestions
    Calendar
    Search emoji
    Calculator
    Settings
    ProfileCtrl+P
    BillingCtrl+B
    SettingsCtrl+S
    Suggestions
    Calendar
    Search emoji
    Calculator
    Settings
    ProfileCtrl+P
    BillingCtrl+B
    SettingsCtrl+S
    Suggestions
    Calendar
    Search emoji
    Calculator
    Settings
    ProfileCtrl+P
    BillingCtrl+B
    SettingsCtrl+S
    Suggestions
    Calendar
    Search emoji
    Calculator
    Settings
    ProfileCtrl+P
    BillingCtrl+B
    SettingsCtrl+S
    Suggestions
    Calendar
    Search emoji
    Calculator
    Settings
    ProfileCtrl+P
    BillingCtrl+B
    SettingsCtrl+S
    <x-markas.command
        hotkey
        :items="[
            ['group' => 'Suggestions', 'label' => 'Calendar', 'value' => 'calendar'],
            ['group' => 'Suggestions', 'label' => 'Search emoji', 'value' => 'emoji'],
            ['group' => 'Suggestions', 'label' => 'Calculator', 'value' => 'calculator'],
            ['group' => 'Settings', 'label' => 'Profile', 'value' => 'profile', 'shortcut' => 'Ctrl+P'],
            ['group' => 'Settings', 'label' => 'Billing', 'value' => 'billing', 'shortcut' => 'Ctrl+B'],
            ['group' => 'Settings', 'label' => 'Settings', 'value' => 'settings', 'shortcut' => 'Ctrl+S'],
        ]"
    >
        <x-slot:trigger>
            <x-markas.button variant="secondary">Open command palette</x-markas.button>
        </x-slot:trigger>
    </x-markas.command>
    import { Button } from "@/components/markas/Button";
    import { Command } from "@/components/markas/Command";
    
    const items = [
      { group: "Suggestions", label: "Calendar", value: "calendar" },
      { group: "Suggestions", label: "Search emoji", value: "emoji" },
      { group: "Suggestions", label: "Calculator", value: "calculator" },
      { group: "Settings", label: "Profile", value: "profile", shortcut: "Ctrl+P" },
      { group: "Settings", label: "Billing", value: "billing", shortcut: "Ctrl+B" },
      {
        group: "Settings",
        label: "Settings",
        value: "settings",
        shortcut: "Ctrl+S",
      },
    ];
    
    export default function CommandExample() {
      return (
        <Command
          hotkey
          items={items}
          trigger={<Button variant="secondary">Open command palette</Button>}
        />
      );
    }
    <script setup lang="ts">
    import Button from "@/components/markas/Button.vue";
    import Command from "@/components/markas/Command.vue";
    
    const items = [
      { group: "Suggestions", label: "Calendar", value: "calendar" },
      { group: "Suggestions", label: "Search emoji", value: "emoji" },
      { group: "Suggestions", label: "Calculator", value: "calculator" },
      { group: "Settings", label: "Profile", value: "profile", shortcut: "Ctrl+P" },
      { group: "Settings", label: "Billing", value: "billing", shortcut: "Ctrl+B" },
      {
        group: "Settings",
        label: "Settings",
        value: "settings",
        shortcut: "Ctrl+S",
      },
    ];
    </script>
    
    <template>
      <Command hotkey :items="items">
        <template #trigger>
          <Button variant="secondary">Open command palette</Button>
        </template>
      </Command>
    </template>
    <script lang="ts">
      import Button from "$lib/components/markas/Button.svelte";
      import Command from "$lib/components/markas/Command.svelte";
    
      const items = [
        { group: "Suggestions", label: "Calendar", value: "calendar" },
        { group: "Suggestions", label: "Search emoji", value: "emoji" },
        { group: "Suggestions", label: "Calculator", value: "calculator" },
        {
          group: "Settings",
          label: "Profile",
          value: "profile",
          shortcut: "Ctrl+P",
        },
        {
          group: "Settings",
          label: "Billing",
          value: "billing",
          shortcut: "Ctrl+B",
        },
        {
          group: "Settings",
          label: "Settings",
          value: "settings",
          shortcut: "Ctrl+S",
        },
      ];
    </script>
    
    <Command hotkey {items}>
      {#snippet trigger()}
        <Button variant="secondary">Open command palette</Button>
      {/snippet}
    </Command>
    ---
    import Button from "@/components/markas/Button.astro";
    import Command from "@/components/markas/Command.astro";
    
    const items = [
      { group: "Suggestions", label: "Calendar", value: "calendar" },
      { group: "Suggestions", label: "Search emoji", value: "emoji" },
      { group: "Suggestions", label: "Calculator", value: "calculator" },
      { group: "Settings", label: "Profile", value: "profile", shortcut: "Ctrl+P" },
      { group: "Settings", label: "Billing", value: "billing", shortcut: "Ctrl+B" },
      {
        group: "Settings",
        label: "Settings",
        value: "settings",
        shortcut: "Ctrl+S",
      },
    ];
    ---
    
    <Command hotkey items={items}>
      <Button slot="trigger" variant="secondary">Open command palette</Button>
    </Command>
    import { Component } from "@angular/core";
    import { Button } from "./markas/button.component";
    import { Command } from "./markas/command.component";
    
    @Component({
      selector: "markas-example",
      imports: [Button, Command],
      template: `
        <markas-command hotkey [items]="items">
          <button markas-button trigger variant="secondary">
            Open command palette
          </button>
        </markas-command>
      `,
    })
    export default class CommandExample {
      protected readonly items = [
        { group: "Suggestions", label: "Calendar", value: "calendar" },
        { group: "Suggestions", label: "Search emoji", value: "emoji" },
        { group: "Suggestions", label: "Calculator", value: "calculator" },
        {
          group: "Settings",
          label: "Profile",
          value: "profile",
          shortcut: "Ctrl+P",
        },
        {
          group: "Settings",
          label: "Billing",
          value: "billing",
          shortcut: "Ctrl+B",
        },
        {
          group: "Settings",
          label: "Settings",
          value: "settings",
          shortcut: "Ctrl+S",
        },
      ];
    }

    Contoh

    Pemicu kolom cari

    Pages
    Dashboard
    Invoices
    Customers
    Actions
    Create invoice
    Add customer
    Pages
    Dashboard
    Invoices
    Customers
    Actions
    Create invoice
    Add customer
    Pages
    Dashboard
    Invoices
    Customers
    Actions
    Create invoice
    Add customer
    Pages
    Dashboard
    Invoices
    Customers
    Actions
    Create invoice
    Add customer
    Pages
    Dashboard
    Invoices
    Customers
    Actions
    Create invoice
    Add customer

    Dengan tautan

    Components
    Button Modal

    Pemicu ikon

    MarkasUI
    Workspace
    Create projectCtrl+N
    Invite memberCtrl+I
    Account
    Switch theme
    Sign out
    MarkasUI
    Workspace
    Create projectCtrl+N
    Invite memberCtrl+I
    Account
    Switch theme
    Sign out
    MarkasUI
    Workspace
    Create projectCtrl+N
    Invite memberCtrl+I
    Account
    Switch theme
    Sign out
    MarkasUI
    Workspace
    Create projectCtrl+N
    Invite memberCtrl+I
    Account
    Switch theme
    Sign out
    MarkasUI
    Workspace
    Create projectCtrl+N
    Invite memberCtrl+I
    Account
    Switch theme
    Sign out

    Instalasi

    npx markasui@latest add command

    Pemakaian

    <x-markas.command
        hotkey
        placeholder-label="Ketik perintah atau cari..."
        empty-label="Tidak ada hasil."
        search-label="Cari perintah"
        dialog-label="Palet perintah"
        :items="[
            ['group' => 'Navigasi', 'label' => 'Dasbor', 'href' => '/dasbor'],
            ['group' => 'Navigasi', 'label' => 'Proyek', 'href' => '/proyek'],
            ['group' => 'Aksi', 'label' => 'Buat proyek', 'value' => 'buat', 'shortcut' => 'Ctrl+N'],
            ['group' => 'Aksi', 'label' => 'Undang anggota', 'value' => 'undang'],
        ]"
        x-on:markas-select="console.log($event.detail)"
    >
        <x-slot:trigger>
            <x-markas.button variant="secondary">Cari</x-markas.button>
        </x-slot:trigger>
    </x-markas.command>

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

    Livewire

    <x-markas.command hotkey :items="$commands" wire:markas-select="go($event.detail)" />

    wire:markas-select memanggil action Livewire dengan value yang dipilih. Listener Ctrl+K dilepas saat komponen meninggalkan halaman, jadi wire:navigate tidak menumpuk listener.

    import { Button } from "@/components/markas/Button";
    import { Command } from "@/components/markas/Command";
    
    <Command
      hotkey
      placeholderLabel="Ketik perintah atau cari..."
      emptyLabel="Tidak ada hasil."
      searchLabel="Cari perintah"
      dialogLabel="Palet perintah"
      trigger={<Button variant="secondary">Cari</Button>}
      items={[
        { group: "Navigasi", label: "Dasbor", href: "/dasbor" },
        { group: "Navigasi", label: "Proyek", href: "/proyek" },
        { group: "Aksi", label: "Buat proyek", value: "buat", shortcut: "Ctrl+N" },
        { group: "Aksi", label: "Undang anggota", value: "undang" },
      ]}
      onSelect={(value) => console.log(value)}
    />;
    <template>
      <Command
        hotkey
        placeholder-label="Ketik perintah atau cari..."
        empty-label="Tidak ada hasil."
        search-label="Cari perintah"
        dialog-label="Palet perintah"
        :items="[
          { group: 'Navigasi', label: 'Dasbor', href: '/dasbor' },
          { group: 'Navigasi', label: 'Proyek', href: '/proyek' },
          {
            group: 'Aksi',
            label: 'Buat proyek',
            value: 'buat',
            shortcut: 'Ctrl+N',
          },
          { group: 'Aksi', label: 'Undang anggota', value: 'undang' },
        ]"
        @select="(value) => console.log(value)"
      >
        <template #trigger>
          <Button variant="secondary">Cari</Button>
        </template>
      </Command>
    </template>
    <script lang="ts">
      import Button from "$lib/components/markas/Button.svelte";
      import Command from "$lib/components/markas/Command.svelte";
    
      const items = [
        { group: "Navigasi", label: "Dasbor", href: "/dasbor" },
        { group: "Navigasi", label: "Proyek", href: "/proyek" },
        { group: "Aksi", label: "Buat proyek", value: "buat", shortcut: "Ctrl+N" },
        { group: "Aksi", label: "Undang anggota", value: "undang" },
      ];
    </script>
    
    <Command
      hotkey
      placeholderLabel="Ketik perintah atau cari..."
      emptyLabel="Tidak ada hasil."
      searchLabel="Cari perintah"
      dialogLabel="Palet perintah"
      {items}
      onselect={(value) => console.log(value)}
    >
      {#snippet trigger()}
        <Button variant="secondary">Cari</Button>
      {/snippet}
    </Command>
    ---
    import Button from "@/components/markas/Button.astro";
    import Command from "@/components/markas/Command.astro";
    
    const items = [
      { group: "Navigasi", label: "Dasbor", href: "/dasbor" },
      { group: "Navigasi", label: "Proyek", href: "/proyek" },
      { group: "Aksi", label: "Buat proyek", value: "buat", shortcut: "Ctrl+N" },
      { group: "Aksi", label: "Undang anggota", value: "undang" },
    ];
    ---
    
    <Command
      hotkey
      placeholderLabel="Ketik perintah atau cari..."
      emptyLabel="Tidak ada hasil."
      searchLabel="Cari perintah"
      dialogLabel="Palet perintah"
      items={items}
    >
      <Button slot="trigger" variant="secondary">Cari</Button>
    </Command>
    
    <script>
      document.addEventListener("markas-select", (event) => {
        console.log((event as CustomEvent<string>).detail);
      });
    </script>

    Script kecil yang dibundel menyaring daftar dan menangani keyboard. Memilih perintah memancarkan event markas-select (bubble) dengan value di detail.

    import { Component } from "@angular/core";
    import { Button } from "./markas/button.component";
    import { Command } from "./markas/command.component";
    
    @Component({
      selector: "app-peluncur",
      imports: [Button, Command],
      template: `
        <markas-command
          hotkey
          placeholderLabel="Ketik perintah atau cari..."
          emptyLabel="Tidak ada hasil."
          searchLabel="Cari perintah"
          dialogLabel="Palet perintah"
          [items]="items"
          (selected)="jalankan($event)"
        >
          <button markas-button trigger variant="secondary">Cari</button>
        </markas-command>
      `,
    })
    export class Peluncur {
      readonly items = [
        { group: "Navigasi", label: "Dasbor", href: "/dasbor" },
        { group: "Navigasi", label: "Proyek", href: "/proyek" },
        { group: "Aksi", label: "Buat proyek", value: "buat", shortcut: "Ctrl+N" },
        { group: "Aksi", label: "Undang anggota", value: "undang" },
      ];
    
      jalankan(value: string) {}
    }
    • Pencarian mencocokkan label tanpa membedakan huruf besar dan kecil. Pencarian dikosongkan saat dialog ditutup.
    • Item dengan href berpindah halaman seperti link biasa dan tetap memanggil callback select.
    • Atribut dan class jatuh ke elemen dialog.
    • placeholderLabel, emptyLabel, searchLabel, dan dialogLabel default berbahasa Inggris. Isi dengan teks Indonesia seperti contoh di atas.

    Props

    NamaTipeDefaultKeterangan
    items{ group, label, value?, href?, shortcut? }[][]Daftar perintah. Item dikelompokkan per group sesuai urutan kemunculan pertama. Item dengan href dirender sebagai link.
    triggerslot / ReactNode / snippet-Elemen yang membuka palet saat diklik, biasanya tombol. Angular: elemen dengan atribut trigger.
    hotkeybooleanfalseCtrl+K atau Cmd+K di mana saja pada halaman membuka dan menutup palet.
    placeholderLabelstringType a command or search...Placeholder kolom pencarian. Default "Type a command or search...", isi misalnya "Ketik perintah atau cari...".
    emptyLabelstringNo results found.Pesan saat tidak ada perintah yang cocok. Default "No results found.", isi misalnya "Tidak ada hasil.".
    searchLabelstringSearch commandsNama aksesibel kolom pencarian. Isi misalnya "Cari perintah".
    dialogLabelstringCommand paletteNama aksesibel dialog dan daftar hasil. Isi misalnya "Palet perintah".
    onSelect / @select / markas-select(value: string) => void-Dipanggil saat perintah dipilih dengan value-nya (atau label bila value kosong). Svelte: onselect. Blade dan Astro memancarkan event markas-select (bubble) dengan value di detail.
    idstringautoId dialog. Daftar dan opsi memakainya sebagai awalan.
    selectedoutput<string>-Khusus Angular. Dipancarkan dengan value (atau label) perintah yang dipilih.

    Aksesibilitas

    • Dialog modal native: fokus pindah ke kolom pencarian saat dibuka, tertahan di dalam dialog, dan kembali ke pemicu saat ditutup.
    • Kolom pencarian adalah combobox dengan aria-controls ke daftar hasil role=listbox dan aria-activedescendant ke opsi yang disorot.
    • Panah bawah dan atas memindah sorotan (berputar di ujung), Enter menjalankan perintah yang disorot, Escape menutup dialog.
    • Opsi dikelompokkan dengan role=group berlabel judul grup; pesan kosong menggantikan daftar saat tidak ada yang cocok.

    Komponen terkait

    Komponen overlay lain dengan class yang sama di setiap framework.