uniapp组件库Card 卡片 的使用方法

简介: uniapp组件库Card 卡片 的使用方法

卡片组件一般用于多个列表条目,且风格统一的场景。

#平台差异说明

App H5 微信小程序 支付宝小程序 百度小程序 头条小程序 QQ小程序

#基本使用

组件的头部信息可以通过参数配置,其他主体和底部的信息,需要通过slot传入。

  • title配置标题
  • sub-title配置副标题
<template>
  <u-card :title="title" :sub-title="subTitle" :thumb="thumb">
    <view class="" slot="body">
      <view class="u-body-item u-flex u-border-bottom u-col-between u-p-t-0">
        <view class="u-body-item-title u-line-2">瓶身描绘的牡丹一如你初妆,冉冉檀香透过窗心事我了然,宣纸上走笔至此搁一半</view>
        <image src="https://img11.360buyimg.com/n7/jfs/t1/94448/29/2734/524808/5dd4cc16E990dfb6b/59c256f85a8c3757.jpg" mode="aspectFill"></image>
      </view>
      <view class="u-body-item u-flex u-row-between u-p-b-0">
        <view class="u-body-item-title u-line-2">釉色渲染仕女图韵味被私藏,而你嫣然的一笑如含苞待放</view>
        <image src="https://img12.360buyimg.com/n7/jfs/t1/102191/19/9072/330688/5e0af7cfE17698872/c91c00d713bf729a.jpg" mode="aspectFill"></image>
      </view>
    </view>
    <view class="" slot="foot"><u-icon name="chat-fill" size="34" color="" label="30评论"></u-icon></view>
  </u-card>
</template>
 
<script>
export default {
  data() {
    return {
      title: '素胚勾勒出青花,笔锋浓转淡',
      subTitle: '2020-05-15',
      thumb: 'http://pic2.sc.chinaz.com/Files/pic/pic9/202002/hpic2119_s.jpg',
    };
  }
};
</script>
 
<style scoped lang="scss">
  .u-card-wrap { 
    background-color: $u-bg-color;
    padding: 1px;
  }
  
  .u-body-item {
    font-size: 32rpx;
    color: #333;
    padding: 20rpx 10rpx;
  }
    
  .u-body-item image {
    width: 120rpx;
    flex: 0 0 120rpx;
    height: 120rpx;
    border-radius: 8rpx;
    margin-left: 12rpx;
  }
</style>

#配置卡片间距

可以通过margin参数配置卡片与屏幕左右的边距,以及上下卡片之间的距离,如: 20rpx 30rpx20rpx 30rpx 30rpx 20rpx

注意:当设置full参数为true的时候,也就是卡片占据屏幕总宽度的时候,通过margin配置的左右边距会失效。

<u-card margin="30rpx"></u-card>

#配置卡片左上角的缩略图

这个缩略图是可选的,显示在卡片的左上角位置,如果配置了thumb参数(图片路径),就会显示图片。

  • thumb缩略图路径
  • thumb-width缩略图宽度,高等于宽
  • thumb-circle缩略图是否为圆形
<u-card thumb="xxx.jpg" thumb-width="60"></u-card>

#配置卡片边框

这里说的边框,有3个:

  • border配置是否显示整个卡片的外边框
  • head-border-bottom配置是否显示卡片内部头部的下边框
  • foot-border-top配置是否显示卡片内部底部的上边框
<u-card :border="false" :foot-border-top="false"></u-card>

#设置内边距

默认下,卡片内部的头部,主体,底部都有一个内边距,可以通过配置padding参数去覆盖:

<u-card padding="30"></u-card>

#API

#Props

