Card 卡片
在独立容器中展示相关内容和操作。
基础用法
通过 title 提供卡片标题,内容写在 children 中。
项目资料
示例
选中状态
selected 只改变外观,不会让整张卡片成为可点击控件。需要选择卡片时,使用明确的按钮或选择控件。
个人方案
团队方案
尺寸
内嵌标签页默认跟随卡片的 size,可通过 tabs.size 单独设置,高度与独立的同尺寸线形 Tabs 一致;卡片内的按钮、输入框等控件使用各自的 size。
项目资料
项目资料
项目资料
分层卡片
设置 variant="layered",将标题与内容卡分层展示。此时不展示 description。
项目进度
独立标题
CardTitle 可以在卡片外使用,默认渲染 <h3>。通过 level 匹配页面的标题层级,不改变视觉尺寸。
项目资料
标题与底部操作
使用 extra 放置标题旁的操作,使用 footer 放置正文下方的操作。
项目资料
标签页卡片
通过 tabs.items 定义标签页。没有卡片标题时,请通过 tabs['aria-label'] 提供名称。各项的 children 是对应页面内容;若仅将标签栏用于切换状态并把内容写在 Card 的 children 中,可省略各项的 children。Card 的 children 会作为正文展示在下方。
标题与标签页
通过 tabs.activeKey 和 tabs.onChange 控制当前标签。默认保留已访问页面的输入状态;设置 destroyInactive 可在切走时卸载页面。其他标签交互见 Tabs API(新标签页打开)。
项目设置
加载状态
loading 使用骨架屏替换正文和标签页内容,不会自动禁用标题、标签或操作;需要禁用的操作由应用处理。
项目资料
API
Card API
卡片的标题、内容区域、内嵌标签页与加载状态配置。
CardTabs API
内嵌标签页的可用属性见 Tabs API(新标签页打开)。Card 固定使用 type="line" 与 placement="top",并为标签页内容接入加载骨架;tabs.extra 仍属于标签栏,items 为空时恢复普通卡片。
CardTitle API
支持原生标题属性,ref 指向实际标题元素。ConfigProvider 的 components.CardTitle 默认参数只影响直接使用的标题;Card 内部标题继续跟随 Card 的尺寸。