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'

Примеры использования

Направления

НаправленияLeft, Right и Down
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>
  );
}

Доступное имя

Доступное имяaria-label для кнопки прокрутки к последнему сообщению
Нажатий: 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

PropsAiButtonControlsProps
PropTypeDefaultRequiredDescription
classNamestring—noДоп. класс корня.
data-test-idstringai-button-controlsno
direction"down" | "left" | "right"—yesНаправление стрелки (ось Way в Figma).
disabledbooleanfalsenoБлокирует нажатие.
onClick((event: MouseEvent<HTMLButtonElement, MouseEvent>) => void)—noНажатие на стрелку. Содержимое двигает потребитель.

Unions

Types

AiButtonControlsProps

Unions

Storybook

Figma