Skip to content

Attachments 输入附件

用于展示一组附件信息集合。

何时使用

Attachments 组件用于需要展示一组附件信息集合的场景。

代码演示

基本

基础用法,可以通过 getDropContainer 支持拖拽上传。

占位信息

修改占位信息。

Click or Drop files here
Support file type: image, video, audio, document, etc.
Custom Placeholder Node

超出样式

控制附件超出区域长度时的展示方式。

preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview
preview
Preview

组合示例

配合 Sender.Header 使用,在对话中插入附件。

Attachments
Upload files
Click or drag files to this area to upload

文件卡片

单独的文件卡片,用于一些展示场景。

excel-file
.xlsx
109 KB
word-file
.docx
217 KB
image-file
.png
326 KB
pdf-file
.pdf
434 KB
ppt-file
.pptx
543 KB
video
video-file
.mp4
651 KB
audio
audio-file
.mp3
760 KB
zip-file
.zip
868 KB
markdown-file
.md
Custom description here
preview

自定义文件卡片

自定义文件卡片的图标、图标颜色、文件范围。

excel-file
.xlsx
109 KB
image-file
.png
326 KB
pdf-file
.pdf
434 KB
video-file
.mp4
651 KB
audio-file
.mp3
760 KB

API

Attachments Props

继承 antdv Upload 属性。

属性说明类型默认值版本
classNames自定义样式类名,见下Record<string, string>--
disabled是否禁用booleanfalse-
getDropContainer设置拖拽时,可以释放文件的区域() => HTMLElement--
items附件列表,同 Upload fileListAttachment[]--
overflow文件列表超出时样式'wrap' | 'scrollX' | 'scrollY'--
placeholder没有文件时的占位信息PlaceholderType | ((type: 'inline' | 'drop') => PlaceholderType)--
rootClassName根节点的样式类名string--
rootStyle根节点的样式对象CSSProperties--
styles自定义样式对象,见下Record<string, CSSProperties>--
imageProps图片属性,同 antdv Image 属性ImageProps--
tsx
interface PlaceholderType {
  icon?: VNode;
  title?: VNode | string;
  description?: VNode | string;
}

Attachments Slots

插槽名说明类型
placeholder没有文件时的占位信息{ type: "inline" | "drop" }

Attachments Expose

属性说明类型版本
nativeElement获取原生节点HTMLElement-
upload手工调用上传文件(file: File | File[] | FileList) => void-

Attachments.FileCard Props

属性说明类型默认值版本
item附件,同 Upload UploadFileAttachment--
onRemove点击移除文件时的回调,返回值为 false 时不移除。支持返回一个 Promise 对象,Promise 对象 resolve(false) 或 reject 时不移除(item: Attachment) => boolean | Promise--
icon自定义图标VNode | PresetIcons--
type是否图片类型'file' | 'image'file-
ts
type PresetIcons = 'default' | 'excel' | 'image' | 'markdown' | 'pdf' | 'ppt' | 'word' | 'zip' | 'video' | 'audio';

Semantic DOM

Upload File
Drag or click to upload file.
  • placeholder
    占位符
preview
Preview
preview
Preview
preview
Preview
  • list
    列表容器
  • item
    列表项

主题变量(Design Token)

贡献者

贡献者

wzc520pyfm
linhf123
Kieran Wang
PeikyLiu
Bao
hihanley
Zoey Zhao