鸿蒙HarmonyOS NEXT开发：Button（基础组件）

Button

按钮组件，可快速创建不同样式的按钮。

说明：

该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

子组件

可以包含单个子组件。

接口

Button

Button(options: ButtonOptions)

创建可以包含单个子组件的按钮。

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
options	ButtonOptions	是	配置按钮的显示样式。

Button

Button(label: ResourceStr, options?: ButtonOptions)

使用文本内容创建相应的按钮组件，此时Button无法包含子组件。

文本内容默认单行显示。

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
label	ResourceStr	是	按钮文本内容。
options	ButtonOptions	否	配置按钮的显示样式。

ButtonOptions对象说明

名称	类型	必填	描述
type	ButtonType	否	描述按钮显示样式。 默认值：ButtonType.Capsule 原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。
stateEffect	boolean	否	按钮按下时是否开启按压态显示效果，当设置为false时，按压效果关闭。 默认值：true 说明： 当开启按压态显示效果，开发者设置状态样式时，会基于状态样式设置完成后的背景色再进行颜色叠加。 原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。
buttonStyle11+	ButtonStyleMode	否	描述按钮的样式和重要程度。 默认值：ButtonStyleMode.EMPHASIZED 说明： 按钮重要程度：强调按钮>普通按钮>文字按钮。 原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
controlSize11+	ControlSize	否	描述按钮的尺寸。 默认值：ControlSize.NORMAL 原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。
role12+	ButtonRole	否	描述按钮的角色。 默认值：ButtonRole.NORMAL

属性

除支持通用属性外，还支持以下属性：

type

type(value: ButtonType)

设置Button样式。

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
value	ButtonType	是	Button样式。 默认值：ButtonType.Capsule

fontSize

fontSize(value: Length)

设置文本显示字号。

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
value	Length	是	文本显示字号。 默认值：若controlSize的值为：controlSize.NORMAL，取’16fp’，若controlSize的值为：controlSize.SMALL，取’12fp’

fontColor

fontColor(value: ResourceColor)

设置文本显示颜色。

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
value	ResourceColor	是	文本显示颜色。 默认值：‘#ffffff’

fontWeight

fontWeight(value: number | FontWeight | string)

设置文本的字体粗细。

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数