边框设置

2024-01-22 16:06 更新

设置组件边框样式。

说明

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

从API Version 9开始,父节点的border显示在子节点内容之上。

属性

名称

参数类型

描述

border

{

width?: Length | EdgeWidths9+,

color?: ResourceColor | EdgeColors9+,

radius?: Length | BorderRadiuses9+,

style?: BorderStyle | EdgeStyles9+

}

统一边框样式设置接口。

- width:设置边框宽度。

- color:设置边框颜色。

- radius:设置边框圆角半径。

- style:设置边框样式。

说明:

边框宽度默认值为0,即不显示边框。

borderStyle

BorderStyle | EdgeStyles9+

设置元素的边框样式。

默认值:BorderStyle.Solid

从API version 9开始,该接口支持在ArkTS卡片中使用

,卡片中仅支持设置相同的边框样式。

borderWidth

Length | EdgeWidths9+

设置元素的边框宽度,不支持百分比。

从API version 9开始,该接口支持在ArkTS卡片中使用

,卡片中仅支持设置相同的边框宽度。

borderColor

ResourceColor | EdgeColors9+

设置元素的边框颜色。

默认值:Color.Black

从API version 9开始,该接口支持在ArkTS卡片中使用,卡片中仅支持设置相同的边框颜色。

borderRadius

Length | BorderRadiuses9+

设置元素的边框圆角半径,不支持百分比。

从API version 9开始,该接口支持在ArkTS卡片中使用,卡片中仅支持设置相同的边框圆角半径。

EdgeWidths9+对象说明

引入该对象时,至少传入一个参数。

名称

参数类型

必填

描述

left

Length

左侧边框宽度。

right

Length

右侧边框宽度。

top

Length

上侧边框宽度。

bottom

Length

下侧边框宽度。

EdgeColors9+对象说明

引入该对象时,至少传入一个参数。

名称

参数类型

必填

描述

left

ResourceColor

左侧边框颜色。

right

ResourceColor

右侧边框颜色。

top

ResourceColor

上侧边框颜色。

bottom

ResourceColor

下侧边框颜色。

BorderRadiuses9+对象说明

引用该对象时,至少传入一个参数。

名称

参数类型

必填

描述

topLeft

Length

左上角圆角半径。

topRight

Length

右上角圆角半径。

bottomLeft

Length

左下角圆角半径。

bottomRight

Length

右下角圆角半径。

EdgeStyles9+对象说明

引入该对象时,至少传入一个参数。

名称

参数类型

必填

描述

left

BorderStyle

左侧边框样式。

right

BorderStyle

右侧边框样式。

top

BorderStyle

上侧边框样式。

bottom

BorderStyle

下侧边框样式。

示例

  1. // xxx.ets
  2. @Entry
  3. @Component
  4. struct BorderExample {
  5. build() {
  6. Column() {
  7. Flex({ justifyContent: FlexAlign.SpaceAround, alignItems: ItemAlign.Center }) {
  8. // 线段
  9. Text('dashed')
  10. .borderStyle(BorderStyle.Dashed).borderWidth(5).borderColor(0xAFEEEE).borderRadius(10)
  11. .width(120).height(120).textAlign(TextAlign.Center).fontSize(16)
  12. // 点线
  13. Text('dotted')
  14. .border({ width: 5, color: 0x317AF7, radius: 10, style: BorderStyle.Dotted })
  15. .width(120).height(120).textAlign(TextAlign.Center).fontSize(16)
  16. }.width('100%').height(150)
  17. Text('.border')
  18. .fontSize(50)
  19. .width(300)
  20. .height(300)
  21. .border({
  22. width: { left: '5lpx', right: '10lpx', top: '20lpx', bottom: '30lpx' },
  23. color: { left: '#e3bbbb', right: Color.Blue, top: Color.Red, bottom: Color.Green },
  24. radius: { topLeft: 10, topRight: 20, bottomLeft: 40, bottomRight: 80 },
  25. style: {
  26. left: BorderStyle.Dotted,
  27. right: BorderStyle.Dotted,
  28. top: BorderStyle.Solid,
  29. bottom: BorderStyle.Dashed
  30. }
  31. }).textAlign(TextAlign.Center)
  32. }
  33. }
  34. }

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号