logoAnt Design

⌘ K
  • 设计
  • 研发
  • 组件
  • 博客
  • 资源
  • 国内镜像
YouMindTRACTIANLobeHubCodeRabbit
6.5.0
  • 组件总览
  • 更新日志
    v6.5.0
  • 通用
    • Button按钮
    • FloatButton悬浮按钮
    • Icon图标
    • Typography排版
  • 布局
    • Divider分割线
    • Flex弹性布局
    • Grid栅格
    • Layout布局
    • Masonry瀑布流
      6.0.0
    • Space间距
    • Splitter分隔面板
  • 导航
    • Anchor锚点
    • Breadcrumb面包屑
    • Dropdown下拉菜单
    • Menu导航菜单
    • Pagination分页
    • Steps步骤条
    • Tabs标签页
  • 数据录入
    • AutoComplete自动完成
    • Cascader级联选择
    • Checkbox多选框
    • ColorPicker颜色选择器
    • DatePicker日期选择框
    • Form表单
    • Input输入框
    • InputNumber数字输入框
    • Mentions提及
    • Radio单选框
    • Rate评分
    • Select选择器
    • Slider滑动输入条
    • Switch开关
    • TimePicker时间选择框
    • Transfer穿梭框
    • TreeSelect树选择
    • Upload上传
  • 数据展示
    • Avatar头像
    • Badge徽标数
    • Calendar日历
    • Card卡片
    • Carousel走马灯
    • Collapse折叠面板
    • Descriptions描述列表
    • Empty空状态
    • Image图片
    • List列表
      废弃
    • Popover气泡卡片
    • QRCode二维码
    • Segmented分段控制器
    • Statistic统计数值
    • Table表格
    • Tag标签
    • Timeline时间轴
    • Tooltip文字提示
    • Tour漫游式引导
    • Tree树形控件
  • 反馈
    • Alert警告提示
    • Drawer抽屉
    • Message全局提示
    • Modal对话框
    • Notification通知提醒框
    • Popconfirm气泡确认框
    • Progress进度条
    • Result结果
    • Skeleton骨架屏
    • Spin加载中
    • Watermark水印
  • 其他
    • Affix固钉
    • App包裹组件
    • BorderBeam边框流光
      6.4.0
    • ConfigProvider全局化配置
    • Util工具类
何时使用
代码演示
基本
标题组件
文本与超链接组件
可编辑
可复制
省略号
受控省略展开/收起
省略中间
后缀
表格
API
Typography.Text
Typography.Title
Typography.Paragraph
actions
copyable
editable
ellipsis
Semantic DOM
主题变量（Design Token）

Typography
排版

文本的基本格式。
使用import { Typography } from 'antd';
反馈
components/typography提交问题待解决
文档
编辑此页LLMs.md
Icon图标Divider分割线

相关资源

Ant Design X
Ant Design Charts
Ant Design Pro
Pro Components
Ant Design Mobile
Ant Design Mini
Ant Design Web3
Ant Design Landing-首页模板集
Scaffolds-脚手架市场
Umi-React 应用开发框架
dumi-组件/文档研发工具
qiankun-微前端框架
Ant Motion-设计动效
国内镜像站点 🇨🇳

社区

Awesome Ant Design
Medium
X
yuque logoAnt Design 语雀专栏
Ant Design 知乎专栏
体验科技专栏
seeconf logoSEE Conf-蚂蚁体验科技大会
加入我们

帮助

GitHub
更新日志
常见问题
For Agents
报告 Bug
议题
讨论区
StackOverflow
SegmentFault

Ant XTech logo更多产品

yuque logo语雀-构建你的数字花园
AntV logoAntV-数据可视化解决方案
Egg logoEgg-企业级 Node.js 框架
Kitchen logoKitchen-Sketch 工具集
Galacean logoGalacean-互动图形解决方案
WeaveFox logoWeaveFox-前端智能研发
xtech logo蚂蚁体验科技
主题编辑器
Made with ❤ by
蚂蚁集团和 Ant Design 开源社区
loading

