Button 按钮

使用指南

在 json 文件中配置button组件

  1. "usingComponents": {
  2. "van-button": "path/to/vant-weapp/dist/button/index"
  3. }

代码演示

按钮类型

支持defaultprimaryinfowarningdanger五种类型,默认为default

  1. <van-button type="default">默认按钮</van-button>
  2. <van-button type="primary">主要按钮</van-button>
  3. <van-button type="info">信息按钮</van-button>
  4. <van-button type="warning">警告按钮</van-button>
  5. <van-button type="danger">危险按钮</van-button>

朴素按钮

  1. <van-button plain type="primary">朴素按钮</van-button>
  2. <van-button plain type="danger">朴素按钮</van-button>

禁用状态

通过disabled属性来禁用按钮,此时按钮不可点击

  1. <van-button disabled type="primary">禁用状态</van-button>
  2. <van-button disabled type="danger">禁用状态</van-button>

加载状态

  1. <van-button loading type="primary" />
  2. <van-button loading type="danger" loading-text="加载中..." />

按钮形状

  1. <van-button square type="primary">方形按钮</van-button>
  2. <van-button round type="danger">圆形按钮</van-button>

按钮尺寸

支持largenormalsmallmini四种尺寸,默认为normal

  1. <van-button size="large">大号按钮</van-button>
  2. <van-button size="normal">普通按钮</van-button>
  3. <van-button size="small">小型按钮</van-button>
  4. <van-button size="mini">迷你按钮</van-button>

API

参数说明类型默认值
id标识符String-
type按钮类型,可选值为 primary info warning dangerStringdefault
size按钮尺寸,可选值为 normal large small miniStringnormal
plain是否为朴素按钮Booleanfalse
block是否为块级元素Booleanfalse
round是否为圆形按钮Booleanfalse
square是否为方形按钮Booleanfalse
disabled是否禁用按钮Booleanfalse
loading是否显示为加载状态Booleanfalse
loading-text加载状态提示文字String-
loading-size加载图标大小String20px
open-type微信开放能力,具体支持可参考 微信官方文档String-
app-parameter打开 APP 时,向 APP 传递的参数String-
lang指定返回用户信息的语言,zh_CN 简体中文,zh_TW 繁体中文,en 英文Stringen
session-from会话来源String-
business-id客服消息子商户 idNumber-
send-message-title会话内消息卡片标题String当前标题
send-message-path会话内消息卡片点击跳转小程序路径String当前分享路径
send-message-imgsendMessageImgString截图
show-message-card显示会话内消息卡片Stringfalse

Event

事件名说明参数
bind:click点击按钮且按钮状态不为加载或禁用时触发-
bind:getuserinfo用户点击该按钮时,会返回获取到的用户信息,从返回参数的 detail 中获取到的值同 wx.getUserInfo-
bind:contact客服消息回调-
bind:getphonenumber获取用户手机号回调-
bind:error当使用开放能力时,发生错误的回调-
bind:opensetting在打开授权设置页后回调-

外部样式类

类名说明
custom-class根节点样式类
loading-class加载图标样式类

更新日志

版本类型内容
0.0.1feature新增组件
0.1.1feature新增 square 属性
0.3.0bugfix修复在加载状态下仍然显示文字的问题
0.3.4feature新增 id 属性
0.3.7feature新增 round 属性

原文: https://youzan.github.io/vant-weapp/#/button