鸿蒙Harmony应用开发—ArkTS声明式开发（通用属性：背景设置）

最新推荐文章于 2025-03-24 13:54:32 发布

代码与思维

最新推荐文章于 2025-03-24 13:54:32 发布

阅读量9.3k

点赞数 30

分类专栏：鸿蒙鸿蒙-ArkTS 文章标签： harmonyos 华为 android 鸿蒙鸿蒙系统 ArkTS ArkUI

本文链接：https://blog.csdn.net/m0_64420071/article/details/136400300

版权

本文详细介绍了鸿蒙HarmonyOS中组件的背景样式设置，包括背景色、背景图片、模糊效果、提亮效果以及各种相关参数。同时提到了与之相关的系统能力和使用示例，对于鸿蒙开发者理解和使用这些功能具有指导意义。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

设置组件的背景样式。

说明：

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

background(builder: CustomBuilder, options?: { align?: Alignment })

设置组件背景。

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

参数：

参数名	类型	必填	说明
builder	CustomBuilder	是	自定义背景。
options	{align?:Alignment}	否	设置自定义背景与组件的对齐方式。同时设置了background，backgroundColor，backgroundImage时，叠加显示，background在最上层。

说明：

自定义背景渲染会有一定延迟，不能响应事件，不能进行动态更新。该属性不支持嵌套使用，不支持预览器预览。

backgroundColor(value: ResourceColor)

设置组件背景色。

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

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

参数：

参数名	类型	必填	说明
value	ResourceColor	是	设置组件的背景色。

backgroundImage(src: ResourceStr, repeat?: ImageRepeat)

设置组件的背景图片。

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

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

参数：

参数名	类型	必填	说明
src	ResourceStr	是	图片地址，支持网络图片资源地址和本地图片资源地址和Base64，不支持svg类型的图片。
repeat	ImageRepeat	否	设置背景图片的重复样式，默认不重复。当设置的背景图片为透明底色图片，且同时设置了backgroundColor时，二者叠加显示，背景颜色在最底部。

backgroundImageSize(value: SizeOptions | ImageSize)

设置组件背景图片的宽高。

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

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

参数：

参数名	类型	必填	说明
value	SizeOptions \| ImageSize	是	设置背景图像的高度和宽度。当输入为{width: Length, height: Length}对象时，如果只设置一个属性，则第二个属性保持图片原始宽高比进行调整。默认保持原图的比例不变。 width和height取值范围