何时使用

  • 当需要展示标题、段落、列表内容时使用，如文章/博客/日志的文本样式。
  • 当需要一列基于文本的基础操作时，如拷贝/省略/可编辑。

代码演示

API

通用属性参考：通用属性

Typography.Text

参数说明类型默认值版本全局配置
actions配置操作栏actions-6.4.0×
classNames用于自定义组件内部各语义化结构的 class，支持对象或函数Record<SemanticDOM, string> | (info: { props })=> Record<SemanticDOM, string>-6.4.06.4.0
code添加代码样式booleanfalse×
copyable是否可拷贝，为对象时可进行各种自定义boolean | copyablefalse×
delete添加删除线样式booleanfalse×
disabled禁用文本booleanfalse×
editable是否可编辑，为对象时可对编辑进行控制boolean | editablefalse×
ellipsis自动溢出省略，为对象时不能设置省略行数、是否可展开、onExpand 展开事件。不同于 Typography.Paragraph，Text 组件自身不带 100% 宽度样式，因而默认情况下初次缩略后宽度便不再变化。如果需要自适应宽度，请手动配置宽度样式boolean | Omit<ellipsis, 'expandable' | 'rows' | 'onExpand'>false×
italic是否斜体booleanfalse4.16.0×
keyboard添加键盘样式booleanfalse4.3.0×
mark添加标记样式booleanfalse×
strong是否加粗booleanfalse×
styles用于自定义组件内部各语义化结构的行内 style，支持对象或函数Record<SemanticDOM, CSSProperties> | (info: { props })=> Record<SemanticDOM, CSSProperties>-6.4.06.4.0
type文本类型secondary | success | warning | danger-success: 4.6.0×
underline添加下划线样式booleanfalse×
onClick点击 Text 时的回调(event) => void-×

Typography.Title

参数说明类型默认值版本全局配置
actions配置操作栏actions-6.4.0×
classNames用于自定义组件内部各语义化结构的 class，支持对象或函数Record<SemanticDOM, string> | (info: { props })=> Record<SemanticDOM, string>-6.4.06.4.0
code添加代码样式booleanfalse×
copyable是否可拷贝，为对象时可进行各种自定义boolean | copyablefalse×
delete添加删除线样式booleanfalse×
disabled禁用文本booleanfalse×
editable是否可编辑，为对象时可对编辑进行控制boolean | editablefalse×
ellipsis自动溢出省略，为对象时可设置省略行数、是否可展开、添加后缀等boolean | ellipsisfalse×
italic是否斜体booleanfalse4.16.0×
level重要程度，相当于 h1、h2、h3、h4、h5number: 1, 2, 3, 4, 515: 4.6.0×
mark添加标记样式booleanfalse×
styles用于自定义组件内部各语义化结构的行内 style，支持对象或函数Record<SemanticDOM, CSSProperties> | (info: { props })=> Record<SemanticDOM, CSSProperties>-6.4.06.4.0
type文本类型secondary | success | warning | danger-success: 4.6.0×
underline添加下划线样式booleanfalse×
onClick点击 Title 时的回调(event) => void-×

Typography.Paragraph

参数说明类型默认值版本全局配置
actions配置操作栏actions-6.4.0×
classNames用于自定义组件内部各语义化结构的 class，支持对象或函数Record<SemanticDOM, string> | (info: { props })=> Record<SemanticDOM, string>-6.4.06.4.0
code添加代码样式booleanfalse×
copyable是否可拷贝，为对象时可进行各种自定义boolean | copyablefalse×
delete添加删除线样式booleanfalse×
disabled禁用文本booleanfalse×
editable是否可编辑，为对象时可对编辑进行控制boolean | editablefalse×
ellipsis自动溢出省略，为对象时可设置省略行数、是否可展开、添加后缀等boolean | ellipsisfalse×
italic是否斜体booleanfalse4.16.0×
mark添加标记样式booleanfalse×
strong是否加粗booleanfalse×
styles用于自定义组件内部各语义化结构的行内 style，支持对象或函数Record<SemanticDOM, CSSProperties> | (info: { props })=> Record<SemanticDOM, CSSProperties>-6.4.06.4.0
type文本类型secondary | success | warning | danger-success: 4.6.0×
underline添加下划线样式booleanfalse×
onClick点击 Paragraph 时的回调(event) => void-×

