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
Card.Grid
Card.Meta
Semantic DOM
Card
Card.Meta
主题变量(Design Token)

Card
卡片

通用卡片容器。
使用import { Card } from 'antd';
反馈
components/card提交问题待解决
文档
编辑此页LLMs.md
Calendar日历Carousel走马灯

相关资源

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

通用属性参考:通用属性

jsx
<Card title="卡片标题">卡片内容</Card>
参数说明类型默认值版本全局配置
actions卡片操作组,位置在卡片底部Array<ReactNode>-×
activeTabKey当前激活页签的 keystring-×
bordered是否有边框, 请使用 variant 替换booleantrue×
bodyStyle卡片内容区域样式,请使用 styles.body 替代CSSProperties--×
variant形态变体outlined | borderlessoutlined5.24.05.24.0
classNames用于自定义组件内部各语义化结构的 class,支持对象或函数Record<SemanticDOM, string> | (info: { props })=> Record<SemanticDOM, string>-5.14.0
cover卡片封面ReactNode-×
defaultActiveTabKey初始化选中页签的 key,如果没有设置 activeTabKeystring第一个页签的 key×
extra卡片右上角的操作区域ReactNode-×
hoverable鼠标移过时可浮起booleanfalse×
headStyle卡片头部样式,请使用 styles.header 替代CSSProperties--×
loading当卡片内容还在加载中时,可以用 loading 展示一个占位booleanfalse×
sizecard 的尺寸medium | smallmedium×
tabBarExtraContenttab bar 上额外的元素ReactNode-×
tabList页签标题列表TabItemType[]-×
tabPropsTabs--×
title卡片标题ReactNode-×
type卡片类型,可设置为 inner 或 不设置string-×
styles用于自定义组件内部各语义化结构的行内 style,支持对象或函数Record<SemanticDOM, CSSProperties> | (info: { props })=> Record<SemanticDOM, CSSProperties>-5.14.0
onTabChange页签切换的回调(key) => void-×

Card.Grid

参数说明类型默认值版本
hoverable鼠标移过时可浮起booleantrue

Card.Meta

参数说明类型默认值版本全局配置
avatar头像/图标ReactNode-×
description描述内容ReactNode-×
title标题内容ReactNode-×

Semantic DOM

Card

Card title
More
example
Card Meta title
This is the description
  • root
    6.0.0
    卡片根元素,包含位置定位、背景色、边框、圆角、阴影、内边距等卡片容器的基础样式
  • header
    5.14.0
    卡片头部区域,包含 flex 布局、最小高度、内边距、文字颜色、字体权重、字体大小、背景色、下边框、顶部圆角等样式
  • title
    5.14.0
    卡片标题,包含行内块布局、flex 占比、文本省略等标题显示样式
  • extra
    5.14.0
    卡片右上角的操作区域,包含额外内容的文字颜色和布局样式
  • cover
    5.14.0
    标题封面,包含封面图片的显示和布局样式
  • body
    5.14.0
    卡片内容区域,包含内边距、字体大小等内容展示的基础样式
  • actions
    5.14.0
    卡片底部操作组,包含 flex 布局、列表样式重置、背景色、上边框、底部圆角等操作按钮容器样式

Card.Meta

Card Meta title
This is the description
  • root
    6.0.0
    设置元信息根元素
  • section
    6.0.0
    设置元信息内容元素
  • avatar
    6.0.0
    设置元信息图标
  • title
    6.0.0
    设置元信息标题
  • description
    6.0.0
    设置元信息描述

主题变量(Design Token)

