跳到主要内容

Card 卡片 ​

uni-appH5微信小程序App

用于承载一组相关内容的跨端卡片容器。

何时使用 ​

聚合展示一类信息:列表项、仪表盘区块、设置分组。

何时不使用 ​

层级很深的嵌套卡片会造成视觉噪音,改用 Divider 分区。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Card 卡片 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
titlestring""标题;提供 header 插槽时被覆盖
shadowstring:'none' | 'sm' | 'md' | 'lg'"sm"阴影层级,对应 --rn-shadow-* 变量;hover 时上浮 2px 且阴影升一档
borderedbooleantrue是否显示 1px 边框
paddingstring:'sm' | 'md' | 'lg'"md"内边距:sm 12px / md 16px / lg 24px;header 与 footer 的垂直内边距自动收紧一档

Slots ​

名称说明
default卡片主体
cover卡片顶部内容
header卡片标题区域
footer卡片底部内容

示例 ​

基础卡片 ​

vue
<Card title="组件库周报">
  <Text variant="secondary">本周新增 12 个 uni-app 组件,修复 5 个跨端兼容问题。</Text>
</Card>

封面图 ​

vue
<Card title="极光主题">
  <template #cover><view class="card-cover" /></template>
  <Text variant="secondary">aurora 主题渐变封面示例。</Text>
</Card>

自定义头尾 ​

vue
<Card>
  <template #header><view class="row"><Text weight="bold">订单 #20260618</Text><Tag variant="success">已完成</Tag></view></template>
  <Text variant="secondary">机械键盘 × 1,合计 ¥899.00</Text>
  <template #footer><view class="row"><Button size="sm" variant="ghost">查看物流</Button><Button size="sm" variant="primary">再次购买</Button></view></template>
</Card>