# @cloud-ru/ds-ai-button-controls > Кнопка-стрелка для прокрутки и листания в AI-компонентах. Docs: /snack-v2/components/ai-button-controls/ ## Установка ```sh pnpm add @cloud-ru/ds-ai-button-controls ``` ## Когда использовать - Кнопка прокрутки ленты сообщений к последнему ответу — направление `down`. - Листание ряда вложений в поле ввода на desktop — направления `left` и `right`. ### Когда не нужен - Закрытие блока или удаление вложения: - используйте `@cloud-ru/ds-ai-button-close`. - Раскрытие и сворачивание блока: - используйте `@cloud-ru/ds-ai-button-chevron`. ## API ### AiButtonControls | Prop | Type | Default | Required | Description | |------|------|---------|----------|-------------| | `className` | `string` | — | no | Доп. класс корня. | | `data-test-id` | `string` | `ai-button-controls` | no | | | `direction` | `down \| left \| right` | — | yes | Направление стрелки (ось Way в Figma). | | `disabled` | `boolean` | `false` | no | Блокирует нажатие. | | `onClick` | `((event: MouseEvent) => void)` | — | no | Нажатие на стрелку. Содержимое двигает потребитель. | #### Related types - `Direction` = `down | left | right` ## Примеры ### Carousel ```tsx import { AiButtonControls, DIRECTION } from '@cloud-ru/ds-ai-button-controls'; import { useState } from 'react'; const SLIDES = ['Первый', 'Второй', 'Третий', 'Четвёртый']; export function Carousel() { const [index, setIndex] = useState(0); const isFirst = index === 0; const isLast = index === SLIDES.length - 1; return (
setIndex(prev => prev - 1)} /> {SLIDES[index]} setIndex(prev => prev + 1)} />
); } ``` ### CustomLabel ```tsx import { AiButtonControls, DIRECTION } from '@cloud-ru/ds-ai-button-controls'; import { useState } from 'react'; export function CustomLabel() { const [clicks, setClicks] = useState(0); return (
setClicks(prev => prev + 1)} /> Нажатий: {clicks}
); } ``` ### Directions ```tsx import { AiButtonControls, DIRECTION } from '@cloud-ru/ds-ai-button-controls'; export function Directions() { return (
); } ```