Перейти до вмісту
tatetUI

Button

Основна кнопка дії з варіантами, розмірами та станом завантаження.

Використати у своєму проєкті

Вихідний код, залежності та стилі. Без клонування Git.

Завантажити ZIP
JSON для агентаДокументація Markdown
Файли для перенесення · 5

Підключення CSS та налаштування імпортів — в інструкції для агентів.

Кнопка — єдиний компонент, який є в усіх чотирьох вихідних проєктах, і скрізь написаний по-різному. Ця версія збирає рішення, кожне з яких закриває конкретний баг.

Приклад

Варіанти

solid — головна дія на екрані, і вона має бути одна. Решта — підпорядковані.

link не має ні висоти, ні полів розміру — лише шрифт, — і не стискається при натисканні: це текст посеред абзацу чи підвалу картки. Розміри для нього окремі, а не «перекриті» поверх звичайних: px-0 над px-4 вирішувався порядком класів у згенерованому CSS, і Tailwind ставив .px-0 раніше — посилання отримувало 11–19px полів з боків.

Вторинна дія: tonal чи outline

tonal — звичайна кнопка для другої дії поруч із головною: «Скасувати» у вікні, «Назад» у кроках форми, «Пізніше» в банері. Заливка — ink під 10% альфи, без рамки, як типова кнопка GNOME; наведення й натискання — 15% і 20%, ті самі кроки, що в хрестика UiModal і UiDrawer.

Опублікувати чернетку?

Сторінку побачить уся команда.

Доступна нова версія.

Беріть tonal замість outline, коли:

  • Кнопка стоїть у футері вікна чи панелі поруч із solid або danger. Шапки й футери UiModal та UiDrawer пласкі, структуру там тримають відступи, а не лінії, і рамка навколо «Скасувати» була останньою коробкою у вікні.
  • Тло — не картка. Заливка напівпрозора і бере відтінок поверхні: тла сторінки, кольорового банера, підкладки алерту. outline має непрозорий bg-card і на такому тлі стає окремою білою плиткою.
  • Потрібна однакова вага в обох темах. На темній картці outline має те саме тло, що й картка, і тримається лише на тонкій лінії --line; 10% ink читаються однаково на світлому й темному.

outline лишайте там, де межа щось означає: кнопка в одному ряду з полями (рамка вторить рамці поля, і ряд читається як одна панель фільтрів) і кнопки всередині UiButtonGroup — шви групи складаються з рамок сусідніх кнопок, накладених через -ml-px, і без рамки їх немає з чого зібрати.

Розміри

Ієрархія зберігається на ОБОХ екранах: sm 8 / md 9 / lg 11 на десктопі, 9 / 10 / 12 на мобільному. Точність дотику тримає не висота, а невидима зона 45×45 навколо кнопки (W3C 2.5.8 Target Size) — вмикається лише на пристрої з грубим вказівником (pointer-coarse), тому на телефоні дрібна sm-кнопка в панелі списку лишається дрібною, але палець у неї влучає.

Завантаження

Індикатор позиційований абсолютно, а вміст лише гасне до opacity-0. Кнопка не змінює ширину посеред запиту, тож сусідні елементи не стрибають.

API

Props

НазваТипТиповоОпис
typebuttonsubmitreset"button"Тип нативної кнопки. Ігнорується, коли задано `to`.
sizemdsmlgiconicon-sm"md"Висота кнопки. На мобільному ієрархія лишається: `sm` 9, `md` 10, `lg` 12 (у rem за кореня 15px), а точність дотику тримає невидима зона 44×44 (`pointer-coarse:`, див. нижче). `icon` і `icon-sm` — квадратні, для кнопок без тексту.
variantlinkdangersolidsofttonaloutlineghost"solid"Візуальна вага. `solid` — головна дія на екрані, вона має бути одна. `tonal` — звичайна вторинна дія поруч із головною («Скасувати», «Назад»): нейтральна напівпрозора заливка без рамки, як типова кнопка GNOME. `link` — виглядає як посилання в тексті, але лишається кнопкою: «Показати ще», «Скинути фільтри» посеред абзацу чи підвалу картки.
labelstring—Доступна назва. ОБОВ'ЯЗКОВИЙ для кнопок без тексту — інакше кнопка для скрінрідера безіменна.
titlestring—Нативна підказка при наведенні. Не замінює `label` для скрінрідера.
tostring | Record<string, unknown>—Робить кнопку посиланням: корінь стає `NuxtLink` замість `button`. Потрібно, коли дія веде на іншу сторінку — інакше зникає середній клік, Ctrl+клік і пункт «відкрити в новій вкладці».
loadingboolean—Блокує кліки й показує індикатор, зберігаючи ширину кнопки.
disabledboolean—Блокує кліки. На відміну від `loading`, не показує індикатора.
blockboolean—Розтягує кнопку на всю ширину контейнера.

Події

НазваPayloadОпис
click[event: MouseEvent]Клік по кнопці. Не спрацьовує, поки вона `disabled` або `loading`.

Слоти

НазваОпис
defaultВміст кнопки — зазвичай текст.
leadingІконка перед текстом.
trailingІконка після тексту.

Доступно через ref

НазваТипОпис
focus() => voidСтавить фокус на кнопку. Використовує ConfirmDialog.

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

Для дій, що щось змінюють: надіслати форму, зберегти, видалити.

Якщо дія веде на іншу сторінку — передайте to. Корінь стане NuxtLink, і повернеться середній клік, Ctrl+клік та «відкрити в новій вкладці», яких у <button @click="navigateTo(...)"> немає.

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

Не ставте variant="solid" двом кнопкам поруч: якщо головні обидві, то головної немає жодної.

Для кнопок без тексту обов'язковий label — інакше кнопка для скрінрідера безіменна.

Доступність

Фокус-кільце видиме: focus-visible:ring-2 на токені --ring, з ring-offset, який відриває кільце від заливки. У вихідних проєктах focus:outline-none стоїть майже всюди без заміни — керування з клавіатури там сліпе.

Під час завантаження кнопка отримує aria-busy, а кліки блокуються і на рівні обробника, і атрибутом disabled. Індикатор несе прихований текст «Завантаження»: жива область без тексту, лише з aria-label, не мала що оголосити.