Kbd: HextaUI ve shadcn/ui

HextaUI Kbd, shadcn/ui adlarını ve tema token’larını korur ve aynı CLI ile kurulur. Bu sayfa, ikisinin kaynağından okunan farkları listeler. shadcn/ui tarafı, 2026-10-16 itibarıyla base-vega kayıt defteridir.

Bir bakışta

Ölçüt	HextaUI	shadcn/ui
Dışa aktarılan parçalar	2	2
Sarmalayıcının işlediği props	11	0
Kaynak kod satırı	195	26
npm bağımlılıkları	`@base-ui/react@^1.8.0class-variance-authoritycn`	`cn`
Şunlardan oluşur	`hotkeythemeuse-held-keys`	–

Daha fazla kod tek başına daha iyi değildir. HextaUI’deki ek satırların çoğu, aksi halde kendiniz yazacağınız durumları, hareketi ve uç durumları ele alır.

HextaUI’nin eklediği props

HextaUI sarmalayıcısının kendisinin işlediği, shadcn/ui sarmalayıcısının işlemediği props. Doğrudan Base UI’ye veya alttaki kütüphaneye geçirilen props, iki sürüm de kabul ettiği için listede yok.

Prop	Ne yapar
`listen`Kbd	Gerçek tuşu basılı tutulurken tuş başlığını bastırır. keys ile veya alt öğe olarak düz bir tuş adıyla çalışır.
`variant`KbdGroup	İçerideki her tuş başlığına iletilir.
`size`KbdGroup	İçerideki her tuş başlığına iletilir.
`listen`KbdGroup	İçerideki her tuş başlığına iletilir.
`separator`KbdGroup	Bir dizinin adımları arasında gösterilir.

Varyantlar

Prop	İkisinde de	Yalnızca HextaUI	Yalnızca shadcn/ui
`variant`Kbd	–	`keycapflat`	–
`size`Kbd	–	`smdefaultlg`	–

HextaUI sürümü

⇧Shift⌘CommandP

Press ⌘KCommand K to search, or hold ⇧Shift and watch the keys.

import { Kbd, KbdGroup } from "@/components/ui/kbd"

export function KbdDemo() {
  return (
    <div className="flex flex-col items-center gap-6 text-sm text-muted-foreground">
      <KbdGroup keys="mod+shift+p" size="lg" listen />
      <p>
        Press <Kbd keys="mod+k" listen /> to search, or hold{" "}
        <Kbd keys="shift" listen /> and watch the keys.
      </p>
    </div>
  )
}

Tüm durumlar, klavye haritası ve API başvurusu bileşen sayfasında.

Örneklerinden 7 tanesinin ayrıca kendi sayfası var.

Tek bir bileşeni değiştirin

@/components/ui içindeki shadcn/ui dosyasını değiştirmek için add komutunu --overwrite ile çalıştırın, ardından tutmadan önce git’teki farkı inceleyin. İçe aktarmalar aynı kalır ve değiştirmediğiniz bileşenler çalışmaya devam eder.

pnpm dlx shadcn@latest add https://hextaui.com/r/kbd.json --overwrite

Yukarıdaki tablodaki her prop bir eklemedir, bu yüzden shadcn/ui için yazılmış kod onu henüz geçirmez.
Geçmeden önce yalnızca shadcn/ui için listelenen parça ve varyantları kontrol edin ve en yakın HextaUI karşılığıyla eşleştirin.