Button是按钮组件,通常用于响应用户的点击操作,其类型包括胶囊按钮、圆形按钮、普通按钮。Button做为容器使用时可以通过添加子组件实现包含文字、图片等元素的按钮。具体用法请参考Button。
创建按钮
Button通过调用接口来创建,接口调用有以下两种形式:
- 创建不包含子组件的按钮。
Button(label?: ResourceStr, options?: { type?: ButtonType, stateEffect?: boolean })
其中,label用来设置按钮文字,type用于设置Button类型,stateEffect属性设置Button是否开启点击效果。
Button('确定', {
// 按钮类型
type: ButtonType.Normal,
// 点击效果
stateEffect: true
})
- 创建包含子组件的按钮。
Button(options?: {type?: ButtonType, stateEffect?: boolean})
Button({ type: ButtonType.Normal, stateEffect: true }) {
Row() {
Image($r('app.media.startIcon')).width(20).height(40).margin({ left: 12 })
Text('loading').fontSize(12).fontColor(0xffffff).margin({ left: 5, right: 12 })
}.alignItems(VerticalAlign.Center)
}.borderRadius(8).backgroundColor(0x317aff).width(90).height(40)
设置按钮类型
Button有三种可选类型,分别为胶囊类型(Capsule)、圆形按钮(Circle)和普通按钮(Normal),通过type进行设置。
- 胶囊按钮(默认类型)
此类型按钮的圆角自动设置为高度的一半,不支持通过borderRadius属性重新设置圆角。
Button('确定', {type: ButtonType.Capsule})
- 圆形按钮
此类型按钮为圆形,不支持通过borderRadius属性重新设置圆角。
Button('确定', {type: ButtonType.Circle})
- 普通按钮
此类型的按钮默认圆角为0,支持通过borderRadius属性重新设置圆角。
Button('确定', {type: ButtonType.Normal})
自定义样式
- 设置边框弧度。
使用通用属性来自定义按钮样式。例如通过borderRadius属性设置按钮的边框弧度。
Button('确定', {type: ButtonType.Normal})
.borderRadius(20)
- 设置文本样式。
通过添加文本样式设置按钮文本的展示样式。
Button('确定', {type: ButtonType.Normal})
.borderRadius(20)
.fontSize(20)
.fontColor(Color.Red)
.fontWeight(800)
- 设置背景颜色。
添加backgroundColor属性设置按钮的背景颜色。
Button('确定').backgroundColor(Color.Red)
- 创建功能型按钮。
为删除操作创建一个按钮。
添加事件
Button组件通常用于触发某些操作,可以绑定onClick事件来响应点击操作后的自定义行为。
Button('点击按钮').onClick(()=>{
console.log('按钮被点击');
})