Card 卡片
uni-appH5微信小程序App
用于承载一组相关内容的跨端卡片容器。
何时使用
聚合展示一类信息:列表项、仪表盘区块、设置分组。
何时不使用
层级很深的嵌套卡片会造成视觉噪音,改用 Divider 分区。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
title | string | "" | 标题;提供 header 插槽时被覆盖 |
shadow | string:'none' | 'sm' | 'md' | 'lg' | "sm" | 阴影层级,对应 --rn-shadow-* 变量;hover 时上浮 2px 且阴影升一档 |
bordered | boolean | true | 是否显示 1px 边框 |
padding | string:'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>