鸿蒙界面开发（八）：Grid网格布局&Badge角标组件
Badge角标组件
在目标组件的外层包裹一层Badge角标组件
支持位置：右上，左，右
也可以使用绝对定位实现更灵活的角标位置。
Badge({
count:1,//角标数值，角标数值为0时不展示
position:BadgePosition.RightTop,//角标位置，只有三个
style:{//角标样式
fontSize:14,
badgeSize:20,
badgeColor:'#fa2a2d'
}
}){
Image($r('app.media.bg_00'))
.width(100)
}
网格布局——Grid容器
在规则的行列布局中非常常见
ArkUI提供了Grid容器组件和子组件GridItem，用于构建网格布局。
布局与约束
Grid组件为网格容器，其中容器内各条目对应一个GridItem组件
说明：Grid的子组件必须是GridItem组件。
Grid组件根据行列数量与占比属性的设置，可以分为三种布局情况：
-
行、列数量与占比同时设置：Grid只展示固定行列数的元素，其余元素不展示，且Grid不可滚动。（推荐使用该种布局方式）
-
只设置行、列数量与占比中的一个：元素按照设置的方向进行排布，超出的元素可通过滚动的方式展示。
-
行列数量与占比都不设置：元素在布局方向上排布，其行列数由布局方向、单个网格的宽高等多个属性共同决定。超出行列容纳范围的元素不展示，且Grid不可滚动。
设置排列方式
设置行列数量与占比
Grid组件提供了rowsTemplate和columnsTemplate属性用于设置网格布局行列数量与尺寸占比。
rowsTemplate和columnsTemplate属性值是一个由多个空格和’数字+fr’间隔拼接的字符串，fr的个数即网格布局的行或列数，fr前面的数值大小，用于计算该行或列在网格布局宽度上的占比，最终决定该行或列宽度。
Grid() {
...
}
.rowsTemplate('1fr 1fr 1fr')
.columnsTemplate('1fr 2fr 1fr')
说明： 当Grid组件设置了rowsTemplate或columnsTemplate时，Grid的layoutDirection、maxCount、minCount、cellLength属性不生效，属性说明可参考Grid-属性。
设置子组件所占行列数
在Grid组件中，可以通过创建Grid时传入合适的GridLayoutOptions实现单个网格横跨多行或多列的场景，其中，irregularIndexes和onGetIrregularSizeByIndex可对仅设置rowsTemplate或columnsTemplate的Grid使用；onGetRectByIndex可对同时设置rowsTemplate和columnsTemplate的Grid使用。
在网格中，可以通过onGetRectByIndex返回的[rowStart,columnStart,rowSpan,columnSpan]来实现跨行跨列布局，其中rowStart和columnStart属性表示指定当前元素起始行号和起始列号，rowSpan和columnSpan属性表示指定当前元素的占用行数和占用列数。
layoutOptions: GridLayoutOptions = {
regularSize: [1, 1],
onGetRectByIndex: (index: number) => {
if (index == key1) { // key1是“0”按键对应的index
return [5, 0, 1, 2]
} else if (index == key2) { // key2是“=”按键对应的index
return [4, 3, 2, 1]
}
// ...
// 这里需要根据具体布局返回其他item的位置
}
}
Grid(undefined, this.layoutOptions) {
// ...
}
.columnsTemplate('1fr 1fr 1fr 1fr')
.rowsTemplate('2fr 1fr 1fr 1fr 1fr 1fr')
设置主轴方向——layoutDirection
通过layoutDirection设置网格布局的主轴方向，决定子组件的排列方式。此时可以结合minCount和maxCount属性来约束主轴方向上的网格数量。
Grid() { ...}
.maxCount(3)
.layoutDirection(GridDirection.Row)
GridDirection.Row 先从左到右排列，排满一行再排下一行。
GridDirection.Column 先从上到下排列，排满一列再排下一列
说明
layoutDirection属性仅在不设置rowsTemplate和columnsTemplate时生效，此时元素在layoutDirection方向上排列。
仅设置rowsTemplate时，Grid主轴为水平方向，交叉轴为垂直方向。
仅设置columnsTemplate时，Grid主轴为垂直方向，交叉轴为水平方向。
在网格布局中显示数据——GridItem子组件
Grid组件可以通过二维布局的方式显示一组GridItem子组件。
对于内容结构相似的多个GridItem，通常更推荐使用ForEach语句中嵌套GridItem的形式，来减少重复代码。
@Entry
@Component
struct OfficeService {
@State services: Array<string> = ['会议', '投票', '签到', '打印']
build() {
Column() {
Grid() {
ForEach(this.services, (service:string) => {
GridItem() {
Text(service)
}
}, (service:string):string => service)
}
.rowsTemplate(('1fr 1fr') as string)
.columnsTemplate(('1fr 1fr') as string)
}
}
}
设置行列间距
通过Grid的rowsGap和columnsGap可以设置网格布局的行列间距。
单位vp
Grid() {
...
}
.columnsGap(10)//列之间的间距，竖直的列
.rowsGap(15)//行之间的间距
构建可滚动的网格布局
在设置Grid的行列数量与占比时，如果仅设置行、列数量与占比中的一个，即仅设置rowsTemplate或仅设置columnsTemplate属性，网格单元按照设置的方向排列，超出Grid显示区域后，Grid拥有可滚动能力。
如果设置的是columnsTemplate，Grid的滚动方向为垂直方向；如果设置的是rowsTemplate，Grid的滚动方向为水平方向。
控制滚动位置
Grid组件初始化时，可以绑定一个Scroller对象，用于进行滚动控制，例如通过Scroller对象的scrollPage方法进行翻页。
private scroller: Scroller = new Scroller()
应用响应点击事件，通过指定scrollPage方法的参数next为true，滚动到下一页。
Column({ space: 5 }) {
Grid(this.scroller) {
}
.columnsTemplate('1fr 1fr 1fr 1fr 1fr 1fr 1fr')
Row({space: 20}) {
Button('上一页')
.onClick(() => {
this.scroller.scrollPage({
next: false
})
})
Button('下一页')
.onClick(() => {
this.scroller.scrollPage({
next: true
})
})
}
}
性能优化
与长列表的处理类似，循环渲染适用于数据量较小的布局场景，当构建具有大量网格项的可滚动网格布局时，推荐使用数据懒加载方式实现按需迭代加载数据，从而提升列表性能。
Grid组件中也可通过cachedCount属性设置GridItem的预加载数量，只在懒加载LazyForEach中生效。
设置预加载数量后，会在Grid显示区域前后各缓存cachedCount*列数个GridItem，超出显示和缓存范围的GridItem会被释放。
Grid() {
LazyForEach(this.dataSource, () => {
GridItem() {
}
})
}
.cachedCount(3)
说明
cachedCount的增加会增大UI的CPU、内存开销。使用时需要根据实际情况，综合性能和用户体验进行调整。
案例
应用到了：网格布局、ForEach渲染、层叠布局、badge角标、遮罩显影、透明度层级与缩放动画、注册点击事件、随机数、控制展示（换图）、累加、反引号${}拼接字符串的使用
// 定义接口
interface ImageCount{
url: string,//图片地址
count: number//角标数值
}
@Entry
@Component
struct Index {
@State message: string = 'Hello World';
//基于接口，准备数据
@State images: ImageCount[]=[
{url: 'app.media.bg_00',count: 0},
{url: 'app.media.bg_01',count: 0},
{url: 'app.media.bg_02',count: 0},
{url: 'app.media.bg_03',count: 0},
{url: 'app.media.bg_04',count: 0},
{url: 'app.media.bg_05',count: 0},
]
//控制遮罩层
@State maskOpacity: number = 0
@State maskZIndex: number = -1
//控制图片缩放
@State imageW: number = 0
@State imageH: number = 0
//取随机图片
@State randomIndex: number = -1
build() {
Stack(){
Column(){
Grid(){
ForEach(this.images,(item:ImageCount,index:number)=>{
GridItem(){
Badge({
count:item.count,
position:BadgePosition.RightTop,
style:{
fontSize:14,
badgeSize:20,
badgeColor:'#fa2a2d'
}
}){
Image($r(item.url))
.width(80)
}
}
})
}.columnsGap(10)//行间距
.rowsGap(10)
.layoutDirection(GridDirection.Row)
.maxCount(3)//主轴方向子组件存在最多的个数
.rowsTemplate('1fr 1fr')//控制均匀分布，两行x三列
.columnsTemplate('1fr 1fr 1fr')
.width('100%')
.height(300)
// .backgroundColor('#666')
// .border({
// width:2,
// color:Color.Red
// })
.margin({top:100})
.padding(5)
Button('立即抽卡')
.width(200)
.backgroundColor('#ed5b8c')
.margin({top:50})
.onClick(()=>{
this.maskOpacity = 1;
this.maskZIndex = 99;
//点击时图片缩放
this.imageW = 1;
this.imageH = 1;
//生成随机数
this.randomIndex = Math.floor(Math.random() * 6)//取【0，1，2，3，4，5】
})
}
.width('100%')
.height('100%')
//抽卡弹层
Column({space:10}){
Text('获得生肖卡')
.fontColor('#f5ebcf')
.fontSize(25)
.fontWeight(FontWeight.Bold)
Image($r(`app.media.img_0${this.randomIndex}`))
.width(200)
.scale({
x: this.imageW,
y: this.imageH
})
.animation({
duration:500
})
Button('开心收下')
.width(200)
.height(50)
.backgroundColor(Color.Transparent)
.border({
width:2,
color:'#fff9e8'
})
.onClick(()=>{
this.maskOpacity = 0;
this.maskZIndex = -1;
this.imageW = 0;
this.imageH = 0;
//对象数组更新，需要替换整个对象，只修改单个属性，不能更新
this.images[this.randomIndex] = {
url:`app.media.img_0${this.randomIndex}`,
count: this.images[this.randomIndex].count+1
}
})
}.width('100%')
.height('100%')
.backgroundColor('#b3000000')//前两位表示透明度
.justifyContent(FlexAlign.Center)
.opacity(this.maskOpacity)
.zIndex(this.maskZIndex)
.animation({//元素的动画显示
duration:100
})
}
}
}