button 按钮
收藏
我的收藏

基础库 1.0.0 开始支持本组件。
按钮,用于强调操作并引导用户去点击,组件模板和样式

属性说明

属性名
类型
默认值
必填
说明
最低支持版本
size
string
default
按钮的大小,详情见 size 的合法值
1.0.0
type
string
default
按钮的样式类型,详情见 type 的合法值
1.0.0
disabled
boolean
false
是否禁用
1.0.0
loading
boolean
false
是否带 loading 图标
1.0.0
form-type
string
用于嵌在 form 组件中,控制 submit/reset,详情见 form-type 的合法值
1.0.0
open-type
string
用于调用开放能力, 详情见 open-type 的合法值
1.0.0
hover-class
string
button-hover
点击状态的样式类
1.0.0
hover-start-time
number
20
按住后多久出现点击态,单位毫秒
1.0.0
hover-stay-time
number
70
手指松开后点击态保留时间,单位毫秒
1.0.0
hover-stop-propagation
boolean
false
指定是否阻止本节点的祖先节点出现点击态
1.0.0
bindgetphonenumber
EventHandle
获取用户手机号回调,只在 open-type="getPhoneNumber" 时有效
1.14.0
bindagreeprivacyauthorization
EventHandle
授权隐私协议回调,只在 open-type="agreePrivacyAuthorization" 时有效,详情见 小程序隐私协议开发指南
3.19.0

size 的合法值

说明
最低支持版本
default
默认大小
1.0.0
mini
小尺寸
1.0.0

type 的合法值

说明
最低支持版本
primary
红色
1.0.0
default
白色
1.0.0

form-type 的合法值

说明
最低支持版本
submit
提交表单
1.0.0
reset
重置表单
1.0.0

open-type 的合法值

说明
最低支持版本
share
触发用户转发, 可以配合 data-channel 属性来设置分享的 channel,具体请参考 ShareParam
1.0.0
getPhoneNumber
获取用户手机号,可以从 bindgetphonenumber 回调中获取到用户信息,详情请参见获取手机号
1.14.0
uploadDouyinVideo
发布抖音视频,详情请参见发布抖音视频
2.65.0
joinGroup
加群,详情请参见加群
2.69.0
im
跳转到抖音IM客服,详情请参见抖音IM客服能力
2.80.0
privateMessage
私信,详情请参见私信
2.82.0
platformIm
跳转到抖音平台客服,详情请参见平台客服能力
2.89.0
navigateToVideoView
跳转视频播放页,详情请参见跳转视频播放页
2.92.0
openAwemeUserProfile
跳转抖音号个人页,详情请参见跳转抖音号个人页
2.92.0
openWebcastRoom
跳转抖音直播间,详情请参见跳转抖音直播间
2.92.0
addShortcut
添加到桌面,详情请参见添加到桌面
2.92.0
authorizePrivateMessage
主动授权私信,详情请参见主动授权私信
2.92.0
addCalendarEvent
写入系统日历,详情请参见写入系统日历
2.93.0
agreePrivacyAuthorization
授权隐私协议,详情请参见小程序隐私协议开发指南
3.19.0

扫码体验

代码示例

Bug & Tip

Tip:button-hover 的样式为 { color: rgba(34, 34, 34, 0.6); background-color: rgb(219, 220, 220); border-color: rgb(216, 216, 216);}