logoAnt Design X

设计研发组件X MarkdownX SDK演示
  • 介绍
  • 总览
  • 通用
    • Bubble对话气泡
    • Conversations管理对话
    • Notification系统通知
  • 唤醒
    • Welcome欢迎
    • Prompts提示集
  • 表达
    • Attachments输入附件
    • Sender输入框
    • Suggestion快捷指令
  • 确认
    • Sources来源引用
    • Think思考过程
    • ThoughtChain思维链
  • 反馈
    • Actions操作列表
    • FileCard文件卡片
  • 其他
    • XProvider全局化配置

Attachments
输入附件

用于展示一组附件信息集合。
使用import { Attachments } from "@ant-design/x";
源码components/attachments
文档
编辑此页...
更新日志
loading

何时使用

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

代码演示

基本

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

CodeSandbox Icon
codepen icon
External Link Icon
expand codeexpand code
Click or Drop files here
Support file type: image, video, audio, document, etc.
Custom Placeholder Node
占位信息

修改占位信息。

CodeSandbox Icon
codepen icon
External Link Icon
expand codeexpand code
Click or Drop files here
Support file type: image, video, audio, document, etc.
超出样式

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

CodeSandbox Icon
codepen icon
External Link Icon
expand codeexpand code
Attachments
Upload files
Click or drag files to this area to upload
组合示例

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

CodeSandbox Icon
codepen icon
External Link Icon
expand codeexpand code
Attachments
Upload files
Click or drag files to this area to upload
分类型选择文件

调用 ref.select 方法可以打开选择文件对话框,来区分类型进行上传,同时设置 multiple 为 true 可以支持多选,设置 maxCount 可以限制最多选择的文件数量。

CodeSandbox Icon
codepen icon
External Link Icon
expand codeexpand code

API

通用属性参考:通用属性。

AttachmentsProps

继承 antd Upload 属性。

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

AttachmentsRef

属性说明类型版本
nativeElement获取原生节点HTMLElement-
fileNativeElement获取文件上传原生节点HTMLElement-
upload手工调用上传文件(file: File) => void-
select手工调用选择文件(options: { accept?: string; multiple?: boolean; }) => void-

Semantic DOM

主题变量(Design Token)

组件 Token如何定制?
Token 名称描述类型默认值
colorBgPlaceholderHoverstringrgba(255,255,255,0.85)
全局 Token如何定制?
Upload File
Drag or click to upload file.
  • root
    根节点
  • placeholder
    占位符
  • root
    根节点
  • list
    列表容器
  • card
    文件卡片
  • file
    文件
  • icon
    文件图标
  • name
    文件名称
  • description
    文件描述
  • upload
    上传按钮