组件 Token如何定制?
Token 名称描述类型默认值
actionsBg操作区背景色string#ffffff
actionsLiMargin操作区每一项的外间距string12px 0
bodyPadding卡片内边距number24
bodyPaddingSM小号卡片内边距number12
extraColor额外区文字颜色stringrgba(0,0,0,0.88)
headerBg卡片头部背景色stringtransparent
headerFontSize卡片头部文字大小string | number16
headerFontSizeSM小号卡片头部文字大小string | number14
headerHeight卡片头部高度string | number56
headerHeightSM小号卡片头部高度string | number38
headerPadding卡片头部内边距number24
headerPaddingSM小号卡片头部内边距number12
tabsMarginBottom内置标签页组件下间距number-17
全局 Token如何定制?
Token 名称描述类型默认值
colorBgContainer组件的容器背景色,例如:默认按钮、输入框等。务必不要将其与 `colorBgElevated` 混淆。string#ffffff
colorBorderSecondary比默认使用的边框色要浅一级,此颜色和 colorSplit 的颜色一致。使用的是实色。string#f0f0f0
colorFillAlter控制元素替代背景色。stringrgba(0,0,0,0.02)
colorIcon控制弱操作图标的颜色,例如 allowClear 或 Alert 关闭按钮。 *stringrgba(0,0,0,0.45)
colorPrimary品牌色是体现产品特性和传播理念最直观的视觉元素之一。在你完成品牌主色的选取之后,我们会自动帮你生成一套完整的色板,并赋予它们有效的设计语义string#1677ff
colorText最深的文本色。为了符合W3C标准,默认的文本颜色使用了该色,同时这个颜色也是最深的中性色。stringrgba(0,0,0,0.88)
colorTextDescription控制文本描述字体颜色。stringrgba(0,0,0,0.45)
colorTextHeading控制标题字体颜色。stringrgba(0,0,0,0.88)
borderRadiusLGLG号圆角,用于组件中的一些大圆角,如 Card、Modal 等一些组件样式。number8
boxShadowTertiary控制元素三级盒子阴影样式。string 0 1px 2px 0 rgba(0,0,0,0.05), 0 1px 6px -1px rgba(0,0,0,0.03), 0 2px 4px 0 rgba(0,0,0,0.03)
fontFamilyAnt Design 的字体家族中优先使用系统默认的界面字体,同时提供了一套利于屏显的备用字体库,来维护在不同平台以及浏览器的显示下,字体始终保持良好的易读性和可读性,体现了友好、稳定和专业的特性。string-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, 'Noto Sans', sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji'
fontSize设计系统中使用最广泛的字体大小,文本梯度也将基于该字号进行派生。number14
fontSizeLG大号字体大小number16
fontWeightStrong控制标题类组件(如 h1、h2、h3)或选中项的字体粗细。number600
lineHeight文本行高number1.5714285714285714
lineType用于控制组件边框、分割线等的样式,默认是实线stringsolid
lineWidth用于控制组件边框、分割线等的宽度number1
marginXS控制元素外边距,小尺寸。number8
marginXXS控制元素外边距,最小尺寸。number4
motionDurationMid动效播放速度,中速。用于中型元素动画交互string0.2s
padding控制元素的内间距。number16
paddingLG控制元素的大内间距。number24
Default size card
More

Card content

Card content

Card content

Small size card
More

Card content

Card content

Card content

典型卡片

包含标题、内容、操作区域。

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

Card content

Card content

Card content

无边框

在灰色背景上使用无边框的卡片。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon

Card content

Card content

Card content

简洁卡片

只包含内容区域。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
example
Europe Street beat
www.instagram.com
更灵活的内容展示

可以利用 Card.Meta 支持更灵活的内容。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
Card title
Card content
Card title
Card content
Card title
Card content
栅格卡片

在系统概览页面常常和栅格进行配合。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
预加载的卡片

数据读入前会有文本块样式。

Card Title
Content
Content
Content
Content
Content
Content
Content
网格型内嵌卡片

一种常见的卡片内容区隔模式。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
Card title
Inner Card title
More
Inner Card content
Inner Card title
More
Inner Card content
内部卡片

可以放在普通卡片内部,展示多层级结构的信息。

CodeSandbox Icon
Hitu Icon
codepen icon
External Link Icon
Expand Icon
Card title
More
tab1
tab2

content1



article
app
project
More

app content

带页签的卡片

可承载更多内容。

CodeSandbox Icon
codepen icon
External Link Icon
Expand Icon
example
Card title
This is the description
支持更多内容配置

一种支持封面、头像、标题和描述信息的卡片。

CodeSandbox Icon
codepen icon
External Link Icon
Expand Icon
Object Card
Object Card Meta title
This is the description
Function Card
Function Card Meta title
This is the description
自定义语义结构的样式和类

通过 classNames 和 styles 传入对象/函数可以自定义 Card 的语义化结构样式。

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