Lewati ke konten
MarkasUI
Ketik untuk mencari

    Panduan

    MarkasUI

    Form

    Feedback

    Overlay

    Navigasi

    Data

    Section

    Animasi

    Latar

    Tombol

    Template

    Halaman

    Kbd

    Keycap untuk shortcut keyboard memakai elemen kbd native, dua ukuran, dengan kombinasi tombol dirender sebagai keycap terpisah.

    Press Ctrl+K to search, or Esc to close.

    Press Ctrl+K to search, or Esc to close.

    Press Ctrl+K to search, or Esc to close.

    Press Ctrl+K to search, or Esc to close.

    Press Ctrl+K to search, or Esc to close.

    <p class="flex flex-wrap items-center gap-1.5 text-sm text-ink">
        Press <x-markas.kbd :keys="['Ctrl', 'K']" /> to search, or <x-markas.kbd>Esc</x-markas.kbd> to close.
    </p>
    import { Kbd } from "@/components/markas/Kbd";
    
    export default function KbdExample() {
      return (
        <p className="flex flex-wrap items-center gap-1.5 text-sm text-ink">
          Press <Kbd keys={["Ctrl", "K"]} /> to search, or <Kbd>Esc</Kbd> to close.
        </p>
      );
    }
    <script setup lang="ts">
    import Kbd from "@/components/markas/Kbd.vue";
    </script>
    
    <template>
      <p class="flex flex-wrap items-center gap-1.5 text-sm text-ink">
        Press <Kbd :keys="['Ctrl', 'K']" /> to search, or <Kbd>Esc</Kbd> to close.
      </p>
    </template>
    <script lang="ts">
      import Kbd from "$lib/components/markas/Kbd.svelte";
    </script>
    
    <p class="flex flex-wrap items-center gap-1.5 text-sm text-ink">
      Press <Kbd keys={["Ctrl", "K"]} /> to search, or <Kbd>Esc</Kbd> to close.
    </p>
    ---
    import Kbd from "@/components/markas/Kbd.astro";
    ---
    
    <p class="flex flex-wrap items-center gap-1.5 text-sm text-ink">
      Press <Kbd keys={["Ctrl", "K"]} /> to search, or <Kbd>Esc</Kbd> to close.
    </p>
    import { Component } from "@angular/core";
    import { Kbd } from "./markas/kbd.component";
    
    @Component({
      selector: "markas-example",
      imports: [Kbd],
      template: `
        <p class="flex flex-wrap items-center gap-1.5 text-sm text-ink">
          Press <kbd markas-kbd [keys]="['Ctrl', 'K']"></kbd> to search, or
          <kbd markas-kbd>Esc</kbd> to close.
        </p>
      `,
    })
    export default class KbdExample {}

    Contoh

    Ukuran

    Enter Shift+Tab
    Enter Shift+Tab
    EnterShift+Tab
    EnterShift+Tab
    EnterShift+Tab
    EnterShift+Tab
    Enter Shift+Tab
    Enter Shift+Tab
    EnterShift+Tab
    EnterShift+Tab

    Daftar shortcut

    Search
    Ctrl+K
    New document
    Ctrl+Alt+N
    Go to next page
    GthenN
    Show shortcuts
    ?
    Search
    Ctrl+K
    New document
    Ctrl+Alt+N
    Go to next page
    GthenN
    Show shortcuts
    ?
    Search
    Ctrl+K
    New document
    Ctrl+Alt+N
    Go to next page
    GthenN
    Show shortcuts
    ?
    Search
    Ctrl+K
    New document
    Ctrl+Alt+N
    Go to next page
    GthenN
    Show shortcuts
    ?
    Search
    Ctrl+K
    New document
    Ctrl+Alt+N
    Go to next page
    GthenN
    Show shortcuts
    ?

    Dalam tombol cari

    Instalasi

    npx markasui@latest add kbd

    Pemakaian

    <x-markas.kbd>Esc</x-markas.kbd>
    <x-markas.kbd :keys="['Ctrl', 'K']" />
    <x-markas.kbd size="sm" :keys="['G', 'N']" separator="lalu" />
    import { Kbd } from "@/components/markas/Kbd";
    
    <Kbd>Esc</Kbd>
    <Kbd keys={["Ctrl", "K"]} />
    <Kbd size="sm" keys={["G", "N"]} separator="lalu" />
    <template>
      <Kbd>Esc</Kbd>
      <Kbd :keys="['Ctrl', 'K']" />
      <Kbd size="sm" :keys="['G', 'N']" separator="lalu" />
    </template>
    <script lang="ts">
      import Kbd from "$lib/components/markas/Kbd.svelte";
    </script>
    
    <Kbd>Esc</Kbd>
    <Kbd keys={["Ctrl", "K"]} />
    <Kbd size="sm" keys={["G", "N"]} separator="then" />
    ---
    import Kbd from "@/components/markas/Kbd.astro";
    ---
    
    <Kbd>Esc</Kbd>
    <Kbd keys={["Ctrl", "K"]} />
    <Kbd size="sm" keys={["G", "N"]} separator="then" />
    import { Component } from "@angular/core";
    import { Kbd } from "./markas/kbd.component";
    
    @Component({
      selector: "app-example",
      imports: [Kbd],
      template: `
        <kbd markas-kbd>Esc</kbd>
        <kbd markas-kbd [keys]="['Ctrl', 'K']"></kbd>
        <kbd markas-kbd size="sm" [keys]="['G', 'N']" separator="then"></kbd>
      `,
    })
    export class Example {}

    Angular memakai attribute selector pada kbd native, jadi class dan aria-hidden tetap di elemen itu.

    • Tanpa JavaScript. Versi Blade tidak butuh Alpine.js.
    • keys merender <kbd><kbd>Ctrl</kbd><span>+</span><kbd>K</kbd></kbd>. Tanpa keys, slot atau children mengisi satu keycap.
    • Di dalam tombol yang sudah punya nama, tambahkan aria-hidden="true" agar shortcut tidak dibaca dua kali.
    • Pemisah default ”+”. Ganti lewat separator, misalnya “lalu” untuk urutan tombol dalam Bahasa Indonesia.

    Props

    NamaTipeDefaultKeterangan
    size'sm' | 'md'mdTinggi keycap dan ukuran teks. Pakai sm di dalam tombol dan input.
    keysstring[][]Kombinasi tombol. Setiap tombol dirender sebagai keycap sendiri di dalam kbd luar. Menggantikan slot atau children.
    separatorstring+Teks muted di antara tombol pada kombinasi, misalnya "lalu" untuk urutan tombol.
    children / slotReactNode / slot / snippet-Isi satu keycap bila keys kosong.

    Aksesibilitas

    • Memakai elemen kbd native; kombinasi menyusun satu kbd per tombol di dalam kbd luar, sesuai anjuran spesifikasi HTML.
    • Pemisah berupa teks biasa sehingga pembaca layar membacakan kombinasi seperti "Ctrl + K".
    • Pasang aria-hidden pada keycap bila shortcut hanya petunjuk visual di dalam kontrol yang sudah punya nama.

    Komponen terkait

    Komponen data lain dengan class yang sama di setiap framework.