圖片邊框設(shè)置
設(shè)置容器組件的圖片邊框樣式。
說明:
開發(fā)前請(qǐng)熟悉鴻蒙開發(fā)指導(dǎo)文檔 :[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
]
從API Version 9開始支持。后續(xù)版本如有新增內(nèi)容,則采用上角標(biāo)單獨(dú)標(biāo)記該內(nèi)容的起始版本。
屬性
名稱 | 參數(shù)類型 | 描述 |
---|---|---|
borderImage | [BorderImageOption] | 圖片邊框或者漸變色邊框設(shè)置接口。 該接口支持在ArkTS卡片中使用。 |
BorderImageOption對(duì)象說明
該接口支持在ArkTS卡片中使用。
名稱 | 類型 | 描述 |
---|---|---|
source | string | [Resource] |
slice | [Length] | [EdgeWidths] |
width | [Length] | [EdgeWidths] |
outset | [Length] | [EdgeWidths] |
repeat | [RepeatMode] | 設(shè)置被切割的圖片在邊框上的重復(fù)方式。 默認(rèn)值:RepeatMode.Stretch |
fill | boolean | 設(shè)置邊框圖片中心填充。 默認(rèn)值:false |
RepeatMode枚舉說明
該接口支持在ArkTS卡片中使用。
名稱 | 描述 |
---|---|
Repeat | 被切割圖片重復(fù)鋪平在圖片邊框上,超出的部分會(huì)被剪裁。 |
Stretch | 被切割圖片以拉伸填充的方式鋪滿圖片邊框。 |
Round | 被切割圖片以整數(shù)次平鋪在圖片邊框上,無法以整數(shù)次平鋪時(shí)壓縮被切割圖片。 |
Space | 被切割圖片以整數(shù)次平鋪在圖片邊框上,無法以整數(shù)次平鋪時(shí)以空白填充。 |
示例
示例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%')
}
}
示例2
`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%')
}
}
審核編輯 黃宇
-
接口
+關(guān)注
關(guān)注
33文章
8885瀏覽量
152973 -
鴻蒙
+關(guān)注
關(guān)注
57文章
2469瀏覽量
43642
發(fā)布評(píng)論請(qǐng)先 登錄
相關(guān)推薦
HarmonyOS/OpenHarmony應(yīng)用開發(fā)-ArkTS的聲明式開發(fā)范式
鴻蒙ArkTS聲明式開發(fā):跨平臺(tái)支持列表【按鍵事件】

鴻蒙ArkTS聲明式開發(fā):跨平臺(tái)支持列表【邊框設(shè)置】 通用屬性

鴻蒙ArkTS聲明式開發(fā):跨平臺(tái)支持列表【背景設(shè)置】 通用屬性

鴻蒙ArkTS聲明式開發(fā):跨平臺(tái)支持列表【透明度設(shè)置】 通用屬性

鴻蒙ArkTS聲明式開發(fā):跨平臺(tái)支持列表【顯隱控制】 通用屬性

鴻蒙ArkTS聲明式開發(fā):跨平臺(tái)支持列表【形狀裁剪】 通用屬性

鴻蒙ArkTS聲明式開發(fā):跨平臺(tái)支持列表【柵格設(shè)置】 通用屬性

鴻蒙ArkTS聲明式開發(fā):跨平臺(tái)支持列表【菜單控制】 通用屬性

鴻蒙ArkTS聲明式開發(fā):跨平臺(tái)支持列表【多態(tài)樣式】 通用屬性

評(píng)論