AiButtonGigaOutline

Кнопка с обводкой, подписью и сменной иконкой.

Демо

Preview
Prop
Type
Value
appearance
primary | neutral
data-test-id
text
disabled
boolean
icon
text
iconPosition
after | before
label
text
loading
boolean
size
xs | s | m | l
Code
<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.

tsx
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

PropsAiButtonGigaOutlineProps
PropTypeDefaultRequiredDescription
appearance"neutral" | "primary"—noОформление подписи: primary использует primary/text, neutral — neutral/text. Обводка есть у Outline и Mama.
classNamestring—noДополнительный CSS-класс корневой кнопки.
data-test-idstring—no
disabledboolean—noНативно отключает кнопку, когда loading=false; глобус сохраняет цвет.
iconReactNode—noСменная иконка. По умолчанию — цветной глобус; null скрывает иконку.
iconPosition"after" | "before"—noПоложение иконки относительно подписи. По умолчанию before.
innerRefRef<HTMLButtonElement>—noСсылка на корневой HTMLButtonElement.
labelstring—noОднострочная подпись. Без подписи показывается квадратная кнопка с иконкой.
loadingboolean—noПоказывает индикатор и блокирует действие, сохраняя фокус и ширину кнопки. Имеет приоритет над disabled.
size"l" | "m" | "s" | "xs"snoРазмер: xs = 24, s = 32, m = 40, l = 48 px по высоте. По умолчанию s.

Unions

Types

AiButtonGigaOutlineProps

Unions

Storybook

Figma