提供按钮组件,包括胶囊按钮、圆形按钮、文本按钮、弧形按钮、下载按钮。
支持设备
| 智慧屏 |
智能穿戴 |
|---|---|
| 支持 |
支持 |
权限列表
ohos.permission.INTERNET(如果icon使用云端路径)
子组件
不支持。
属性
| 名称 |
类型 |
默认值 |
必填 |
描述 |
|---|---|---|---|---|
| type |
string |
- |
否 |
不支持动态修改。如果该属性缺省,展示类胶囊型按钮,不同于胶囊类型,四边圆角可以通过border-radius分别指定,如果需要设置该属性,则可选值包括如下:
|
| value |
string |
- |
否 |
button的文本值,circle类型不生效。 |
| icon |
string |
- |
否 |
button的图标路径,仅circle类型生效,图标格式为jpg,png和svg。 |
| waiting |
boolean |
false |
否 |
waiting状态,waiting为true时展现等待中转圈效果,位于文本左侧。类型为download时不生效,不支持智能穿戴。 |
| id |
string |
- |
否 |
组件的唯一标识。 |
| style |
string |
- |
否 |
组件的样式声明。 |
| class |
string |
- |
否 |
组件的样式类,用于引用样式表。 |
| ref |
string |
- |
否 |
用来指定指向子元素或子组件的引用信息,该引用将注册到父组件的$refs 属性对象上。 |
| disabled |
boolean |
false |
否 |
当前组件是否被禁用,在禁用场景下,组件将无法响应用户交互。 |
| focusable |
boolean |
false |
否 |
当前组件是否可以获取焦点。 当focusable设置为true时,组件可以响应焦点事件和按键事件。 |
| data |
string |
- |
否 |
给当前组件设置data属性,进行相应的数据存储和读取。 |
事件
| 名称 |
参数 |
描述 |
|---|---|---|
| touchstart |
手指刚触摸屏幕时触发该事件。 |
|
| touchmove |
手指触摸屏幕后移动时触发该事件。 |
|
| touchcancel |
手指触摸屏幕中动作被打断时触发该事件。 |
|
| touchend |
手指触摸结束离开屏幕时触发该事件。 |
|
| click |
- |
点击动作触发该事件。 |
| longpress |
- |

本文档详细介绍了智慧屏和智能穿戴设备开发中基础的按钮组件,包括各种类型的按钮如胶囊、圆形、文本和弧形按钮,以及它们的权限需求、属性设置、事件响应、样式调整和方法调用。特别地,当type设定为特定值时,按钮的样式和功能会有所变化,例如type='download'时,按钮支持特定的方法操作。
最低0.47元/天 解锁文章
5万+

被折叠的 条评论
为什么被折叠?