actions

{
  placement: 'start' | 'end',
}
参数说明类型默认值版本
placement设置操作栏相对于文本的位置start | endend6.4.0

copyable

{
  text: string | (() => string | Promise<string>),
  onCopy: function(event),
  icon: ReactNode,
  tooltips: false | [ReactNode, ReactNode],
  format: 'text/plain' | 'text/html',
  tabIndex: number,
}
参数说明类型默认值版本
format剪切板数据的 Mime Type'text/plain' | 'text/html'-4.21.0
icon自定义拷贝图标：[默认图标, 拷贝后的图标][ReactNode, ReactNode]-4.6.0
tabIndex自定义复制按钮的 tabIndexnumber05.17.0
text拷贝到剪切板里的文本string-
tooltips自定义提示文案，为 false 时隐藏文案[ReactNode, ReactNode][复制, 复制成功]4.4.0
onCopy拷贝成功的回调函数function-

editable

{
  icon: ReactNode,
  tooltip: ReactNode,
  editing: boolean,
  maxLength: number,
  autoSize: boolean | { minRows: number, maxRows: number },
  text: string,
  onChange: function(string),
  onCancel: function,
  onStart: function,
  onEnd: function,
  triggerType: ('icon' | 'text')[],
  enterIcon: ReactNode,
  tabIndex: number,
}
参数说明类型默认值版本
autoSize自动 resize 文本域boolean | { minRows: number, maxRows: number }-4.4.0
editing控制是否是编辑中状态booleanfalse
enterIcon在编辑段中自定义"enter"图标（传递"null"将删除图标）ReactNode<EnterOutlined />4.17.0
icon自定义编辑图标ReactNode<EditOutlined />4.6.0
maxLength编辑中文本域最大长度number-4.4.0
tabIndex自定义编辑按钮的 tabIndexnumber05.17.0
text显式地指定编辑文案，为空时将隐式地使用 childrenstring-4.24.0
tooltip自定义提示文本，为 false 时关闭ReactNode编辑4.6.0
triggerType编辑模式触发器类型，图标、文本或者两者都设置（不设置图标作为触发器时它会隐藏）Array<icon|text>[icon]
onCancel按 ESC 退出编辑状态时触发function-
onChange文本域编辑时触发function(value: string)-
onEnd按 ENTER 结束编辑状态时触发function-4.14.0
onStart进入编辑中状态时触发function-

ellipsis

tsx
interface EllipsisConfig {
  rows: number;
  /** `5.16.0` 新增 `collapsible` */
  expandable: boolean | 'collapsible';
  suffix: string;
  /** `5.16.0` 新增渲染函数 */
  symbol: ReactNode | ((expanded: boolean) => ReactNode);
  tooltip: ReactNode | TooltipProps;
  /** `5.16.0` 新增 */
  defaultExpanded: boolean;
  /** `5.16.0` 新增 */
  expanded: boolean;
  /** `5.16.0` 新增 `info` */
  onExpand: (event: MouseEvent, info: { expanded: boolean }) => void;
  onEllipsis: (ellipsis: boolean) => void;
}
参数说明类型默认值版本
defaultExpanded默认展开或收起boolean5.16.0
expandable是否可展开boolean | 'collapsible'-collapsible: 5.16.0
expanded展开或收起boolean5.16.0
rows最多显示的行数number-
suffix自定义省略内容后缀string-
symbol自定义展开描述文案ReactNode | ((expanded: boolean) => ReactNode)展开 收起
tooltip省略时，展示提示信息ReactNode | TooltipProps-4.11.0
onEllipsis触发省略时的回调function(ellipsis)-4.2.0
onExpand点击展开或收起时的回调function(event, { expanded: boolean })-info: 5.16.0

Semantic DOM

