JGuang

卡片

Card · Arco Design

交互预览
npm install @arco-design/web-react@2.66.18

卡片 Card

将信息分类后分标题、详情等区域聚合展现,一般作为简洁介绍或者信息的大盘和入口。

安装

npm install @arco-design/web-react@2.66.18

在入口引入 @arco-design/web-react/dist/css/arco.css,用 ConfigProvider 设置语言。React 19 项目还需在入口最先引入 @arco-design/web-react/es/_util/react-19-adapter,否则 Message、Modal 等命令式 API 无法渲染。

示例

  • 基础用法:常规的内容容器,可承载文字、列表、图片、段落,常用于模块划分和内容概览。
  • 鼠标悬浮样式:指定 hoverable 来为卡片添加鼠标悬浮样式,同时你可以通过样式覆盖来自定义悬浮样式。
  • 无边框卡片:设置 bordered 为 false 来使用无边框卡片。
  • 简洁卡片:卡片可以只有内容区域。
  • 更灵活的内容展示:使用 Card.Meta 支持更加灵活的内容(封面、头像、 标题、描述信息)
  • 栅格卡片:在系统概览页面常常和栅格进行配合。
  • 预加载的卡片:结合 Skeleton 来在数据读入前显示文本骨架。
  • 网络型内嵌卡片:通过 Card.Grid 来使用卡片内容区隔模式。
  • 内部卡片:卡片中可以嵌套其他卡片组件。
  • 带页签的卡片:举例来说,可以在卡片组件里面使用 Tabs 标签页组件。
  • 支持更多内容配置:actions 字段接收一个 ReactNode 数组,用于展示底部按钮组。

示例来自 Arco Design 官方仓库(MIT),固定在 npm 2.66.18 对应的提交;部分示例使用在线图片或上传地址,预览中网络请求被禁用。

API

Card

参数名描述类型默认值
bordered是否有边框booleantrue
hoverable是否可悬浮boolean-
loading是否为加载中boolean-
size卡片尺寸'default' | 'small'default
cover卡片封面ReactNode-
extra卡片右上角的操作区域string | ReactNode-
title卡片标题string | ReactNode-
actions卡片底部的操作组ReactNode[]-
bodyStyle内容区域自定义样式CSSProperties-
className节点类名string | string[]-
headerStyle自定义标题区域样式CSSProperties-
style节点样式CSSProperties-

Card.Meta

参数名描述类型默认值
avatar头像ReactNode-
description描述string | ReactNode-
title标题string | ReactNode-
className节点类名string | string[]-
style节点样式CSSProperties-

Card.Grid

参数名描述类型默认值
hoverable是否可以悬浮boolean-
className节点类名string | string[]-
style节点样式CSSProperties-