AiButtonGigaMama

Увеличенная кнопка формы с центрированной группой глобуса и подписи.

Демо

Preview
Prop
Type
Value
appearance
primary | neutral
data-test-id
text
disabled
boolean
label
text
loading
boolean
Code
<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.

tsx
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

PropsAiButtonGigaMamaProps
PropTypeDefaultRequiredDescription
appearance"neutral" | "primary"—noОформление подписи: primary использует primary/text, neutral — neutral/text. Обводка есть у Outline и Mama.
classNamestring—noДополнительный CSS-класс корневой кнопки.
data-test-idstring—no
disabledboolean—noНативно отключает кнопку, когда loading=false; глобус сохраняет цвет.
innerRefRef<HTMLButtonElement>—noСсылка на корневой HTMLButtonElement.
labelstring—yesПодпись действия. Длинный текст обрезается многоточием с учётом ширины кнопки и отступов.
loadingboolean—noПоказывает индикатор и блокирует действие, сохраняя фокус и ширину кнопки. Имеет приоритет над disabled.

Unions

Types

AiButtonGigaMamaProps

Unions

Storybook

Figma