抖音开放平台Logo
控制台

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