鸿蒙5.0开发进阶：API ArkUI框架-ArkTS组件（边框设置）

往期鸿蒙全套实战文章必看：（文中附带全栈鸿蒙学习资料）

• 鸿蒙开发核心知识点，看这篇文章就够了

• 最新版！鸿蒙HarmonyOS Next应用开发实战学习路线

• 鸿蒙HarmonyOS NEXT开发技术最全学习路线指南

• 鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）

---

边框设置

设置组件边框样式。

说明

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

border

border(value: BorderOptions)

设置边框样式。

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

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

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

参数：

参数名	类型	必填	说明
value	BorderOptions	是	统一边框样式设置接口。 说明： 边框宽度默认值为0，即不显示边框。 从API Version 9开始，父节点的border显示在子节点内容之上。

borderStyle

borderStyle(value: BorderStyle | EdgeStyles)

设置元素的边框线条样式。

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

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

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

参数：

参数名	类型	必填	说明
value	BorderStyle | EdgeStyles9+	是	设置元素的边框样式。 默认值：BorderStyle.Solid

borderWidth

borderWidth(value: Length | EdgeWidths | LocalizedEdgeWidths)

设置边框的宽度。

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

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

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

参数：

参数名	类型	必填	说明
value	Length | EdgeWidths9+ | LocalizedEdgeWidths12+	是	设置元素的边框宽度，不支持百分比。

borderColor

borderColor(value: ResourceColor | EdgeColors | LocalizedEdgeColors)

设置边框的颜色。

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

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

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

参数：

参数名	类型	必填	说明
value	ResourceColor | EdgeColors9+ |