相对布局（RelativeContainer）
目录
1、概述
2、基本概念
3、设置依赖关系
3.1、锚点设置
3.2、设置相对于锚点的对齐位置
3.2.1 HorizontalAlign.Start
3.2.2 HorizontalAlign.Center
3.2.3 HorizontalAlign.End
3.2.4 VerticalAlign.Top
3.2.5 VerticalAlign.Center
3.2.6 VerticalAlign.Bottom
4、场景实例
1、概述
RelativeContainer为采用相对布局的容器，支持容器内部的子元素设置相对位置关系。子元素支持指定兄弟元素作为锚点，也支持指定父容器作为锚点，基于锚点做相对位置布局。下图是一个RelativeContainer的概念图，图中的虚线表示位置的依赖关系。
图1 相对布局示意图
子元素并不完全是上图中的依赖关系。比如，Item4可以以Item2为依赖锚点，也可以以RelativeContainer父容器为依赖锚点。
2、基本概念
- 锚点：通过锚点设置当前元素基于哪个元素确定位置。
- 对齐方式：通过对齐方式，设置当前元素是基于锚点的上中下对齐，还是基于锚点的左中右对齐。
3、设置依赖关系
3.1、锚点设置
锚点设置是指设置子元素相对于父元素或兄弟元素的位置依赖关系。在水平方向上，可以设置left、middle、right的锚点。在竖直方向上，可以设置top、center、bottom的锚点。为了明确定义锚点，必须为RelativeContainer及其子元素设置ID，用于指定锚点信息。ID默认为“__container__”，其余子元素的ID通过id属性设置。未设置ID的子元素在RelativeContainer中不会显示。
说明
在使用锚点时要注意子元素的相对位置关系，避免出现错位或遮挡的情况。
- RelativeContainer父组件为锚点，__container__代表父容器的id。
@Entry
@Component
struct RelativeContainerPage {
@State message: string = 'Hello World'
build() {
Row() {
RelativeContainerView()
}
.height('100%')
}
}
@Component
struct RelativeContainerView {
build() {
RelativeContainer() {
Row()
.alignRules({
top: { anchor: '__container__', align: VerticalAlign.Top },
left: { anchor: '__container__', align: HorizontalAlign.Start }
}).width('20%').height(100)
.id("row1").backgroundColor("#ff0000")
Row()
.alignRules({
top: { anchor: '__container__', align: VerticalAlign.Top },
right: {anchor: '__container__', align: HorizontalAlign.End}
}).width('20%').height(100)
.id("row2").backgroundColor("#ffcc00")
}.width('100%').height('100%')
}
}
- 以子元素为锚点。
@Entry
@Component
struct RelativeContainerPage {
@State message: string = 'Hello World'
build() {
Row() {
RelativeContainerView()
}
.height('100%')
}
}
@Component
struct RelativeContainerView {
build() {
RelativeContainer() {
Row()
.alignRules({
top: { anchor: '__container__', align: VerticalAlign.Top },
left: { anchor: '__container__', align: HorizontalAlign.Start }
}).width('20%').height(100)
.id("row1").backgroundColor("#ff0000")
Row()
.alignRules({
top: { anchor: 'row1', align: VerticalAlign.Top },
left: {anchor: 'row1', align: HorizontalAlign.End}
}).width('20%').height(100)
.margin({
top: 12,
left: 12
})
.id("row2").backgroundColor("#ffcc00")
}.width('100%').height('100%')
}
}
3.2、设置相对于锚点的对齐位置
设置了锚点之后，可以通过align设置相对于锚点的对齐位置。
在水平方向上，对齐位置可以设置为HorizontalAlign.Start、HorizontalAlign.Center、HorizontalAlign.End。
3.2.1 HorizontalAlign.Start
@Entry
@Component
struct RelativeContainerPage {
@State message: string = 'Hello World'
build() {
Row() {
RelativeContainerView()
}
.height('100%')
}
}
@Component
struct RelativeContainerView {
build() {
RelativeContainer() {
Text('Anchor')
.backgroundColor('#aa67c8ff')
.id('anchor')
.width('40%')
.textAlign(TextAlign.Center)
.alignRules({
center: { anchor: '__container__', align: VerticalAlign.Center},
middle: {anchor: '__container__', align: HorizontalAlign.Center}
})
Column()
.alignRules({
left: {anchor: 'anchor', align: HorizontalAlign.Start}
})
.width(12)
.height('100%')
.backgroundColor('#80ff0000').id('vLine')
}
.width('100%')
.height('20%')
.backgroundColor('#999')
.alignSelf(ItemAlign.Start)
}
}
3.2.2 HorizontalAlign.Center
@Entry
@Component
struct RelativeContainerPage {
@State message: string = 'Hello World'
build() {
Row() {
RelativeContainerView()
}
.height('100%')
}
}
@Component
struct RelativeContainerView {
build() {
RelativeContainer() {
Text('Anchor')
.backgroundColor('#aa67c8ff')
.id('anchor')
.width('40%')
.textAlign(TextAlign.Center)
.alignRules({
center: { anchor: '__container__', align: VerticalAlign.Center},
middle: {anchor: '__container__', align: HorizontalAlign.Center}
})
Column()
.alignRules({
middle: {anchor: 'anchor', align: HorizontalAlign.Center}
})
.width(12)
.height('100%')
.backgroundColor('#80ff0000').id('vLine')
}
.width('100%')
.height('20%')
.backgroundColor('#999')
.alignSelf(ItemAlign.Start)
}
}
3.2.3 HorizontalAlign.End
@Entry
@Component
struct RelativeContainerPage {
@State message: string = 'Hello World'
build() {
Row() {
RelativeContainerView()
}
.height('100%')
}
}
@Component
struct RelativeContainerView {
build() {
RelativeContainer() {
Text('Anchor')
.backgroundColor('#aa67c8ff')
.id('anchor')
.width('40%')
.textAlign(TextAlign.Center)
.alignRules({
center: { anchor: '__container__', align: VerticalAlign.Center},
middle: {anchor: '__container__', align: HorizontalAlign.Center}
})
Column()
.alignRules({
right: {anchor: 'anchor', align: HorizontalAlign.End}
})
.width(12)
.height('100%')
.backgroundColor('#80ff0000').id('vLine')
}
.width('100%')
.height('20%')
.backgroundColor('#999')
.alignSelf(ItemAlign.Start)
}
}
在竖直方向上，对齐位置可以设置为VerticalAlign.Top、VerticalAlign.Center、VerticalAlign.Bottom。
3.2.4 VerticalAlign.Top
@Entry
@Component
struct RelativeContainerPage {
@State message: string = 'Hello World'
build() {
Row() {
RelativeContainerView()
}
.height('100%')
}
}
@Component
struct RelativeContainerView {
build() {
RelativeContainer() {
Text('Anchor')
.backgroundColor('#aa67c8ff')
.id('anchor')
.width('40%')
.textAlign(TextAlign.Center)
.height(48)
.alignRules({
center: { anchor: '__container__', align: VerticalAlign.Center },
middle: { anchor: '__container__', align: HorizontalAlign.Center }
})
Column()
.alignRules({
top: { anchor: 'anchor', align: VerticalAlign.Top }
})
.width('100%')
.height(12)
.backgroundColor('#80ff0000')
.id('vLine')
}
.width('100%')
.height('20%')
.backgroundColor('#999')
.alignSelf(ItemAlign.Start)
}
}
3.2.5 VerticalAlign.Center
@Entry
@Component
struct RelativeContainerPage {
@State message: string = 'Hello World'
build() {
Row() {
RelativeContainerView()
}
.height('100%')
}
}
@Component
struct RelativeContainerView {
build() {
RelativeContainer() {
Text('Anchor')
.backgroundColor('#aa67c8ff')
.id('anchor')
.width('40%')
.textAlign(TextAlign.Center)
.height(48)
.alignRules({
center: { anchor: '__container__', align: VerticalAlign.Center },
middle: { anchor: '__container__', align: HorizontalAlign.Center }
})
Column()
.alignRules({
center: { anchor: 'anchor', align: VerticalAlign.Center }
})
.width('100%')
.height(12)
.backgroundColor('#80ff0000')
.id('vLine')
}
.width('100%')
.height('20%')
.backgroundColor('#999')
.alignSelf(ItemAlign.Start)
}
}
3.2.6 VerticalAlign.Bottom
@Entry
@Component
struct RelativeContainerPage {
@State message: string = 'Hello World'
build() {
Row() {
RelativeContainerView()
}
.height('100%')
}
}
@Component
struct RelativeContainerView {
build() {
RelativeContainer() {
Text('Anchor')
.backgroundColor('#aa67c8ff')
.id('anchor')
.width('40%')
.textAlign(TextAlign.Center)
.height(48)
.alignRules({
center: { anchor: '__container__', align: VerticalAlign.Center },
middle: { anchor: '__container__', align: HorizontalAlign.Center }
})
Column()
.alignRules({
bottom: { anchor: 'anchor', align: VerticalAlign.Bottom }
})
.width('100%')
.height(12)
.backgroundColor('#80ff0000')
.id('vLine')
}
.width('100%')
.height('20%')
.backgroundColor('#999')
.alignSelf(ItemAlign.Start)
}
}
4、场景实例
相对布局内的子元素相对灵活，只要在RelativeContainer容器内，均可以通过alignRules进行相应的位置移动。
@Entry
@Component
struct RelativeLayoutSample {
build() {
Column() {
RelativeContainer() {
Row()
.width(100)
.height(100)
.backgroundColor('#FF3333')
.alignRules({
top: { anchor: '__container__', align: VerticalAlign.Top }, //以父容器为锚点，竖直方向顶头对齐
middle: { anchor: '__container__', align: HorizontalAlign.Center } //以父容器为锚点，水平方向居中对齐
})
.id('row1') //设置锚点为row1
Row() {
Image($r('app.media.icon'))
}
.height(100).width(100)
.alignRules({
top: { anchor: 'row1', align: VerticalAlign.Bottom }, //以row1组件为锚点，竖直方向低端对齐
left: { anchor: 'row1', align: HorizontalAlign.Start } //以row1组件为锚点，水平方向开头对齐
})
.id('row2') //设置锚点为row2
Row()
.width(100)
.height(100)
.backgroundColor('#FFCC00')
.alignRules({
top: { anchor: 'row2', align: VerticalAlign.Top }
})
.id('row3') //设置锚点为row3
Row()
.width(100)
.height(100)
.backgroundColor('#FF9966')
.alignRules({
top: { anchor: 'row2', align: VerticalAlign.Top },
left: { anchor: 'row2', align: HorizontalAlign.End },
})
.id('row4') //设置锚点为row4
Row()
.width(100)
.height(100)
.backgroundColor('#FF66FF')
.alignRules({
top: { anchor: 'row2', align: VerticalAlign.Bottom },
middle: { anchor: 'row2', align: HorizontalAlign.Center }
})
.id('row5') //设置锚点为row5
}
.width(300).height(300)
.backgroundColor("#67c8ff")
.border({ width: 2, color: '#6699FF' })
}
.justifyContent(FlexAlign.Start)
.height('100%').width('100%').margin({ left: 0, right: 0 })
}
}