AiButtonControls
AiButtonControls — кнопка-стрелка 24×24 из набора AI Components. Сообщает о нажатии через onClick; что и на сколько прокрутить, решает потребитель.
Когда использовать
- Кнопка прокрутки ленты сообщений к последнему ответу — направление
down. - Листание ряда вложений в поле ввода на desktop — направления
leftиright.
Когда не нужен
- Закрытие блока или удаление вложения:
- используйте
@cloud-ru/ds-ai-button-close.
- используйте
- Раскрытие и сворачивание блока:
- используйте
@cloud-ru/ds-ai-button-chevron.
- используйте
Анатомия
Кнопка состоит из подложки с тенью и иконки стрелки. Обводки и текста нет.
Direction
left— стрелка влево.right— стрелка вправо.down— стрелка вниз.
На устройствах с наведением стрелка в покое окрашена вторичным цветом текста, при наведении — основным; подложка не меняется. На сенсорных экранах состояния наведения нет. Фокус с клавиатуры показывается акцентной обводкой.
Доступное имя по умолчанию берётся из локали по направлению: «Прокрутить влево», «Прокрутить вправо», «Прокрутить вниз». Если кнопка ведёт к конкретному месту, передайте свой aria-label.
Установка
pnpm add @cloud-ru/ds-ai-button-controls
import { AiButtonControls } from '@cloud-ru/ds-ai-button-controls'
Примеры использования
Направления
tsx
import { AiButtonControls, DIRECTION } from '@cloud-ru/ds-ai-button-controls';
export function Directions() {
return (
<div style={{ display: 'flex', gap: 12, flexWrap: 'wrap', alignItems: 'center' }}>
<AiButtonControls direction={DIRECTION.Left} />
<AiButtonControls direction={DIRECTION.Right} />
<AiButtonControls direction={DIRECTION.Down} />
</div>
);
}Листание
Первый
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 (
<div style={{ display: 'flex', gap: 12, flexWrap: 'wrap', alignItems: 'center' }}>
<AiButtonControls direction={DIRECTION.Left} disabled={isFirst} onClick={() => setIndex(prev => prev - 1)} />
<span>{SLIDES[index]}</span>
<AiButtonControls direction={DIRECTION.Right} disabled={isLast} onClick={() => setIndex(prev => prev + 1)} />
</div>
);
}Доступное имя
Нажатий: 0
tsx
import { AiButtonControls, DIRECTION } from '@cloud-ru/ds-ai-button-controls';
import { useState } from 'react';
export function CustomLabel() {
const [clicks, setClicks] = useState(0);
return (
<div style={{ display: 'flex', gap: 12, flexWrap: 'wrap', alignItems: 'center' }}>
<AiButtonControls
direction={DIRECTION.Down}
aria-label='К последнему сообщению'
onClick={() => setClicks(prev => prev + 1)}
/>
<span>Нажатий: {clicks}</span>
</div>
);
}Props
Types
Props
AiButtonControlsProps| 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<HTMLButtonElement, MouseEvent>) => void) | — | no | Нажатие на стрелку. Содержимое двигает потребитель. |