Ant Design is a design language for background applications, refined by Ant UED Team. It aims to uniform the user interface specs for internal background projects, lower the unnecessary cost of design differences and implementation and liberate the resources of design and front-end development.
  • root
    6.4.0
    根元素，包含排版基础样式、布局和定位
  • actions
    6.4.0
    操作区域元素，包含复制、编辑、展开/收起等操作按钮的布局和间距样式
  • action
    6.4.0
    单个操作按钮元素，包括复制、编辑、展开、收起按钮的样式，如内边距、圆角、颜色等
  • textarea
    6.4.0
    可编辑模式下的 TextArea 元素样式，用于自定义编辑输入框的类名和内联样式

主题变量（Design Token）

组件 Token如何定制？
Token 名称描述类型默认值
titleMarginBottom标题下间距string | number0.5em
titleMarginTop标题上间距string | number1.2em
全局 Token如何定制？
Token 名称描述类型默认值
colorErrorText错误色的文本默认态string#ff4d4f
colorErrorTextActive错误色的文本激活态string#d9363e
colorErrorTextHover错误色的文本悬浮态string#ff7875
colorFillAlter控制元素替代背景色。stringrgba(0,0,0,0.02)
colorIcon控制弱操作图标的颜色，例如 allowClear 或 Alert 关闭按钮。 *stringrgba(0,0,0,0.45)
colorLink控制超链接的颜色。string#1677ff
colorLinkActive控制超链接被点击时的颜色。string#0958d9
colorLinkHover控制超链接悬浮时的颜色。string#69b1ff
colorPrimaryBorder主色梯度下的描边用色，用在 Slider 等组件的描边上。string#91caff
colorSplit用于作为分割线的颜色，此颜色和 colorBorderSecondary 的颜色一致，但是用的是透明色。stringrgba(5,5,5,0.06)
colorSuccess用于表示操作成功的 Token 序列，如 Result、Progress 等组件会使用该组梯度变量。string#52c41a
colorSuccessText成功色的文本默认态string#52c41a
colorText最深的文本色。为了符合W3C标准，默认的文本颜色使用了该色，同时这个颜色也是最深的中性色。stringrgba(0,0,0,0.88)
colorTextDescription控制文本描述字体颜色。stringrgba(0,0,0,0.45)
colorTextDisabled控制禁用状态下的字体颜色。stringrgba(0,0,0,0.25)
colorTextHeading控制标题字体颜色。stringrgba(0,0,0,0.88)
colorWarningText警戒色的文本默认态string#faad14
borderRadiusLGLG号圆角，用于组件中的一些大圆角，如 Card、Modal 等一些组件样式。number8
fontFamilyCode代码字体，用于 Typography 内的 code、pre 和 kbd 类型的元素string'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, Courier, monospace
fontSize设计系统中使用最广泛的字体大小，文本梯度也将基于该字号进行派生。number14
fontSizeHeading1H1 标签所使用的字号string | number38
fontSizeHeading2h2 标签所使用的字号string | number30
fontSizeHeading3h3 标签使用的字号string | number24
fontSizeHeading4h4 标签使用的字号string | number20
fontSizeHeading5h5 标签使用的字号string | number16
fontWeightStrong控制标题类组件（如 h1、h2、h3）或选中项的字体粗细。number600
lineHeight文本行高number1.5714285714285714
lineHeightHeading1H1 标签所使用的行高number1.2105263157894737
lineHeightHeading2h2 标签所使用的行高number1.2666666666666666
lineHeightHeading3h3 标签所使用的行高number1.3333333333333333
lineHeightHeading4h4 标签所使用的行高number1.4
lineHeightHeading5h5 标签所使用的行高number1.5
lineType用于控制组件边框、分割线等的样式，默认是实线stringsolid
lineWidth用于控制组件边框、分割线等的宽度number1
lineWidthFocus控制线条的宽度，当组件处于聚焦态时。number3
linkDecoration控制链接文本的装饰样式。TextDecoration<string | number> | undefinednone
linkFocusDecoration控制链接聚焦时文本的装饰样式。TextDecoration<string | number> | undefinednone
linkHoverDecoration控制链接鼠标悬浮时文本的装饰样式。TextDecoration<string | number> | undefinednone
marginXS控制元素外边距，小尺寸。number8
marginXXS控制元素外边距，最小尺寸。number4
motionDurationMid动效播放速度，中速。用于中型元素动画交互string0.2s
motionDurationSlow动效播放速度，慢速。用于大型元素如面板动画交互string0.3s
padding控制元素的内间距。number16
paddingSM控制元素的小内间距。number12

