圖片邊框設置

設置容器組件的圖片邊框樣式。

說明：
開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
從API Version 9開始支持。后續版本如有新增內容，則采用上角標單獨標記該內容的起始版本。

屬性

名稱	參數類型	描述
borderImage	[BorderImageOption]	圖片邊框或者漸變色邊框設置接口。該接口支持在ArkTS卡片中使用。

BorderImageOption對象說明

該接口支持在ArkTS卡片中使用。

名稱	類型	描述
source	string	[Resource]
slice	[Length]	[EdgeWidths]
width	[Length]	[EdgeWidths]
outset	[Length]	[EdgeWidths]
repeat	[RepeatMode]	設置被切割的圖片在邊框上的重復方式。默認值：RepeatMode.Stretch
fill	boolean	設置邊框圖片中心填充。默認值：false

RepeatMode枚舉說明

該接口支持在ArkTS卡片中使用。

名稱	描述
Repeat	被切割圖片重復鋪平在圖片邊框上，超出的部分會被剪裁。
Stretch	被切割圖片以拉伸填充的方式鋪滿圖片邊框。
Round	被切割圖片以整數次平鋪在圖片邊框上，無法以整數次平鋪時壓縮被切割圖片。
Space	被切割圖片以整數次平鋪在圖片邊框上，無法以整數次平鋪時以空白填充。

示例

示例1

// xxx.ets
@Entry
@Component
struct Index {
  build() {
    Row() {
      Column() {
        Text('This is gradient color.').textAlign(TextAlign.Center).height(50).width(200)
          .borderImage({
            source: {
              angle: 90,
              direction: GradientDirection.Left,
              colors: [[0xAEE1E1, 0.0], [0xD3E0DC, 0.3], [0xFCD1D1, 1.0]]
            },
            slice: { top: 10, bottom: 10, left: 10, right: 10 },
            width: { top: "10px", bottom: "10px", left: "10px", right: "10px" },
            repeat: RepeatMode.Stretch,
            fill: false
          })
      }
      .width('100%')
    }
    .height('100%')
  }
}

zh-cn_image_borderImageGradient

示例2

鴻蒙文檔.png

`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`

// xxx.ets
@Entry
@Component
struct BorderImage {
  @State WidthValue: number = 0
  @State SliceValue: number = 0
  @State OutSetValue: number = 0
  @State RepeatValue: RepeatMode[] = [RepeatMode.Repeat, RepeatMode.Stretch, RepeatMode.Round, RepeatMode.Space]
  @State SelectIndex: number = 0
  @State SelectText: string = 'Repeat'
  @State FillValue: boolean = false

  build() {
    Row() {
      Column({ space: 20 }) {
        Row() {
          Text('This is borderImage.').textAlign(TextAlign.Center).fontSize(50)
        }
        .borderImage({
          source: $r('app.media.icon'),
          slice: this.SliceValue,
          width: this.WidthValue,
          outset: this.OutSetValue,
          repeat: this.RepeatValue[this.SelectIndex],
          fill: this.FillValue
        })

        Column() {
          Text(`borderImageSlice = ${this.SliceValue}px`)
          Slider({
            value: this.SliceValue,
            min: 0,
            max: 100,
            style: SliderStyle.OutSet
          })
            .onChange((value: number, mode: SliderChangeMode) = > {
              this.SliceValue = value
            })
        }

        Column() {
          Text(`borderImageWidth = ${this.WidthValue}px`)
          Slider({
            value: this.WidthValue,
            min: 0,
            max: 100,
            style: SliderStyle.OutSet
          })
            .onChange((value: number, mode: SliderChangeMode) = > {
              this.WidthValue = value
            })
        }

        Column() {
          Text(`borderImageOutSet = ${this.OutSetValue}px`)
          Slider({
            value: this.OutSetValue,
            min: 0,
            max: 100,
            style: SliderStyle.OutSet
          })
            .onChange((value: number, mode: SliderChangeMode) = > {
              this.OutSetValue = value
            })
        }

        Row() {
          Text('borderImageRepeat: ')
          Select([{ value: 'Repeat' }, { value: 'Stretch' }, { value: 'Round' }, { value: 'Space' }])
            .value(this.SelectText)
            .selected(this.SelectIndex)
            .onSelect((index: number, value?: string) = > {
              this.SelectIndex = index
              this.SelectText = value as string
            })
        }

        Row() {
          Text(`borderImageFill: ${this.FillValue} `)
          Toggle({ type: ToggleType.Switch, isOn: this.FillValue })
            .onChange((isOn: boolean) = > {
              this.FillValue = isOn
            })
        }

      }
      .width('100%')
    }
    .height('100%')
  }
}