Button按钮
引入
在app.json或index.json中引入组件,默认为ES6版本
"usingComponents": {
"vtu-btn": "/miniprogram_npm/vtuweapp/button/vtu-btn"
}
代码演示
按钮类型
支持default
primary
info
warning
danger
五种类型,默认为default
<vtu-btn >普通按钮</vtu-btn>
<vtu-btn type="primary">主要按钮</vtu-btn>
<vtu-btn type="success">成功按钮</vtu-btn>
<vtu-btn type="warning">警告按钮</vtu-btn>
<vtu-btn type="danger">danger按钮</vtu-btn>
按钮阴影
通过shadow
属性给按钮添加阴影
<vtu-btn shadow>普通按钮</vtu-btn>
<vtu-btn shadow type="primary">主要按钮</vtu-btn>
<vtu-btn shadow type="success">成功按钮</vtu-btn>
<vtu-btn shadow type="warning">警告按钮</vtu-btn>
<vtu-btn shadow type="danger">danger按钮</vtu-btn>
朴素按钮
通过plain
属性将按钮设置为朴素按钮,朴素按钮的文字为按钮颜色,背景为白色
<vtu-btn plain="true">普通按钮</vtu-btn>
<vtu-btn type="primary" plain="true">主要按钮</vtu-btn>
<vtu-btn type="success" plain="true">成功按钮</vtu-btn>
<vtu-btn type="warning" plain="true">警告按钮</vtu-btn>
<vtu-btn type="danger" plain="true">danger按钮</vtu-btn>
按钮尺寸
支持default
medium
small
mini
四种尺寸,默认为default
<vtu-btn size="default">默认尺寸</vtu-btn>
<vtu-btn size="medium">中等按钮</vtu-btn>
<vtu-btn size="small">小型按钮</vtu-btn>
<vtu-btn size="mini">超小按钮</vtu-btn>
圆角按钮
通过round
属性,将按钮设置为圆角按钮
<vtu-btn plain="true" round="true">普通按钮</vtu-btn>
<vtu-btn type="primary" round="true">主要按钮</vtu-btn>
<vtu-btn type="success" round="true">成功按钮</vtu-btn>
<vtu-btn type="warning" round="true">警告按钮</vtu-btn>
<vtu-btn type="danger" round="true">danger按钮</vtu-btn>
禁用按钮
通过disabled
属性,将按钮设置不可用
<vtu-btn disabled="true">普通按钮</vtu-btn>
<vtu-btn type="primary" disabled="true">主要按钮</vtu-btn>
<vtu-btn type="success" disabled="true">成功按钮</vtu-btn>
<vtu-btn type="warning" disabled="true">警告按钮</vtu-btn>
<vtu-btn type="danger" disabled="true">danger按钮</vtu-btn>
图标按钮
通过icon
属性,可对按钮设置图标
<vtu-btn inlineBlock icon="iconfont icon-jiansuo"></vtu-btn>
<vtu-btn inlineBlock type="primary" icon="iconfont icon-jiansuo">主要按钮</vtu-btn>
<vtu-btn inlineBlock type="success" icon="iconfont icon-shangchuan">成功按钮</vtu-btn>
<vtu-btn inlineBlock type="warning" icon="iconfont icon-bianji"></vtu-btn>
<vtu-btn inlineBlock type="danger" icon="iconfont icon-picture-delet"></vtu-btn>
<vtu-btn inlineBlock type="danger">删除按钮<i class="iconfont icon-picture-delet"></i></vtu-btn>
加载按钮
通过loading
属性,设置按钮加载状态
<vtu-btn loading></vtu-btn>
<vtu-btn loading type="primary">更新</vtu-btn>
<vtu-btn loading type="success" loading-text="加载中"></vtu-btn>
自定义颜色
<vtu-btn v-class="btn-class" bg-color="#6739b6" font-color="#fff">purple</vtu-btn>
<vtu-btn v-class="btn-class" bg-color="#a5673f" font-color="#fff">brown</vtu-btn>
<vtu-btn v-class="btn-class" bg-color="linear-gradient(45deg, #ec008c, #6739b6)" font-color="#fff">霞红渐变</vtu-btn>
组件参数
Props
参数 | 说明 | 类型 | 默认 | 必填 |
---|
id | 标识符 | String | - | 否 |
type | 按钮类型,可选值为primary info warning danger | String | default | 否 |
size | 按钮尺寸,可选值为 default medium small mini | String | default | 否 |
icon | 左侧图标名称 | String | - | 否 |
plain | 是否为朴素按钮 | Boolean | false | 否 |
loading | 是否显示为加载状态 | Boolean | false | 否 |
inlineBlock | 是否为块级元素 | Boolean | false | 否 |
round | 是否为圆角按钮 | Boolean | false | 否 |
circle | 是否为圆形按钮 | Boolean | false | 否 |
disabled | 是否禁用按钮 | Boolean | false | 否 |
shadow | 是否显示阴影 | Boolean | false | 否 |
open-type | 微信开放能力 | String | - | 否 |
lang | 指定返回用户信息的语言,zh_CN 简体中文, zh_TW 繁体中文,en 英文 | String | - | 否 |
loading-text | 加载状态提示文字 | 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"时有效 | Boolean | false | 否 |
bg-color | 自定义按钮背景色 | String | - | 否 |
font-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 |
外部样式类
外部样式类名 | 说明 |
---|
v-class | 组件外部样式类 |