Blame view

uni_modules/uni-card/readme.md 3.75 KB
290144e9   易尊强   第一次
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
  
  
  ## Card 卡片
  > **组件名:uni-card**
  > 代码块: `uCard`
  
  
  卡片视图组件。
  
  ### 安装方式
  
  本组件符合[easycom](https://uniapp.dcloud.io/collocation/pages?id=easycom)规范,`HBuilderX 2.5.5`起,只需将本组件导入项目,在页面`template`中即可直接使用,无需在页面中`import`和注册`components`
  
  如需通过`npm`方式使用`uni-ui`组件,另见文档:[https://ext.dcloud.net.cn/plugin?id=55](https://ext.dcloud.net.cn/plugin?id=55)
  
  > **注意事项**
  > 为了避免错误使用,给大家带来不好的开发体验,请在使用组件前仔细阅读下面的注意事项,可以帮你避免一些错误。
  > - 因为平台兼容问题 , 目前 APP-NVUE 安卓平台下不支持阴影
  
  
  ### 基本用法
  
  ``template`` 中使用组件
  
  ```html
  <!-- 一般用法 -->
  <uni-card title="标题文字" thumbnail="https://vkceyugu.cdn.bspapp.com/VKCEYUGU-dc-site/460d46d0-4fcc-11eb-8ff1-d5dcf8779628.png" extra="额外信息" note="Tips">
      内容主体,可自定义内容及样式
  </uni-card>
  
  <!-- 内容通栏 -->
  <uni-card is-full="true" title="DCloud" thumbnail="https://vkceyugu.cdn.bspapp.com/VKCEYUGU-dc-site/460d46d0-4fcc-11eb-8ff1-d5dcf8779628.png" extra="2018.12.12" >
      <image src="https://vkceyugu.cdn.bspapp.com/VKCEYUGU-dc-site/460d46d0-4fcc-11eb-8ff1-d5dcf8779628.png" style="width: 100%;"></image>
  </uni-card>
  
  <!-- 图文卡片模式 -->
  <uni-card
  	title="标题文字"
  	mode="style"
  	:is-shadow="true"
  	thumbnail="https://vkceyugu.cdn.bspapp.com/VKCEYUGU-dc-site/460d46d0-4fcc-11eb-8ff1-d5dcf8779628.png"
  	extra="Dcloud 2019-05-20 12:32:19"
  	note="Tips"
  >
  		uni-app 是一个使用 Vue.js 开发所有前端应用的框架,开发者编写一套代码,可编译到iOS、Android、H5、以及各种小程序等多个平台。即使不跨端,uni-app同时也是更好的小程序开发框架。
  </uni-card>
  
  <!-- 标题卡片模式 -->
  <uni-card 
  	title="Dcloud" 
  	mode="title" 
  	:is-shadow="true" 
  	thumbnail="https://vkceyugu.cdn.bspapp.com/VKCEYUGU-dc-site/460d46d0-4fcc-11eb-8ff1-d5dcf8779628.png" 
  	extra="技术没有上限" 
  	note="Tips"
  >
  	uni-app 是一个使用 Vue.js 开发所有前端应用的框架,开发者编写一套代码,可编译到iOS、Android、H5、以及各种小程序等多个平台。即使不跨端,uni-app同时也是更好的小程序开发框架。
  </uni-card>
  
  <!-- 自定义底部按钮 -->
  <uni-card title="Dcloud" note="true">
  	默认内容
  	<template v-slot:footer>
  		<view class="footer-box">
  			<view>喜欢</view>
  			<view>评论</view>
  			<view>分享</view>
  		</view>
  	</template>
  </uni-card>
  ```
  
  ## API
  
  ### Card Props
  
  |属性名			|类型		|默认值	|说明																			|
  |:-:				|:-:		|:-:		|:-:																			|
  |title			|String	|-			|标题文字																			|
  |extra			|String	|-			|标题额外信息																		|
  |note				|String	|-			|底部信息																			|
  |thumbnail	|String	|-			|标题左侧缩略图,支持网络图片,本地图片,本图片需要传入一个绝对路径,如:`/static/xxx.png`	|
  |mode				|String	|basic	|卡片模式 ,可选值, basic:基础卡片 ;style :图文卡片 ; title :标题卡片				|
  |isFull			|Boolean|false	|卡片内容是否通栏,为true时将去除padding值											|
  |isShadow		|Boolean|false	|卡片内容是否开启阴影																|
  
  
  ### Card Events
  
  |事件称名	|事件说明						|返回参数	|
  |:-:		|:-:							|:-:		|
  |@click	|点击 Card 触发事件	|-			|
  
  
  ### Card Slots
  
  |插槽称名	|说明				|
  |:-:		|:-:				|
  |header	|卡片头部插槽( 图文卡片 mode="style" 时,不支持)|
  |footer	|卡片底部插槽 |
  
  ## 组件示例
  
  点击查看:[https://hellouniapp.dcloud.net.cn/pages/extUI/card/card](https://hellouniapp.dcloud.net.cn/pages/extUI/card/card)