# Kbd

Клавіатурна підказка — клавіша або послідовність із розпізнаванням модифікаторів.


Дрібний елемент, без якого сучасні інтерфейси втрачають «клавіатурність»:
підказки в меню, у палітрі команд, у футері пошуку. Написаний самостійно,
бо з тостів і палітри він тепер потрібен у кількох місцях одразу.

## Приклад


Example (app/demos/kbd/KbdBasic.vue):

```vue
<script setup lang="ts">
import UiKbd from '~/components/ui/UiKbd.vue'
</script>

<template>
  <div class="flex flex-wrap items-center gap-2">
    <UiKbd combo="K" />
    <UiKbd :combo="['Ctrl', 'K']" />
    <UiKbd combo="Escape" />
    <UiKbd :combo="['Meta', 'Shift', 'P']" />
    <UiKbd combo="q" :uppercase="false" />
    <UiKbd>⏎</UiKbd>
  </div>
</template>
```


Модифікатори розпізнаються за назвою: `meta`/`cmd` → ⌘, `alt` → ⌥,
`shift` → ⇧, `enter` → ↵, `escape` → Esc, стрілки → ↑↓←→. Звичайні
клавіші піднімаються в регістрі (`uppercase`, вимикається).

## API

[Props, events, slots, exposed API (JSON)](https://ui.tatet.net/api/component-meta/UiKbd)

## Коли використовувати

Поряд із діями, які реально мають клавіатурний шлях: пошук (⌘K),
закриття (Esc), підтвердження (↵).

## Коли НЕ використовувати

Не показуйте послідовність, якої немає: невиконана клавіатурна підказка
гірша за її відсутність. Для послідовностей типу «g потім d» краще текст,
а не два Kbd підряд.

## Доступність

Елемент — семантичний `<kbd>`. Комбінації читаються скрінрідером як
текст; розділювач «+» прихований (`aria-hidden`) — читається «Ctrl K»,
а не «Плюс».

[Source files, dependencies and ZIP](https://ui.tatet.net/registry/components/kbd.json)
