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>Contoh
Ukuran
<div class="flex flex-wrap items-center gap-6">
<div class="flex items-center gap-2">
<x-markas.kbd size="sm">Enter</x-markas.kbd>
<x-markas.kbd size="sm" :keys="['Shift', 'Tab']" />
</div>
<div class="flex items-center gap-2">
<x-markas.kbd>Enter</x-markas.kbd>
<x-markas.kbd :keys="['Shift', 'Tab']" />
</div>
</div>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
<button type="button" class="flex h-10 w-full items-center gap-2 rounded-lg border border-line bg-surface px-3 text-sm text-muted transition-colors duration-150 ease-out hover:bg-subtle focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary motion-reduce:transition-none">
<svg class="size-4" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="11" cy="11" r="7" /><path d="m20 20-3.5-3.5" /></svg>
<span>Search docs</span>
<x-markas.kbd size="sm" :keys="['Ctrl', 'K']" class="ml-auto" aria-hidden="true" />
</button>Instalasi
npx markasui@latest add kbdpnpm dlx markasui@latest add kbdyarn dlx markasui@latest add kbdbunx --bun markasui@latest add kbd- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
resources/views/components/markas/kbd.blade.php.
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/components/markas/Kbd.tsx.
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/components/markas/Kbd.vue.
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/lib/components/markas/Kbd.svelte.
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/components/markas/Kbd.astro.
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/app/markas/kbd.component.ts.
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.
keysmerender<kbd>. Tanpa<kbd>Ctrl </kbd> <span>+</span> <kbd>K </kbd> </kbd> 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
| Nama | Tipe | Default | Keterangan |
|---|---|---|---|
size | 'sm' | 'md' | md | Tinggi keycap dan ukuran teks. Pakai sm di dalam tombol dan input. |
keys | string[] | [] | Kombinasi tombol. Setiap tombol dirender sebagai keycap sendiri di dalam kbd luar. Menggantikan slot atau children. |
separator | string | + | Teks muted di antara tombol pada kombinasi, misalnya "lalu" untuk urutan tombol. |
children / slot | ReactNode / 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.
- AvatarFoto profil bulat dengan tiga ukuran dan inisial nama sebagai fallback saat gambar kosong atau gagal dimuat.
- CardKartu untuk mengelompokkan konten dengan judul, deskripsi, isi, dan footer opsional.
- CarouselDeretan slide berbasis CSS scroll snap dengan tombol sebelumnya dan berikutnya, titik opsional, dan navigasi panah. Tanpa autoplay.
- Code BlockBlok kode monospace dengan nama file opsional, nomor baris, dan tombol salin. Teks polos tanpa pewarnaan sintaks.
- Scroll AreaKontainer bergulir dengan scrollbar tipis berwarna token yang bisa difokus dan digulir lewat keyboard. Tanpa JavaScript.
- SeparatorGaris pemisah horizontal atau vertikal, dekoratif secara default, dengan label opsional di tengah garis seperti "atau".