# Card 卡片
概述
Card 卡片，常用的布局组件。
# 支持平台
目前开发小程序与H5推荐使用 FirstUI nvue版本 (opens new window)。
| 安卓系统版本 | 安卓uni-app | 安卓uniapp-x | iOS系统版本 | iOS uniapp | iOS uniapp-x | 小程序 | H5/Web |
|---|---|---|---|---|---|---|---|
| 5.0 | × | ✓ | 9.0 | × | × | × | ✓ |
# 引入
以下介绍两种常用的引入方式。
第一种：在页面中引用、注册
import fuiCard from "@/components/firstui/fui-card/fui-card.uvue"
export default {
components:{
fuiCard
}
}
1
2
3
4
5
6
2
3
4
5
6
第二种：easycom组件规范
传统vue组件，需要安装、引用、注册，三个步骤后才能使用组件。easycom将其精简为一步。
First UI easycom配置请查看 快速上手。
如果不了解easycom，可先查看 官网文档 (opens new window)。
# 代码演示
部分示例演示，完整使用请参考示例程序以及文档API。
基础使用
通过 src 属性设置头像，图标图片地址，title 属性设置标题，tag 属性设置额外信息，如：时间等。
<fui-card src="/static/images/common/icon_tabbar_3x.png" title="标题文字" tag="额外信息">
<text class="fui-card__content">这是一个基础卡片的示例，此处为自定义内容区域，自行控制内容样式。</text>
</fui-card>
1
2
3
2
3
.fui-card__content {
width: 100%;
font-size: 28rpx;
padding: 32rpx 20rpx;
box-sizing: border-box;
}
1
2
3
4
5
6
2
3
4
5
6
通栏展示
通过 full 属性设置是否通栏，为true时圆角失效。
<fui-card padding="20rpx 32rpx" margin="0" :full="true" src="/static/images/common/icon_tabbar_3x.png" title="标题文字" tag="额外信息">
<text class="fui-card__content fui-padding">这是一个基础卡片的示例，此处为自定义内容区域，自行控制内容样式。</text>
</fui-card>
1
2
3
2
3
.fui-card__content {
width: 100%;
font-size: 28rpx;
padding: 32rpx 20rpx;
box-sizing: border-box;
}
.fui-padding {
padding-left: 32rpx;
padding-right: 32rpx;
}
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
# Slots
| 插槽名称 | 说明 |
|---|---|
| default | Card主内容部分 |
| footer | Card底部显示内容 |
# Props
| 属性名 | 类型 | 说明 | 默认值 | 平台差异说明 |
|---|---|---|---|---|
| margin | String | margin值 | 0 32rpx | - |
| full | Boolean | 是否通栏，圆角失效 | false | - |
| background | String | 背景色 | #fff | - |
| radius | String | 圆角值 | 16rpx | - |
| shadow | String | 阴影，showBorder为false时有效 | 0 2rpx 4rpx 0 rgba(2, 4, 38, 0.05) | - |
| showBorder | Boolean | 是否显示边框，为true时box-shadow和elevation失效 | false | - |
| borderColor | String | 边框颜色 | #EEEEEE | - |
| headerBackground | String | header部分背景色 | #fff | - |
| headerLine | Boolean | 是否需要header底部线条 | true | - |
| footerLine | Boolean | 是否需要内容与footer之间线条 | false | - |
| lineColor | String | header 底部线条颜色 | #EEEEEE | - |
| padding | String | header padding值,格式同css | 20rpx | - |
| src | String | 头像，图标图片地址 | - | - |
| width | Number | 图片宽度，单位rpx | 64 | - |
| height | Number | 图片高度，单位rpx | 64 | - |
| imageRadius | String | 图片圆角 | 8rpx | - |
| title | String | 标题 | - | - |
| size | Number | 标题字体大小，单位rpx | 30 | - |
| color | String | 标题字体颜色 | #7F7F7F | - |
| tag | String | 标签，额外信息 | - | - |
| tagSize | Number | 标签字体大小，单位rpx | 24 | - |
| tagColor | String | 标签字体颜色 | #b2b2b2 | - |
| index | Number | 索引 | 0 | - |
# Events
| 事件名 | 类型 | 说明 | 回调参数 |
|---|---|---|---|
| @onclick | (event: number) => void | 点击Card时触发 | number:索引 |
温馨提示
点击事件返回的索引值需通过 index 属性传入。
Card 卡片