AiButtonGigaMama
Увеличенная кнопка формы с центрированной группой глобуса и подписи.
Демо
appearancedata-test-iddisabledlabelloading<AiButtonGigaMama label="Создать ресурс" appearance="primary" loading={false} disabled={false} />Когда использовать
Компонент показывает действие потребителя. Условия показа и результат нажатия задаёт приложение; кнопка не хранит результат и не выполняет запросов.
Анатомия
Appearance (default primary)
primaryиспользует зелёную подпись из primary/text.neutralиспользует подпись из neutral/text.
Глобус остаётся цветным в обоих оформлениях и при недоступности. Общие правила состояний и согласованное расхождение контраста описаны в обзоре пакета.
Ширина (default 304px)
Высота равна 72 px. Боковые отступы используют токен 16 px, обводка — 2 px, глобус — 24 px, зазор — 4 px. Ширина 304 px штатная: её можно изменить через style или className, например до 480 px. На узком родителе кнопка занимает не больше его доступной ширины.
Короткая подпись имеет естественную ширину; группа подписи и глобуса центрируется. Длинная подпись обрезается многоточием в одну строку. Доступная ширина пересчитывается при изменении размера: W − 2×16 − 2×2 − 24 − 4. Она равна 240 px при 304 px и 416 px при 480 px.
В Figma подпись занимает ширину содержимого (Hug) без maxWidth, maxHeight и maxLines по прямому решению владельца; однострочная обрезка является поведением кода.
<AiButtonGigaMama label='Создать виртуальную машину' style={{ width: 480 }} />
Loading и Disabled (default false)
loading заменяет глобус индикатором, блокирует действие и задаёт aria-busy. При одновременных loading=true и disabled=true отображается загрузка: кнопка сохраняет фокус, повторное действие и отправление формы заблокированы. После выключения loading остающийся disabled нативно исключает кнопку из обхода клавиатуры. Флаги задаёт потребитель.
Установка
import { AiButtonGigaMama } from '@cloud-ru/ds-ai-button-giga';
Примеры использования
Действие и завершение загрузки
Количество запусков: 0.
import { AiButtonGigaMama } from '@cloud-ru/ds-ai-button-giga';
import { useState } from 'react';
export function MamaExample() {
const [count, setCount] = useState(0);
const [loading, setLoading] = useState(false);
function handleClick() {
setCount(previous => previous + 1);
setLoading(true);
}
function handleComplete() {
setLoading(false);
}
return (
<div>
<AiButtonGigaMama 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
AiButtonGigaMamaProps| 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; глобус сохраняет цвет. |
innerRef | Ref<HTMLButtonElement> | — | no | Ссылка на корневой HTMLButtonElement. |
label | string | — | yes | Подпись действия. Длинный текст обрезается многоточием с учётом ширины кнопки и отступов. |
loading | boolean | — | no | Показывает индикатор и блокирует действие, сохраняя фокус и ширину кнопки. Имеет приоритет над disabled. |