VibeUI

Buttons

Icon Button

Кнопка без подписи, у которой имя всё равно есть: оно уходит в aria-label и title, а значки нарисованы бордюрами.

  • button
  • icon
  • compact
  • a11y

Превью

1440pxHost theme

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

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

размести это в шапке: https://vibeui.ru/c/button-012

Показать полную инструкцию

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

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

## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/button-012.json

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

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

## 2. Что это
Кнопка без подписи, у которой имя всё равно есть: оно уходит в aria-label и title, а значки нарисованы бордюрами.

Квадратная или круглая кнопка со значком: четыре готовых значка из бордюров, три размера, два тона и обязательное имя действия. Ноль зависимостей, один файл, клиентского JS нет.

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

<Button012 label="Добавить" icon="plus" tone="accent" />

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

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

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

## 5. Сохранить как установлено
- локальную палитру --vibeui-button-012-* и не подменять её токенами вашей темы
- aria-label и title: кнопка без подписи обязана называть действие
- размер одной переменной — иконочные кнопки в ряду должны совпадать
- значки на бордюрах вместо пакета иконок ради четырёх фигур
- видимое фокусное кольцо: у маленькой цели оно важнее всего
- минимальный размер 1.875rem — в меньшую цель не попасть пальцем

## 6. Можно менять
- label — что делает кнопка
- icon — plus, close, more или search
- shape и size
- tone — neutral или accent

## 7. Правила
- Иконка без подписи уместна только для общеизвестных действий: закрыть, добавить, искать. Всё остальное подписывайте словом.
- Свой значок кладите внутрь как дочерний элемент, заменив спан со значком в копии компонента.
- title показывается только на мыши: он дополняет aria-label, но не заменяет его.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.

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

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

npx shadcn@latest add https://vibeui.ru/r/button-012.json
https://vibeui.ru/r/button-012.json

Компонент самодостаточен: один файл, без зависимостей, собственная палитра в локальных переменных --vibeui-button-012-*. Серверный: хуков нет. Размер задан одной переменной, форма и тон — атрибутами data-shape и data-tone. Четыре значка (плюс, крестик, многоточие, лупа) собраны из бордюров и псевдоэлементов, поэтому иконочный пакет не подключается. Имя действия обязательно и дублируется в title.

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

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

import type { ComponentPropsWithoutRef, CSSProperties } from "react"

export type Button012Shape = "circle" | "square"

export type Button012Props = Omit<
  ComponentPropsWithoutRef<"button">,
  "children"
> & {
  /** Что делает кнопка. Обязателен: у иконки нет текста. */
  label?: string
  icon?: "plus" | "close" | "more" | "search"
  shape?: Button012Shape
  size?: "sm" | "md" | "lg"
  tone?: "neutral" | "accent"
}

