VibeUI

Buttons

Command Button

Кнопка команды с подсказкой горячей клавиши: справа настоящие клавиши с объёмом, которые нажимаются на наведении. Самодостаточна: один файл, без зависимостей.

  • button
  • command
  • shortcut
  • keyboard
  • search

Превью

1440pxHost theme

Использовать с AI

  1. 1. Скопируйте ссылку.
  2. 2. Напишите агенту своими словами и вставьте её в предложение.
  3. 3. Агент откроет ссылку и поставит компонент из registry.
Показать полную инструкцию

То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.

# Установка и размещение «button-008» (Command Button) из VibeUI

## 1. Сначала установка — не пропускай, не пересоздавай
Команда установки недоступна: URL реестра VibeUI не сконфигурирован.

Ставится в: components/vibeui/button-008.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.

Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.

## 2. Что это
Кнопка команды с подсказкой горячей клавиши: справа настоящие клавиши с объёмом, которые нажимаются на наведении. Самодостаточна: один файл, без зависимостей.

Светлая кнопка команды с подсказкой сочетания клавиш. Справа — не текстовый хвост, а настоящие клавиши: каждая нарисована отдельным kbd с внутренней обводкой и нижней гранью, дающей объём. На наведении клавиши «нажимаются» — грань уходит, они опускаются на пиксель. Подпись набрана обычным шрифтом, клавиши — моноширинным.

## 3. Как использовать
import { Button008 } from "@/components/vibeui/button-008"

<Button008 keys={["⌘", "K"]} onClick={openCommandMenu}>
  Быстрый поиск
</Button008>

Полный список пропсов — в установленном файле.

## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.

Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)

## 5. Сохранить как установлено
- клавиши как отдельные kbd с нижней гранью — плоский текстовый хвост убивает идею компонента
- эффект нажатия на наведении: грань исчезает, клавиши опускаются
- моноширинный шрифт клавиш против пропорционального у подписи
- aria-hidden на группе клавиш: это подсказка, а не содержание кнопки
- светлую нейтральную палитру — кнопка рассчитана на панель, а не на герой

## 6. Можно менять
- подпись кнопки
- набор клавиш — проп keys
- цвет символов клавиш — проп accent
- обработчик onClick
- внешние отступы через className

## 7. Правила
- Компонент только показывает сочетание. Обработчик горячей клавиши вешает приложение — не добавляй слушатель внутрь компонента.
- Держи keys в соответствии с реальным сочетанием и платформой пользователя, иначе подсказка врёт.
- Не выноси CSS-переменные в globals.css: компонент должен оставаться одним файлом.

## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.

Для разработчика

Команда установки недоступна: переменная окруженияREGISTRY_BASE_URL

Компонент самодостаточен: один файл, без зависимостей, собственная палитра в локальных переменных --vibeui-button-008-*. Клавиши задаются массивом keys и рисуются тегом kbd; объём даётся нижней гранью через box-shadow. Сам обработчик горячей клавиши компонент не вешает — это задача приложения.

Исходник компонента

Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.

import type { ComponentPropsWithoutRef, CSSProperties } from "react"

export type Button008Props = ComponentPropsWithoutRef<"button"> & {
  /** Клавиши подсказки. Каждая рисуется отдельной клавишей. */
  keys?: string[]
  accent?: string
}

// Идея компонента: кнопка сразу учит горячей клавише. Справа — настоящие
// клавиши с объёмом (нижняя грань и внутренняя подсветка), а не текстовый
// хвост. На наведении клавиши «нажимаются»: грань уходит, они опускаются.
const STYLES = `
:where([data-vibeui-block="button-008"]){
--vibeui-button-008-bg:oklch(0.98 0.002 265);
--vibeui-button-008-fg:oklch(0.3 0.014 265);
--vibeui-button-008-border:oklch(0.55 0.02 265 / 26%);
--vibeui-button-008-key-bg:oklch(1 0 0);
--vibeui-button-008-key-fg:oklch(0.45 0.015 265);
--vibeui-button-008-key-edge:oklch(0.55 0.02 265 / 34%);
--vibeui-button-008-ring:oklch(0.55 0.02 265 / 60%);
--vibeui-button-008-radius:0.625rem;
--vibeui-button-008-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
--vibeui-button-008-mono:ui-monospace,SFMono-Regular,Menlo,Consolas,"Liberation Mono",monospace;
}
[data-vibeui-block="button-008"]{
appearance:none;cursor:pointer;
display:inline-flex;align-items:center;gap:0.75rem;
height:2.5rem;padding:0 0.5rem 0 0.875rem;
border:1px solid var(--vibeui-button-008-border);border-radius:var(--vibeui-button-008-radius);
font-family:var(--vibeui-button-008-font);font-size:0.875rem;font-weight:500;line-height:1;
background:var(--vibeui-button-008-bg);color:var(--vibeui-button-008-fg);
transition:border-color .18s ease,background-color .18s ease;
}
[data-vibeui-block="button-008"] [data-part="keys"]{display:inline-flex;align-items:center;gap:0.1875rem;flex:none}
[data-vibeui-block="button-008"] [data-part="key"]{
min-width:1.375rem;height:1.375rem;padding:0 0.3125rem;border-radius:0.3125rem;
display:inline-flex;align-items:center;justify-content:center;
font-family:var(--vibeui-button-008-mono);font-size:0.6875rem;line-height:1;
color:var(--vibeui-button-008-key-fg);background:var(--vibeui-button-008-key-bg);
box-shadow:0 1px 0 0 var(--vibeui-button-008-key-edge),inset 0 0 0 1px var(--vibeui-button-008-key-edge);
transform:translateY(-1px);
transition:transform .14s ease,box-shadow .14s ease;
}
[data-vibeui-block="button-008"]:hover:not(:disabled){border-color:color-mix(in oklab, var(--vibeui-button-008-fg) 40%, transparent)}
[data-vibeui-block="button-008"]:hover:not(:disabled) [data-part="key"]{transform:translateY(0);box-shadow:inset 0 0 0 1px var(--vibeui-button-008-key-edge)}
[data-vibeui-block="button-008"]:focus-visible{outline:2px solid var(--vibeui-button-008-ring);outline-offset:2px}
[data-vibeui-block="button-008"]:disabled{cursor:not-allowed;opacity:.55}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="button-008"] *{transition:none!important}}
`

/**
 * Кнопка команды с подсказкой горячей клавиши на объёмных клавишах.
 * Один файл, ноль зависимостей, собственная палитра.
 */
export function Button008({
  keys = ["⌘", "K"],
  accent,
  type = "button",
  className,
  style,
  children = "Быстрый поиск",
  ...props
}: Button008Props) {
  const palette = {
    ...(accent ? { "--vibeui-button-008-key-fg": accent } : null),
    ...style,
  } as CSSProperties

  return (
    <>
      <style href="vibeui-button-008" precedence="medium">
        {STYLES}
      </style>
      <button
        {...props}
        type={type}
        data-vibeui-block="button-008"
        className={className}
        style={palette}
      >
        {children}
        <span data-part="keys" aria-hidden="true">
          {keys.map((key) => (
            <kbd data-part="key" key={key}>
              {key}
            </kbd>
          ))}
        </span>
      </button>
    </>
  )
}