AiButtonGigaOutline
Кнопка с обводкой, подписью и сменной иконкой.
Демо
appearancedata-test-iddisablediconiconPositionlabelloadingsize<AiButtonGigaOutline size="s" label="Создать ресурс" appearance="primary" loading={false} disabled={false} iconPosition="before" />Когда использовать
Компонент показывает действие потребителя. Условия показа и результат нажатия задаёт приложение; кнопка не хранит результат и не выполняет запросов.
Анатомия
Appearance (default primary)
primaryиспользует зелёную подпись из primary/text.neutralиспользует подпись из neutral/text.
Глобус остаётся цветным в обоих оформлениях и при недоступности. Общие правила состояний и согласованное расхождение контраста описаны в обзоре пакета.
Size (default s)
xsимеет высоту 24 px и иконку 16 px.sимеет высоту 32 px и иконку 24 px.mимеет высоту 40 px и иконку 24 px.lимеет высоту 48 px и иконку 24 px.
Подпись использует семейство шрифта и размеры из токенов Snack. У xs размер и высота строки остаются 11/14 px из label/s, а вес берётся из label/m, как у s. В бренде Cloud Console значение 550 выбирает Semibold вместо Regular. У m и l вес берётся из label/l.
IconPosition (default before)
beforeразмещает иконку слева от подписи.afterразмещает иконку справа от подписи.
Без label кнопка становится квадратной. icon=null с подписью показывает Label Only; сменная иконка задаётся icon. При загрузке Label Only сохраняет ширину и доступное имя скрытой подписи, а индикатор появляется по центру. Подпись занимает одну строку без обрезки.
Loading и Disabled (default false)
loading заменяет глобус индикатором, блокирует действие и задаёт aria-busy. При одновременных loading=true и disabled=true отображается загрузка: кнопка сохраняет фокус, повторное действие и отправление формы заблокированы. После выключения loading остающийся disabled нативно исключает кнопку из обхода клавиатуры. Флаги задаёт потребитель.
Установка
import { AiButtonGigaOutline } from '@cloud-ru/ds-ai-button-giga';
Примеры использования
Действие и завершение загрузки
Количество запусков: 0.
import { AiButtonGigaOutline } from '@cloud-ru/ds-ai-button-giga';
import { useState } from 'react';
export function OutlineExample() {
const [count, setCount] = useState(0);
const [loading, setLoading] = useState(false);
function handleClick() {
setCount(previous => previous + 1);
setLoading(true);
}
function handleComplete() {
setLoading(false);
}
return (
<div>
<AiButtonGigaOutline label='Создать ресурс' loading={loading} onClick={handleClick} />
<button type='button' onClick={handleComplete} disabled={!loading}>
Завершить загрузку
</button>
<p role='status'>Количество запусков: {count}.</p>
</div>
);
}Правила использования
- ✅ Передавайте понятную подпись или доступное имя через aria-label для кнопки без подписи.
- ❌ Не оставляйте кнопку без доступного имени.
- ✅ Управляйте loading и disabled по состоянию операции в приложении.
- ❌ Не ожидайте, что кнопка самостоятельно выполнит запрос и завершит загрузку.
- ✅ Выбирайте neutral через appearance и сохраняйте фирменный глобус.
- ❌ Не перекрашивайте глобус в серый вместе с подписью.
- ✅ Для отправления формы передавайте type=submit.
- ❌ Не рассчитывайте, что обычная кнопка с type=button отправит форму.
Props
Types
AiButtonGigaOutlineProps| Prop | Type | Default | Required | Description |
|---|---|---|---|---|
appearance | "neutral" | "primary" | — | no | Оформление подписи: primary использует primary/text, neutral — neutral/text. Обводка есть у Outline и Mama. |
className | string | — | no | Дополнительный CSS-класс корневой кнопки. |
data-test-id | string | — | no | |
disabled | boolean | — | no | Нативно отключает кнопку, когда loading=false; глобус сохраняет цвет. |
icon | ReactNode | — | no | Сменная иконка. По умолчанию — цветной глобус; null скрывает иконку. |
iconPosition | "after" | "before" | — | no | Положение иконки относительно подписи. По умолчанию before. |
innerRef | Ref<HTMLButtonElement> | — | no | Ссылка на корневой HTMLButtonElement. |
label | string | — | no | Однострочная подпись. Без подписи показывается квадратная кнопка с иконкой. |
loading | boolean | — | no | Показывает индикатор и блокирует действие, сохраняя фокус и ширину кнопки. Имеет приоритет над disabled. |
size | "l" | "m" | "s" | "xs" | s | no | Размер: xs = 24, s = 32, m = 40, l = 48 px по высоте. По умолчанию s. |