AiAttachment

AiAttachment — плитка одного вложения фиксированного размера 88×88. Показывает картинку с превью или файл с именем и сообщает о трёх событиях отдельно: нажатие крестика (onRemove), повтора загрузки (onRetry) и самой плитки (onClick). Лимиты количества и размера файлов плитка не хранит: превышение потребитель показывает состоянием error.

Когда использовать

  • Ряд вложений в поле ввода сообщения (@cloud-ru/ds-ai-field-input).
  • Вложения в сообщениях ленты и других местах, где нужен единый вид файла.

Когда не нужен

  • Карточка файла с названием, описанием и скачиванием:
    • используйте @cloud-ru/ds-attachment.

Анатомия

Плитка состоит из контейнера, крестика в правом верхнем углу и, по состоянию, индикатора загрузки или кнопки повтора в центре.

Type (default image)

  • image — превью картинки заливкой контейнера, без имени.
  • file — иконка типа (icon, по умолчанию файл) и имя, обрезанное посередине.

State (default default)

  • default — непрозрачный контейнер.
  • loading — полупрозрачный контейнер и индикатор загрузки.
  • error — красная обводка и кнопка повтора; у файла имя окрашено красным.

Раскладка

Плитка закреплена на платформе webDesktop на обеих раскладках: размер 88×88 не меняется.

  • Desktop — крестик xs появляется сразу при наведении или фокусе, подсказка (tooltip) — через 300 мс после наведения.
  • Mobile — крестик s виден всегда, подсказки нет.

Установка

pnpm add @cloud-ru/ds-ai-attachment
import { AiAttachment } from '@cloud-ru/ds-ai-attachment'

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

Состояния

СостоянияDefault, Loading и Error
quarterly-report-final.pdfquarterly-report-final.pdf
budget.xlsxbudget.xlsx
notes.txtnotes.txt
tsx
import { AiAttachment, ATTACHMENT_STATE, ATTACHMENT_TYPE } from '@cloud-ru/ds-ai-attachment';

export function States() {
  return (
    <div style={{ display: 'flex', gap: 12, flexWrap: 'wrap', alignItems: 'center' }}>
      <AiAttachment type={ATTACHMENT_TYPE.File} fileName='quarterly-report-final.pdf' tooltip='PDF, 2 МБ' />
      <AiAttachment type={ATTACHMENT_TYPE.File} state={ATTACHMENT_STATE.Loading} fileName='budget.xlsx' />
      <AiAttachment
        type={ATTACHMENT_TYPE.File}
        state={ATTACHMENT_STATE.Error}
        fileName='notes.txt'
        tooltip='Файл больше 20 МБ'
      />
    </div>
  );
}

Удаление и повтор

Удаление и повторКрестик удаляет плитку, повтор снимает ошибку
report.pdfreport.pdf
budget.xlsxbudget.xlsx
notes.txtnotes.txt
tsx
import { AiAttachment, ATTACHMENT_STATE, ATTACHMENT_TYPE } from '@cloud-ru/ds-ai-attachment';
import { useState } from 'react';

export function RemoveAndRetry() {
  const [files, setFiles] = useState(['report.pdf', 'budget.xlsx', 'notes.txt']);
  const [failed, setFailed] = useState('budget.xlsx');

  return (
    <div style={{ display: 'flex', gap: 12, flexWrap: 'wrap', alignItems: 'center' }}>
      {files.map(file => (
        <AiAttachment
          key={file}
          type={ATTACHMENT_TYPE.File}
          state={file === failed ? ATTACHMENT_STATE.Error : ATTACHMENT_STATE.Default}
          fileName={file}
          tooltip={file === failed ? 'Не удалось загрузить' : file}
          onRemove={() => setFiles(prev => prev.filter(name => name !== file))}
          onRetry={() => setFailed('')}
        />
      ))}
    </div>
  );
}

Нажатие на плитку

Нажатие на плиткуПлитка с onClick доступна с клавиатуры
contract.docxcontract.docx
Открыто: 0
tsx
import { AiAttachment, ATTACHMENT_TYPE } from '@cloud-ru/ds-ai-attachment';
import { useState } from 'react';

export function Clickable() {
  const [opened, setOpened] = useState(0);

  return (
    <div style={{ display: 'flex', gap: 12, flexWrap: 'wrap', alignItems: 'center' }}>
      <AiAttachment type={ATTACHMENT_TYPE.File} fileName='contract.docx' onClick={() => setOpened(prev => prev + 1)} />
      <span>Открыто: {opened}</span>
    </div>
  );
}

Props

Types

PropsAiAttachmentProps
PropTypeDefaultRequiredDescription
classNamestring—noДоп. класс корня.
data-test-idstringai-attachmentno
fileNamestring—noИмя файла — для `type='file'`.
iconReactNode—noИконка типа файла. Подставляется снаружи (AT-7.3).
onClick(() => void)—noНажатие на плитку.
onRemove(() => void)—noНажатие на крестик.
onRetry(() => void)—noНажатие на кнопку повтора в состоянии `error`.
srcstring—noАдрес превью картинки.
state"default" | "error" | "loading"defaultnoСостояние плитки. По умолчанию `default`.
tooltipReactNode—noПодсказка при наведении (только desktop).
type"file" | "image"imagenoТип плитки: картинка с превью или файл с именем. По умолчанию `image`.

Unions

Types

AiAttachmentProps

Unions

Storybook

Figma