Badge
可以附加在單個組件上用于信息標記的容器組件。
說明:
該組件從API Version 7開始支持。后續(xù)版本如有新增內(nèi)容,則采用上角標單獨標記該內(nèi)容的起始版本。
子組件
支持單個子組件。
說明:
開發(fā)前請熟悉鴻蒙開發(fā)指導文檔 :[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
]
子組件類型:系統(tǒng)組件和自定義組件,支持渲染控制類型([if/else]、[ForEach]和[LazyForEach])。
接口
Badge
Badge(value: {count: number, position?: BadgePosition | Position, maxCount?: number, style: BadgeStyle})
創(chuàng)建數(shù)字標記組件。
從API version 9開始,該接口支持在ArkTS卡片中使用。
參數(shù)名 | 參數(shù)類型 | 必填 | 參數(shù)描述 |
---|---|---|---|
count | number | 是 | 設置提醒消息數(shù)。**說明:**小于等于0時不顯示信息標記。 取值范圍:[-2147483648,2147483647],非整數(shù)時會舍去小數(shù)部分取整數(shù)部分,如5.5取5。 |
position | [BadgePosition] | [Position10+] | 否 |
maxCount | number | 否 | 最大消息數(shù),超過最大消息時僅顯示maxCount+。 默認值:99 取值范圍:[-2147483648,2147483647],非整數(shù)時會舍去小數(shù)部分取整數(shù)部分,如5.5取5。 |
style | [BadgeStyle] | 是 | Badge組件可設置樣式,支持設置文本顏色、尺寸、圓點顏色和尺寸。 |
Badge
Badge(value: {value: string, position?: BadgePosition | Position, style: BadgeStyle})
根據(jù)字符串創(chuàng)建標記組件。
從API version 9開始,該接口支持在ArkTS卡片中使用。
參數(shù):
參數(shù)名 | 參數(shù)類型 | 必填 | 默認值 | 參數(shù)描述 |
---|---|---|---|---|
value | string | 是 | - | 提示內(nèi)容的文本字符串。 |
position | [BadgePosition] | [Position10+] | 否 | BadgePosition.RightTop |
style | [BadgeStyle] | 是 | - | Badge組件可設置樣式,支持設置文本顏色、尺寸、圓點顏色和尺寸。 |
BadgePosition枚舉說明
從API version 9開始,該接口支持在ArkTS卡片中使用。
名稱 | 描述 |
---|---|
RightTop | 圓點顯示在右上角。 |
Right | 圓點顯示在右側(cè)縱向居中。 |
Left | 圓點顯示在左側(cè)縱向居中。 |
BadgeStyle對象說明
從API version 9開始,該接口支持在ArkTS卡片中使用。
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
color | [ResourceColor] | 否 | 文本顏色。 默認值:Color.White |
fontSize | number | string | 否 |
badgeSize | number | string | 否 |
badgeColor | [ResourceColor] | 否 | Badge的顏色。 默認值:Color.Red |
fontWeight10+ | number | [FontWeight] | string |
borderColor10+ | [ResourceColor] | 否 | 底板描邊顏色。 |
borderWidth10+ | [Length] | 否 | 底板描邊粗細。 默認值:1 單位:vp**說明:**不支持設置百分比。HarmonyOS與OpenHarmony鴻蒙文檔籽料:mau123789是v直接拿 |
屬性
支持[通用屬性]
事件
支持[通用事件]
示例
// xxx.ets
@Entry
@Component
struct BadgeExample {
@Builder TabBuilder(index: number) {
Column() {
if (index === 2) {
Badge({
value: '',
style: { badgeSize: 6, badgeColor: '#FA2A2D' }
}) {
Image('/common/public_icon_off.svg')
.width(24)
.height(24)
}
.width(24)
.height(24)
.margin({ bottom: 4 })
} else {
Image('/common/public_icon_off.svg')
.width(24)
.height(24)
.margin({ bottom: 4 })
}
Text('Tab')
.fontColor('#182431')
.fontSize(10)
.fontWeight(500)
.lineHeight(14)
}.width('100%').height('100%').justifyContent(FlexAlign.Center)
}
@Builder itemBuilder(value: string) {
Row() {
Image('common/public_icon.svg').width(32).height(32).opacity(0.6)
Text(value)
.width(177)
.height(21)
.margin({ left: 15, right: 76 })
.textAlign(TextAlign.Start)
.fontColor('#182431')
.fontWeight(500)
.fontSize(16)
.opacity(0.9)
Image('common/public_icon_arrow_right.svg').width(12).height(24).opacity(0.6)
}.width('100%').padding({ left: 12, right: 12 }).height(56)
}
build() {
Column() {
Text('dotsBadge').fontSize(18).fontColor('#182431').fontWeight(500).margin(24)
Tabs() {
TabContent()
.tabBar(this.TabBuilder(0))
TabContent()
.tabBar(this.TabBuilder(1))
TabContent()
.tabBar(this.TabBuilder(2))
TabContent()
.tabBar(this.TabBuilder(3))
}
.width(360)
.height(56)
.backgroundColor('#F1F3F5')
Column() {
Text('stringBadge').fontSize(18).fontColor('#182431').fontWeight(500).margin(24)
List({ space: 12 }) {
ListItem() {
Text('list1').fontSize(14).fontColor('#182431').margin({ left: 12 })
}
.width('100%')
.height(56)
.backgroundColor('#FFFFFF')
.borderRadius(24)
.align(Alignment.Start)
ListItem() {
Badge({
value: 'New',
position: BadgePosition.Right,
style: { badgeSize: 16, badgeColor: '#FA2A2D' }
}) {
Text('list2').width(27).height(19).fontSize(14).fontColor('#182431')
}.width(49.5).height(19)
.margin({ left: 12 })
}
.width('100%')
.height(56)
.backgroundColor('#FFFFFF')
.borderRadius(24)
.align(Alignment.Start)
}.width(336)
Text('numberBadge').fontSize(18).fontColor('#182431').fontWeight(500).margin(24)
List() {
ListItem() {
this.itemBuilder('list1')
}
ListItem() {
Row() {
Image('common/public_icon.svg').width(32).height(32).opacity(0.6)
Badge({
count: 1,
position: BadgePosition.Right,
style: { badgeSize: 16, badgeColor: '#FA2A2D' }
}) {
Text('list2')
.width(177)
.height(21)
.textAlign(TextAlign.Start)
.fontColor('#182431')
.fontWeight(500)
.fontSize(16)
.opacity(0.9)
}.width(240).height(21).margin({ left: 15, right: 11 })
Image('common/public_icon_arrow_right.svg').width(12).height(24).opacity(0.6)
}.width('100%').padding({ left: 12, right: 12 }).height(56)
}
ListItem() {
this.itemBuilder('list3')
}
ListItem() {
this.itemBuilder('list4')
}
}
.width(336)
.height(232)
.backgroundColor('#FFFFFF')
.borderRadius(24)
.padding({ top: 4, bottom: 4 })
.divider({ strokeWidth: 0.5, color: 'rgba(0,0,0,0.1)', startMargin: 60, endMargin: 12 })
}.width('100%').backgroundColor('#F1F3F5').padding({ bottom: 12 })
}.width('100%')
}
}
審核編輯 黃宇
-
組件
+關注
關注
1文章
505瀏覽量
17806 -
鴻蒙
+關注
關注
57文章
2320瀏覽量
42748
發(fā)布評論請先 登錄
相關推薦
評論