Cell单元格
引入
在app.json或index.json中引入组件,默认为ES6版本
"usingComponents": {
"vtu-cell": "/miniprogram_npm/vtuweapp/cell/item/vtu-cell"
}
代码演示
基础用法
<vtu-cell title="普通信息" value="显示内容" border content="详细的描述信息" bind:click="selectItem" data-label="111"></vtu-cell>
<vtu-cell title="普通信息" value="显示内容" valueColor="#f44" border></vtu-cell>
<vtu-cell title="徽章" border badge_value="10" ></vtu-cell>
图标&箭头
<vtu-cell title="普通信息" value="显示内容" icon="iconfont icon-kefu" border></vtu-cell>
<vtu-cell title="普通信息" value="显示内容" icon="iconfont icon-kefu" icon-color="#1989fa" arrow content="详细的描述信息" border></vtu-cell>
<vtu-cell title="普通信息" value="显示内容" icon="iconfont icon-kefu" border icon-color="#f5bf49" arrow></vtu-cell>
微信开发能力
<vtu-cell title="联系客服" icon="iconfont icon-kefu" border open-type="contact" arrow></vtu-cell>
<vtu-cell title="意见反馈" icon="iconfont icon-kefu" border open-type="feedback" icon-color="#f5bf49" arrow></vtu-cell>
<vtu-cell title="获取用户手机号" icon="iconfont icon-kefu" border open-type="getPhoneNumber" bind:getphonenumber="getPhoneNumber" arrow></vtu-cell>
<vtu-cell title="获取用户信息" icon="iconfont icon-kefu" border open-type="getUserInfo" bind:getuserinfo="getUserInfo" arrow></vtu-cell>
<vtu-cell title="转发" icon="iconfont icon-kefu" border open-type="share" arrow></vtu-cell>
Page({
getUserInfo: function(e) {
wx.showToast({
title: "获取用户信息成功!",
icon: 'none',
duration: 2000
});
console.log("getUserInfo: ", e)
},
getPhoneNumber: function(e) {
wx.showToast({
title: "获取用户手机号成功!",
icon: 'none',
duration: 2000
});
console.log("getPhoneNumber: ", e)
}
});
组件参数
Props
参数 | 说明 | 类型 | 默认值 | 必填 |
---|
title | 标题 | String | - | 否 |
title-color | 标题颜色 | String | - | 否 |
title-size | 标题字体大小 | String | - | 否 |
title-style | 标题区域样式 | String | - | 否 |
icon | 图标 | String | - | 否 |
icon-color | 图标颜色 | String | - | 否 |
icon-size | 图标大小 | String | - | 否 |
icon-style | 图标样式 | String | - | 否 |
border | 是否显示底部边框 | Boolean | - | 否 |
round | 是否为圆角 | Boolean | - | 否 |
disabled | 是否禁用 | Boolean | - | 否 |
arrow | 是否显示箭头 | Boolean | - | 否 |
height | 高度 | String | 45px | 否 |
open-type | 微信开发能力 | String | - | 否 |
lang | 指定返回用户信息的语言,zh_CN 简体中文,zh_TW 繁体中文,en 英文。 | String | - | 否 |
session-from | 会话来源,open-type="contact"时有效 | String | - | 否 |
send-message-title | 会话内消息卡片标题,open-type="contact"时有效 | String | - | 否 |
send-message-path | 会话内消息卡片点击跳转小程序路径,open-type="contact"时有效 | String | - | 否 |
send-message-img | 会话内消息卡片图片,open-type="contact"时有效 | String | - | 否 |
app-parameter | 打开 APP 时,向 APP 传递的参数,open-type=launchApp时有效 | String | - | 否 |
show-message-card | 是否显示会话内消息卡片,设置此参数为 true,用户进入客服会话会在右下角显示"可能要发送的小程序"提示,用户点击后可以快速发送小程序消息,open-type="contact"时有效 | String | - | 否 |
content | 详细描述信息 | String | - | 否 |
value | 右部文字内容 | String | - | 否 |
value-color | 右部文字颜色 | String | - | 否 |
Events
方法名 | 说明 | 参数 | 返回值 |
---|
bind:click | 点击按钮,且按钮状态不为加载或禁用时触发 | - | 绑定的参数对象 |
bind:getuserinfo | 用户点击该按钮时,会返回获取到的用户信息, 从返回参数的 detail 中获取到的值同 wx.getUserInfo | - | 同 wx.getUserInfo |
bind:getphonenumber | 获取用户手机号回调 | - | 同 wx.getphonenumber |
bind:contact | 客服消息回调 | - | 同 wx.contact |
bind:error | 当使用开放能力时,发生错误的回调 | - | 同 wx.error |
bind:opensetting | 在打开授权设置页后回调 | - | 同 wx.opensetting |
bind:launchapp | 打开 APP 成功的回调,open-type=launchApp时有效 | - | 同 wx.launchapp |
Badge 徽章
参数 | 说明 | 类型 | 默认值 | 必填 |
---|
badge_value | 显示值 | String | - | 否 |
badge_shape | 形状,bubble:气泡,dot:圆点 | Boolean | bubble | 否 |
badge_max | 最大值,超过最大值会显示 '{max}+',要求 value 是 Number 类型 | Number | - | 否 |
badge_is-dot | 小圆点,没有内容 | Boolean | false | 否 |
badge_color | 文字颜色 | - | 否 | |
badge_bg-color | 徽章背景色 | - | 否 |
Slot插槽
插槽名 | 说明 |
---|
after | 单元格右部自定义内容 |
外部样式类
外部样式类名 | 说明 |
---|
v-class | 组件外部样式类 |