Introduction

In the process of internal desktop applications development, many different design specs and implementations would be involved, which might cause designers and developers difficulties and duplication and reduce the efficiency of development.
After massive project practice and summaries, Ant Design, a design language for background applications, is refined by Ant UED Team, which aims to uniform the user interface specs for internal background projects, lower the unnecessary cost of design differences and implementation and liberate the resources of design and front-end development.

Guidelines and Resources

We supply a series of design principles, practical patterns and high quality design resources (Sketch and Axure), to help people create their product prototypes beautifully and efficiently.
  • Principles
  • Patterns
  • Resource Download
Press Esc to exit...

介绍

蚂蚁的企业级产品是一个庞大且复杂的体系。这类产品不仅量级巨大且功能复杂，而且变动和并发频繁，常常需要设计与开发能够快速的做出响应。同时这类产品中有存在很多类似的页面以及组件，可以通过抽象得到一些稳定且高复用性的内容。
随着商业化的趋势，越来越多的企业级产品对更好的用户体验有了进一步的要求。带着这样的一个终极目标，我们（蚂蚁集团体验技术部）经过大量的项目实践和总结，逐步打磨出一个服务于企业级产品的设计体系 Ant Design。基于『确定』和『自然』的设计价值观，通过模块化的解决方案，降低冗余的生产成本，让设计者专注于更好的用户体验。

设计资源

我们提供完善的设计原则、最佳实践和设计资源文件（Sketch 和Axure），来帮助业务快速设计出高质量的产品原型。
  • 设计原则
  • 设计模式
  • 设计资源
AntV 是蚂蚁集团全新一代数据可视化解决方案，致力于提供一套简单方便、专业可靠、不限可能的数据可视化最佳实践。得益于丰富的业务场景和用户需求挑战，AntV 经历多年积累与不断打磨，已支撑整个阿里集团内外 20000+ 业务系统，通过了日均千万级 UV 产品的严苛考验。 我们正在基础图表，图分析，图编辑，地理空间可视化，智能可视化等各个可视化的领域耕耘，欢迎同路人一起前行。
AntV 是蚂蚁集团全新一代数据可视化解决方案，致力于提供一套简单方便、专业可靠、不限可能的数据可视化最佳实践。得益于丰富的业务场景和用户需求挑战，AntV 经历多年积累与不断打磨，已支撑整个阿里集团内外 20000+ 业务系统，通过了日均千万级 UV 产品的严苛考验。
我们正在基础图表，图分析，图编辑，地理空间可视化，智能可视化等各个可视化的领域耕耘，欢迎同路人一起前行。
按Esc键退出阅读……
基本

展示文档样例。

h1. Ant Design

h2. Ant Design

h3. Ant Design

h4. Ant Design

h5. Ant Design
标题组件

展示不同级别的标题。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
Ant Design (default)
Ant Design (secondary)
Ant Design (success)
Ant Design (warning)
Ant Design (danger)
Ant Design (disabled)
Ant Design (mark)
Ant Design (code)
Ant Design (keyboard)
Ant Design (underline)
Ant Design (delete)
Ant Design (strong)
Ant Design (italic)
Ant Design (Link)
文本与超链接组件

内置不同样式的文本以及超链接组件。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
This is an editable text.
This is a loooooooooooooooooooooooooooooooong editable text with suffix.
Custom Edit icon and replace tooltip text.
Trigger edit with:
Text or icon as trigger - click to start editing.
Editable text with a custom enter icon in edit field.
Editable text with no enter icon in edit field.
Hide Edit tooltip.
This is an editable text with limited length.

h1. Ant Design

h2. Ant Design

h3. Ant Design

h4. Ant Design

