GrDropdown

Компонент не знает, что именно потребитель положит в слот #trigger, поэтому клик, клавиатуру и ARIA он отдаёт объектом, который нужно привязать к настоящему фокусируемому элементу:

<GrDropdown>
  <template #trigger="{ triggerProps }">
    <GrButton variant="outline" v-bind="triggerProps">Действия</GrButton>
  </template>

  <template #content>
    <button type="button" role="menuitem">Дублировать</button>
  </template>
</GrDropdown>

Обёртка слота клики не ловит намеренно: иначе панель переключала бы любой клик внутри неё — включая вложенные кнопки и ссылки. Забытый v-bind в dev-сборке печатает предупреждение: молча неработающий триггер искали бы в чужом коде.

Слот отдаёт ещё open, toggle и close — для своей разметки состояния.

• placement — любое значение floating-ui (bottom-end по умолчанию). Переворот при нехватке места (flip) работает всегда: placement — это предпочтение, а не приказ, и transform-origin панели следует за фактической стороной;
• offset — зазор между триггером и панелью, px;
• width — CSS-длина: число трактуется как пиксели, строка идёт как есть, auto отдаёт ширину контенту. Tailwind-шкалы (width="48" → w-48) больше нет; строка без единиц трактуется как пиксели и в dev-сборке ругается.

trigger="click" (по умолчанию) или "hover". В режиме наведения задержки задают openDelay/closeDelay: без первой панель выпрыгивает на любое пересечение курсором, без второй её не удержать при переходе с триггера на панель — между ними зазор offset.

Клик и клавиатура работают в обоих режимах: меню, доступное только мышью, недоступно с клавиатуры вовсе.

disabled закрывает панель и не даёт открыть её ни кликом, ни клавиатурой, ни наведением. Триггер при этом остаётся фокусируемым и получает aria-disabled — нативный disabled выкинул бы его из таб-порядка вместе с объяснением, что происходит.

open(), close() и toggle() через ref на компоненте — тот же состав, что у остальных оверлеев. В отличие от модальных, меню состояние держит само: модели у него нет, и методы правят его напрямую. disabled императив не обходит — иначе он открывал бы то, что закрыто для клика и клавиатуры.

Те же три метода приходят в слот #trigger (:open, :toggle, :close) — ref нужен, когда открывать меню надо снаружи разметки триггера.

Enter/Space/↓ открывают панель с фокусом на первом пункте, ↑ — на последнем. Внутри: ↓/↑ по пунктам, Home/End к краям, Tab закрывает, Esc закрывает и возвращает фокус на триггер (этим распоряжается общий стек слоёв, а не сам компонент).

Печатный символ — typeahead по первой букве: буфер копится, пока паузы между нажатиями короче 600 мс, а повтор одной и той же буквы означает «следующий пункт на неё», а не поиск «аа». Ищется по видимому тексту пункта.

Space при пустом буфере не перехватывается: пункты меню — кнопки, и пробел для них родная клавиша активации. В запрос он попадает, только когда поиск уже идёт (правило typeahead из WAI-ARIA APG).

Контролы внутри панели

С closeOnContentClick={false} в панели живёт не меню, а содержимое — поля, чекбоксы, переключатели. Клавиши, которые сфокусированный контрол умеет сам, достаются ему: печатные символы и Home/End не уходят в навигацию по пунктам, пока фокус в input, textarea, select или contenteditable.

Стрелки — намеренное исключение: они остаются за панелью даже в поле. Tab панель закрывает, и без стрелок из поля внутри неё не было бы выхода. Ими же до поля и добираются: в кольцо навигации входит всё фокусируемое, а не только пункты меню.

Кроме императивного API панель управляема декларативно: без пропа open — прежнее uncontrolled-поведение, с ним состоянием владеет родитель, а update:open сопровождает каждое изменение (общий контракт панельных оверлеев, как у GrPopover). Hover-задержки в controlled-режиме те же: компонент эмитит, применяет родитель.