Card 卡片
在独立容器中展示相关内容和操作。
基础用法
项目概览
尺寸
size 提供小、默认和大三种尺寸,同时调整卡片内边距、标题字号与标题栏高度。内嵌 Tabs 默认跟随卡片尺寸,也可通过 tabs.size 单独设置;卡片内的按钮、输入框等控件使用各自的 size。
下面的三张卡片展示相同内容,方便对比标题、标签栏与正文留白;每张卡片的标签均可独立切换。
小尺寸
默认尺寸
大尺寸
内容分区
默认以留白组织内容;设置 divided 可划分标题、正文与底部操作区。
项目概览
内容分区
标签页卡片
通过 tabs.items 设置标签与对应内容。没有标题时,标签占满标题栏高度,文字上下留白一致;卡片的 extra 显示在标签栏右侧。
- 负责人
- 林若
- 团队成员
- 8 人
标题与标签页
有 title 或 description 时,标签栏位于标题区域下方,两者之间没有分割线,分割线只展示在标签栏下方。tabs.activeKey / tabs.onChange 控制当前标签,默认保留已访问页面的输入内容;divided 继续控制底部操作区的分隔线和背景。
项目设置
Card API
类型
定义组件属性或组装列表时可导入相关类型。
使用说明
extra 和 footer 可以放置按钮或链接。需要点击操作时请使用明确的按钮或链接。
tabs 复用 Tabs 的配置和交互,固定使用顶部线形标签。tabs.items[].children 是对应页面内容;Card 的 children 可放置在所有页面下方的公共说明。loading 替换正文为骨架屏,标题、标签栏和操作保持可用。标签默认跟随卡片的 size,可用 tabs.size 单独调整;标签数组为空时恢复普通卡片。
可在 tabs 中设置禁用、图标、手动键盘激活、保留或销毁页面、溢出菜单以及增删、排序回调。tabs.extra 始终属于标签栏;有标题时 Card 的 extra 仍位于标题右侧。
外观与丰富内容
description 显示标题下的补充说明。普通卡片默认不显示内部边框,标签页卡片始终在标签栏下方展示分割线;设置 divided 可增加底部的分隔线与淡灰背景,操作区与 Modal、Drawer 使用一致的纵向留白。通过 ConfigProvider 的 components.Card 可定制背景、分区背景和边框。