# @cloud-ru/ds-ai-button-giga > Кнопки Гига-помощника с обводкой, без обводки и увеличенная кнопка формы. Docs: /snack-v2/components/ai-button-giga/ ## Установка ```sh pnpm add @cloud-ru/ds-ai-button-giga ``` ## Когда использовать | Компонент | Назначение | | ---------------------------------- | --------------------------------------------------------------------------------------------- | | [AiButtonGigaOutline](./outline) | Показывает действие с фирменной или нейтральной обводкой и поддерживает сменную иконку. | | [AiButtonGigaFunction](./function) | Показывает действие без постоянной обводки, с глобусом и необязательной подписью. | | [AiButtonGigaMama](./mama) | Показывает увеличенную кнопку формы высотой 72 px с подписью, ограниченной доступной шириной. | ## API ### AiButtonGigaFunction | 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` | — | 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. | #### Related types - `Appearance` = `neutral | primary` - `Size` = `l | m | s | xs` ### AiButtonGigaMama | 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` | — | no | Ссылка на корневой HTMLButtonElement. | | `label` | `string` | — | yes | Подпись действия. Длинный текст обрезается многоточием с учётом ширины кнопки и отступов. | | `loading` | `boolean` | — | no | Показывает индикатор и блокирует действие, сохраняя фокус и ширину кнопки. Имеет приоритет над disabled. | #### Related types - `Appearance` = `neutral | primary` ### AiButtonGigaOutline | 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` | — | 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. | #### Related types - `Appearance` = `neutral | primary` - `IconPosition` = `after | before` - `Size` = `l | m | s | xs` ### GigaButton | Prop | Type | Default | Required | Description | |------|------|---------|----------|-------------| | `appearance` | `neutral \| primary` | `primary` | no | Оформление подписи: primary использует primary/text, neutral — neutral/text. Обводка есть у Outline и Mama. | | `className` | `string` | — | no | Дополнительный CSS-класс корневой кнопки. | | `data-test-id` | `string` | — | no | | | `disabled` | `boolean` | `false` | no | Нативно отключает кнопку, когда loading=false; глобус сохраняет цвет. | | `icon` | `ReactNode` | — | no | | | `iconPosition` | `after \| before` | `before` | no | | | `innerRef` | `Ref` | — | no | Ссылка на корневой HTMLButtonElement. | | `label` | `string` | — | no | | | `loading` | `boolean` | `false` | no | Показывает индикатор и блокирует действие, сохраняя фокус и ширину кнопки. Имеет приоритет над disabled. | | `rootTestId` | `string` | — | yes | | | `size` | `l \| m \| s \| xs` | — | yes | | | `view` | `function \| mama \| outline` | — | yes | | ## Примеры ### FunctionExample ```tsx import { AiButtonGigaFunction } from '@cloud-ru/ds-ai-button-giga'; import { useState } from 'react'; export function FunctionExample() { const [count, setCount] = useState(0); const [loading, setLoading] = useState(false); function handleClick() { setCount(previous => previous + 1); setLoading(true); } function handleComplete() { setLoading(false); } return (

Количество запусков: {count}.

); } ``` ### MamaExample ```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 (

Количество запусков: {count}.

); } ``` ### OutlineExample ```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 (

Количество запусков: {count}.

); } ```