1、button 标签的基本属性
属性 | 类型 | 默认值 | 必填 | 说明 | 最低版本 |
---|---|---|---|---|---|
size | string | default | 否 | 按钮的大小 | 1.0.0 |
type | string | default | 否 | 按钮的样式类型 | 1.0.0 |
plain | boolean | false | 否 | 按钮是否镂空,背景色透明 | 1.0.0 |
disabled | boolean | false | 否 | 是否禁用 | 1.0.0 |
loading | boolean | false | 否 | 名称前是否带 loading 图标 | 1.0.0 |
form-type | string | 否 | 用于 form 组件,点击分别会触发 form 组件的 submit/reset 事件 | 1.0.0 | |
open-type | string | 否 | 微信开放能力 | 1.1.0 | |
hover-class | string | button-hover | 否 | 指定按钮按下去的样式类。当 hover-class="none" 时,没有点击态效果 |
1.0.0 |
hover-stop-propagation | boolean | false | 否 | 指定是否阻止本节点的祖先节点出现点击态 | 1.5.0 |
hover-start-time | number | 20 | 否 | 按住后多久出现点击态,单位毫秒 | 1.0.0 |
hover-stay-time | number | 70 | 否 | 手指松开后点击态保留时间,单位毫秒 | 1.0.0 |
lang | string | en | 否 | 指定返回用户信息的语言,zh_CN 简体中文,zh_TW 繁体中文,en 英文。 | 1.3.0 |
session-from | string | 否 | 会话来源,open-type="contact"时有效 | 1.4.0 | |
send-message-title | string | 当前标题 | 否 | 会话内消息卡片标题,open-type="contact"时有效 | 1.5.0 |
send-message-path | string | 当前分享路径 | 否 | 会话内消息卡片点击跳转小程序路径,open-type="contact"时有效 | 1.5.0 |
send-message-img | string | 截图 | 否 | 会话内消息卡片图片,open-type="contact"时有效 | 1.5.0 |
app-parameter | string | 否 | 打开 APP 时,向 APP 传递的参数,open-type=launchApp时有效 | 1.9.5 | |
show-message-card | boolean | false | 否 | 是否显示会话内消息卡片,设置此参数为 true,用户进入客服会话会在右下角显示"可能要发送的小程序"提示,用户点击后可以快速发送小程序消息,open-type="contact"时有效 | 1.5.0 |
bindgetuserinfo | eventhandle | 否 | 用户点击该按钮时,会返回获取到的用户信息,回调的detail数据与wx.getUserInfo返回的一致,open-type="getUserInfo"时有效 | 1.3.0 | |
bindcontact | eventhandle | 否 | 客服消息回调,open-type="contact"时有效 | 1.5.0 | |
bindgetphonenumber | eventhandle | 否 | 获取用户手机号回调,open-type=getPhoneNumber时有效 | 1.2.0 | |
binderror | eventhandle | 否 | 当使用开放能力时,发生错误的回调,open-type=launchApp时有效 | 1.9.5 | |
bindopensetting | eventhandle | 否 | 在打开授权设置页后回调,open-type=openSetting时有效 | 2.0.7 | |
bindlaunchapp | eventhandle | 否 | 打开 APP 成功的回调,open-type=launchApp时有效 | 2.4.4 |
2、size按钮大小属性的合法值
值 | 说明 | 最低版本 |
---|---|---|
default | 默认大小 | |
mini | 小尺寸 |
3、type按钮的样式类型属性的合法值
值 | 说明 | 最低版本 |
---|---|---|
primary | 绿色 | |
default | 白色 | |
warn | 红色 |
4、form-type用于from组件属性的合法值
值 | 说明 | 最低版本 |
---|---|---|
submit | 提交表单 | |
reset | 重置表单 |
5、open-type微信开发能力属性的合法值
值 | 说明 | 最低版本 |
---|---|---|
contact | 打开客服会话,如果用户在会话中点击消息卡片后返回小程序,可以从 bindcontact 回调中获得具体信息,具体说明 | 1.1.0 |
share | 触发用户转发,使用前建议先阅读使用指引 | 1.2.0 |
getPhoneNumber | 获取用户手机号,可以从bindgetphonenumber回调中获取到用户信息,具体说明 | 1.2.0 |
getUserInfo | 获取用户信息,可以从bindgetuserinfo回调中获取到用户信息 | 1.3.0 |
launchApp | 打开APP,可以通过app-parameter属性设定向APP传的参数具体说明 | 1.9.5 |
openSetting | 打开授权设置页 | 2.0.7 |
feedback | 打开“意见反馈”页面,用户可提交反馈内容并上传日志,开发者可以登录小程序管理后台后进入左侧菜单“客服反馈”页面获取到反馈内容 | 2.1.0 |
6、lang指定返回用户信息的语言属性的合法值
值 | 说明 | 最低版本 |
---|---|---|
en | 英文 | |
zh_CN | 简体中文 | |
zh_TW | 繁体中文 |
7、open-type的contact打开客服会话微信开发功能的实现流程 ?
1)、将⼩程序?的 d appid 由测试号改为?⾃⼰的 appid
2)、登录微信⼩程序官⽹,添加客服 - - 微信
3)、为了⽅便演⽰,⽼师⾃⼰准备了两个账号
普通⽤⼾A
客服-微信B
就是⼲!
8、button 标签代码如下:
1)、WXML代码
<!-- button 标签 1、外观 1)、size 控制按钮的大小 default 默认大小 mini 小尺寸 2)、type 用来控制按钮的颜色 default 灰色 默认 primary 绿色 warn 红色 3)、plain 按钮是否缕空,背景色透明 --> <button>默认按钮</button> <button size="mini">mini 默认按钮小尺寸</button> <button type="primary">primary绿色按钮</button> <button type="warn">warn红色按钮</button> <button type="primary" plain="{{true}}">按钮缕空,背景色透明</button> <button type="primary" form-type="submit">用于 form 组件,点击分别会触发 form 组件的 submit/reset 事件</button>
9、button 开发能力代码如下:
1)、WXML代码
<!-- button 开发能力 open-type: 1、contact 直接打开 客服对话功能 需要在微信小程序的后台配置 只能够通过真机调试来打开 2、share 转发当前的小程序 到微信朋友中 不能把小程序 分享到朋友圈 3、getPhoneNumber 获取当前用户的手机号码信息 结合一个事件来使用 不是企业的小程序账号 没有权限来获取用户的手机号码 1)、绑定一个事件 bindgetphonenumber 2)、在事件的回调函数中 通过参数来获取信息 3)、获取到的信息 已经加密过了 需要用户自己搭建小程序后台服务器,在后台服务器进行解析 手机号码 ,返回到小程序中 就可以看到信息了 4、getUserInfo 获取当前用户的个人信息 1)、使用方法 类似 获取用户的手机号码 2)、可以直接获取 不存在加密的字段 5、launchApp 在小程序当中 直接打开app 1)、需要现在app中通过app的某个链接 打开 小程序 2)、在小程序中 再通过这个功能重新打开app 3)、找到京东的app和京东的小程序 6、openSetting 打开小程序内置的授权页面 1)、授权页面中 只会出现 用户曾经点击过的 权限 7、feedback 打开 小程序内置的 意见反馈页面 1)、只能够通过真机调试来打开 --> <button open-type="contact">contact</button> <button open-type="share">share</button> <button open-type="getPhoneNumber" bindgetphonenumber="getPhoneNumber">getPhoneNumber</button> <button open-type="getUserInfo" bindgetuserinfo="getUserInfo">getUserInfo</button> <button open-type="launchApp">launchApp</button> <button open-type="openSetting">openSetting</button> <button open-type="feedback">feedback</button>