【鸿蒙HarmonyOS开发笔记】常用组件介绍篇 —— Button按钮组件

概述

Button为按钮组件,通常用于响应用户的点击操作。

参数

Button组件有两种使用方式,分别是不包含子组件和包含子组件,两种方式下,Button 组件所需的参数有所不同,下面分别介绍


不包含子组件

不包含子组件时,Button组件所需的参数如下

typescript 复制代码
Button(label?: string, options?: { type?: ButtonType, stateEffect?: boolean })

label:
label为按钮上显示的文字内容。


options.type:
options.type为按钮形状,该属性的类型ButtonType,可选的枚举值有

ButtonType.Capsule: 胶囊形状
ButtonType.Circle: 圆形
ButtonType.Normal : 普通形状


options.stateEffect:
options.stateEffect表示是否开启点击效果,点击效果如下

包含子组件

子组件会作为按钮上显示的内容,可以是图片、文字等。这种方式下,Button组件就不在需要label参数了,具体如下

typescript 复制代码
Button(options?: {type?: ButtonType, stateEffect?: boolean})

常用属性

背景颜色

按钮的颜色可使用backgroundColor()方法进行设置,例如

typescript 复制代码
Button('绿色按钮').backgroundColor(Color.Green)

边框圆角

按钮的边框圆角大小可使用borderRadius()方法进行设置,例如

typescript 复制代码
Button('圆角按钮', { type: ButtonType.Normal }).borderRadius(10)

常用事件

对于Button组件而言,最为常用的就是点击事件,可以通过onClick()方法为按钮绑定点击事件,该方法的参数为一个回调函数,当按钮被点击时,就会触发该回调函数,例如

typescript 复制代码
Button('点击事件').onClick(() => {
  console.log('我被点击了')
})
相关推荐
国医中兴10 分钟前
Flutter 三方库 superclass 的鸿蒙化适配指南 - 支持原生高性能类构造、属性代理与深层元数据解析实战
flutter·harmonyos·鸿蒙·openharmony
蒸蒸yyyyzwd25 分钟前
设计模式之美学习笔记
笔记·学习·设计模式
勇气要爆发26 分钟前
吴恩达《LangChain LLM 应用开发精读笔记》8-Document Loading 文档加载
笔记·langchain·dreamweaver
Swift社区26 分钟前
Flutter 迁移鸿蒙 ArkUI 的真实成本
flutter·华为·harmonyos
中屹指纹浏览器38 分钟前
2026年设备指纹追踪与浏览器虚拟环境技术深度解析——从风控原理到安全隔离实践
经验分享·笔记
互联网散修41 分钟前
零基础鸿蒙应用开发第七节:流程控制之分支语句
harmonyos·流程控制·鸿蒙零基础入门
星轨初途43 分钟前
郑州轻工业大学“筑梯杯” 2025级新生程序设计大赛暨省内高校邀请赛——题解
android·c++·经验分享·笔记·算法
资深流水灯工程师1 小时前
BMI270应用笔记1:BMI270结构体详解
笔记
casual_clover1 小时前
关于 HarmonyOS 版本的简述
harmonyos·版本信息
GitCode官方1 小时前
AtomGit 携手开源鸿蒙,推动智能终端操作系统生态繁荣
华为·开源·harmonyos·atomgit