// Идея компонента: кнопка без подписи, у которой имя всё равно есть. Оно
// уходит в aria-label и в title: иконка без имени — тупик и для скринридера,
// и для человека, который видит её впервые. Значки нарисованы бордюрами и
// псевдоэлементами, поэтому иконочный пакет не нужен.
const STYLES = `
:where([data-vibeui-block="button-012"]){
--vibeui-button-012-size:2.25rem;
--vibeui-button-012-fg:oklch(0.3 0.014 265);
--vibeui-button-012-bg:oklch(1 0 0);
--vibeui-button-012-border:oklch(0.9 0.006 265);
--vibeui-button-012-hover:oklch(0.96 0.004 265);
--vibeui-button-012-accent:oklch(0.55 0.17 265);
--vibeui-button-012-radius:0.625rem;
}
[data-vibeui-block="button-012"]{
appearance:none;cursor:pointer;
display:inline-flex;align-items:center;justify-content:center;flex:none;
width:var(--vibeui-button-012-size);height:var(--vibeui-button-012-size);
padding:0;box-sizing:border-box;
border:1px solid var(--vibeui-button-012-border);
border-radius:var(--vibeui-button-012-radius);
background:var(--vibeui-button-012-bg);color:var(--vibeui-button-012-fg);
transition:background-color .16s ease,border-color .16s ease;
}
[data-vibeui-block="button-012"][data-shape="circle"]{border-radius:9999px}
[data-vibeui-block="button-012"][data-size="sm"]{--vibeui-button-012-size:1.875rem;--vibeui-button-012-radius:0.5rem}
[data-vibeui-block="button-012"][data-size="lg"]{--vibeui-button-012-size:2.75rem;--vibeui-button-012-radius:0.75rem}
[data-vibeui-block="button-012"][data-tone="accent"]{
border-color:transparent;background:var(--vibeui-button-012-accent);color:oklch(0.99 0.01 265);
}
[data-vibeui-block="button-012"]:hover{background:var(--vibeui-button-012-hover)}
[data-vibeui-block="button-012"][data-tone="accent"]:hover{filter:brightness(0.95);background:var(--vibeui-button-012-accent)}
[data-vibeui-block="button-012"]:focus-visible{outline:2px solid var(--vibeui-button-012-accent);outline-offset:2px}
[data-vibeui-block="button-012"]:disabled{cursor:not-allowed;opacity:.5}
/* Значки на бордюрах: ради четырёх фигур пакет иконок не подключают. */
[data-vibeui-block="button-012"] [data-part="glyph"]{position:relative;width:0.875rem;height:0.875rem}
[data-vibeui-block="button-012"] [data-icon="plus"]::before,
[data-vibeui-block="button-012"] [data-icon="plus"]::after,
[data-vibeui-block="button-012"] [data-icon="close"]::before,
[data-vibeui-block="button-012"] [data-icon="close"]::after{
content:"";position:absolute;left:50%;top:50%;background:currentColor;border-radius:9999px;
}
[data-vibeui-block="button-012"] [data-icon="plus"]::before{width:0.75rem;height:1.5px;margin:-0.75px 0 0 -0.375rem}
[data-vibeui-block="button-012"] [data-icon="plus"]::after{width:1.5px;height:0.75rem;margin:-0.375rem 0 0 -0.75px}
[data-vibeui-block="button-012"] [data-icon="close"]::before,
[data-vibeui-block="button-012"] [data-icon="close"]::after{width:0.75rem;height:1.5px;margin:-0.75px 0 0 -0.375rem}
[data-vibeui-block="button-012"] [data-icon="close"]::before{transform:rotate(45deg)}
[data-vibeui-block="button-012"] [data-icon="close"]::after{transform:rotate(-45deg)}
[data-vibeui-block="button-012"] [data-icon="more"]{
display:flex;align-items:center;justify-content:center;gap:0.1875rem;
}
[data-vibeui-block="button-012"] [data-icon="more"] i{width:0.1875rem;height:0.1875rem;border-radius:9999px;background:currentColor}
[data-vibeui-block="button-012"] [data-icon="search"]::before{
content:"";position:absolute;left:0;top:0;width:0.625rem;height:0.625rem;
border:1.5px solid currentColor;border-radius:9999px;
}
[data-vibeui-block="button-012"] [data-icon="search"]::after{
content:"";position:absolute;right:0.0625rem;bottom:0.0625rem;
width:0.375rem;height:1.5px;background:currentColor;transform:rotate(45deg);
}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="button-012"] *{animation:none!important;transition:none!important}}
`

/**
 * Кнопка-иконка, у которой имя всё равно есть: aria-label и title.
 * Один файл, ноль зависимостей, собственная палитра.
 */
export function Button012({
  label = "Добавить",
  icon = "plus",
  shape = "square",
  size = "md",
  tone = "neutral",
  type = "button",
  className,
  style,
  ...props
}: Button012Props) {
  return (
    <>
      <style href="vibeui-button-012" precedence="medium">
        {STYLES}
      </style>
      <button
        {...props}
        type={type}
        data-vibeui-block="button-012"
        data-shape={shape}
        data-size={size}
        data-tone={tone}
        className={className}
        style={style as CSSProperties}
        aria-label={label}
        title={label}
      >
        <span data-part="glyph" data-icon={icon} aria-hidden="true">
          {icon === "more" ? (
            <>
              <i />
              <i />
              <i />
            </>
          ) : null}
        </span>
      </button>
    </>
  )
}