h5. Ant Design
可编辑

提供可编辑的交互能力。

This is a copyable text.
Replace copy text.
Custom Copy icon and replace tooltips text.
Hide Copy tooltips.
Request copy text.
Copy action at the start.
可复制

提供可复制的交互能力及相关配置。

Ant Design, a design language for background applications, is refined by Ant UED Team. Ant Design, a design language for background applications, is refined by Ant UED Team. Ant Design, a design language for background applications, is refined by Ant UED Team. Ant Design, a design language for background applications, is refined by Ant UED Team. Ant Design, a design language for background applications, is refined by Ant UED Team. Ant Design, a design language for background applications, is refined by Ant UED Team.
Ant Design, a design language for background applications, is refined by Ant UED Team. Ant Design, a design language for background applications, is refined by Ant UED Team. Ant Design, a design language for background applications, is refined by Ant UED Team. Ant Design, a design language for background applications, is refined by Ant UED Team. Ant Design, a design language for background applications, is refined by Ant UED Team. Ant Design, a design language for background applications, is refined by Ant UED Team.
Ant Design, a design language for background applications, is refined by Ant UED Team.Ant Design, a design language for background applications, is refined by Ant UED Team.
省略号

多行文本省略。你可以通过 tooltip 属性配置省略展示内容，大量文本时推荐优先使用 expandable。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
Ant Design, a design language for background applications, is refined by Ant UED Team.Ant Design, a design language for background applications, is refined by Ant UED Team.Ant Design, a design language for background applications, is refined by Ant UED Team.Ant Design, a design language for background applications, is refined by Ant UED Team.Ant Design, a design language for background applications, is refined by Ant UED Team.Ant Design, a design language for background applications, is refined by Ant UED Team.Ant Design, a design language for background applications, is refined by Ant UED Team.Ant Design, a design language for background applications, is refined by Ant UED Team.Ant Design, a design language for background applications, is refined by Ant UED Team.Ant Design, a design language for background applications, is refined by Ant UED Team.Ant Design, a design language for background applications, is refined by Ant UED Team.Ant Design, a design language for background applications, is refined by Ant UED Team.Ant Design, a design language for background applications, is refined by Ant UED Team.Ant Design, a design language for background applications, is refined by Ant UED Team.Ant Design, a design language for background applications, is refined by Ant UED Team.Ant Design, a design language for background applications, is refined by Ant UED Team.Ant Design, a design language for background applications, is refined by Ant UED Team.Ant Design, a design language for background applications, is refined by Ant UED Team.Ant Design, a design language for background applications, is refined by Ant UED Team.Ant Design, a design language for background applications, is refined by Ant UED Team.
受控省略展开/收起

受控多行文本省略。

CodeSandbox Icon
codepen icon
External Link Icon
Expand Icon
5.16.0
In the process of internal desktop applications development, many different design specs and implementations would be involved, which might cause designers and developers difficulties and duplication and reduce the efficiency of development.
省略中间

使用 ellipsis={{ suffix: ... }} 可以封装一个从中间省略内容的组件，适合于需要保留文本末位特征的内容。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
To be, or not to be, that is the question: Whether it is nobler in the mind to suffer. The slings and arrows of outrageous fortune Or to take arms against a sea of troubles, And by opposing end them? To die: to sleep; No more; and by a sleep to say we end The heart-ache and the thousand natural shocks That flesh is heir to, 'tis a consummation Devoutly to be wish'd. To die, to sleep To sleep- perchance to dream: ay, there's the rub! For in that sleep of death what dreams may come When we have shuffled off this mortal coil, Must give us pause. There 's the respect That makes calamity of so long life--William Shakespeare
后缀

添加后缀的省略。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon

Typography with Table

PlanPriceFeatures
BasicFree1GB Storage, Basic Support
Pro$9.99/month100GB Storage, Priority Support
EnterpriseContact usUnlimited Storage, 24/7 Support
表格

为 Typography 内的原生 <table> 元素提供默认样式，适用于在文档中展示表格内容（如价格表、对比表等），无需使用完整的 Table 组件。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
Hitu Icon