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);}。​