参数 说明 类型 默认值 可选值
full 卡片与屏幕两侧是否留空隙 Boolean fasle true
title 头部左边的标题 String - -
title-color 标题颜色 String #303133 -
title-size 标题字体大小,单位rpx String | Number 30 -
sub-title 头部右边的副标题 String - -
sub-title-color 副标题颜色 String #909399 -
sub-title-size 副标题字体大小 String | Number 26 -
border 是否显示边框 Boolean true false
index 用于标识点击了第几个卡片 String | Number - -
margin 卡片与屏幕两边和上下元素的间距,需带单位,如"30rpx 20rpx",见上方说明 String 30rpx -
border-radius 卡片整体的圆角值,单位rpx String | Number 16 -
head-style 头部自定义样式,对象形式 Object - -
body-style 主体自定义样式,对象形式 Object - -
foot-style 底部自定义样式,对象形式 Object - -
head-border-bottom 是否显示头部的下边框 Boolean true false
foot-border-top 是否显示底部的上边框 Boolean true false
thumb 缩略图路径,如设置将显示在标题的左边,不建议使用相对路径 String - -
thumb-width 缩略图的宽度,高等于宽,单位rpx String | Number 60 -
thumb-circle 缩略图是否为圆形 Boolean false true
padding 给head,body,foot部的内边距,见上方说明,单位rpx String | Number 30 -
show-head 1.3.5 是否显示头部 Boolean true false
show-foot 1.3.5 是否显示尾部 Boolean true false
box-shadow 1.6.2 卡片外围阴影,字符串形式 String none -

#Slot

名称 说明
head 自定义卡片头部内容
body 自定义卡片主体部分内容
foot 自定义卡片底部部分内容

#Event

事件名 说明 回调参数
click 整个卡片任意位置被点击时触发 index: 用户传递的标识符
head-click 卡片头部被点击时触发 index: 用户传递的标识符
body-click 卡片主体部分被点击时触发 index: 用户传递的标识符
foot-click 卡片底部部分被点击时触发 index: 用户传递的标识符


相关文章
|
3月前
|
移动开发 前端开发 小程序
uniapp内置组件uni.navigateTo跳转后页面空白问题解决
【7月更文挑战第1天】uniapp内置组件uni.navigateTo跳转后页面空白问题解决
70 4
|
3月前
|
JavaScript Java 测试技术
基于springboot+vue.js+uniapp的试题库管理系统附带文章源码部署视频讲解等
基于springboot+vue.js+uniapp的试题库管理系统附带文章源码部署视频讲解等
42 1
|
3月前
uniapp实战 —— 轮播图【数字下标】(含组件封装,点击图片放大全屏预览)
uniapp实战 —— 轮播图【数字下标】(含组件封装,点击图片放大全屏预览)
58 1
|
3月前
uniapp实战 —— 轮播图【自定义指示点】(含组件封装,自动注册全局组件,添加全局组件类型声明)
uniapp实战 —— 轮播图【自定义指示点】(含组件封装,自动注册全局组件,添加全局组件类型声明)
128 1
|
3月前
uniapp【组件封装】时间戳格式化为星期
uniapp【组件封装】时间戳格式化为星期
62 0
|
3月前
|
数据库
uniapp 【专题详解 -- 时间】云数据库时间类型设计,时间生成、时间格式化渲染(uni-dateformat 组件的使用)
uniapp 【专题详解 -- 时间】云数据库时间类型设计,时间生成、时间格式化渲染(uni-dateformat 组件的使用)
124 0
|
3月前
uniapp 新建组件
uniapp 新建组件
33 0
|
3月前
|
前端开发 JavaScript 索引
uniapp的u-album组件自定义删除功能
这样,你就可以在u-album组件中实现自定义的删除功能了。需要注意的是,这个删除操作只是在前端删除了图片项,并没有在后端删除对应的图片文件,如果你需要在后端也删除对应的图片文件,你还需要在删除操作后发送一个请求到后端,让后端删除对应的图片文件。
81 0
|
5月前
|
开发框架 JSON 定位技术
uniapp中map组件动态加载marks标记
uniapp中map组件动态加载marks标记
408 5
|
5月前
|
JavaScript 前端开发 小程序
uniapp中nvue页面如何全屏,map组件如何全屏?
uniapp中nvue页面如何全屏,map组件如何全屏?
228 3
下一篇
无影云桌面