鸿蒙开发---布局-相对布局 (RelativeContainer)的自己理解和解释

 先看官方文档

布局-相对布局 (RelativeContainer)

相对布局 (RelativeContainer)-构建布局-开发布局-UI开发 (ArkTS声明式开发范式)-ArkUI(方舟UI框架)-应用框架 - 华为HarmonyOS开发者

在应用的开发过程中,经常需要设计复杂界面,此时涉及到多个相同或不同组件之间的嵌套。如果布局组件嵌套深度过深,或者嵌套组件数过多,会带来额外的开销。如果在布局的方式上进行优化,就可以有效的提升性能,减少时间开销。

RelativeContainer为采用相对布局的容器,支持容器内部的子元素设置相对位置关系,适用于界面复杂场景的情况,对多个子组件进行对齐和排列。子元素支持指定兄弟元素作为锚点,也支持指定父容器作为锚点,基于锚点做相对位置布局。下图是一个RelativeContainer的概念图,图中的虚线表示位置的依赖关系。

img

子元素并不完全是上图中的依赖关系。比如,Item4可以以Item2为依赖锚点,也可以以RelativeContainer父容器为依赖锚点。

基本概念

  • 锚点:通过锚点设置当前元素基于哪个元素确定位置。

  • 对齐方式:通过对齐方式,设置当前元素是基于锚点的上中下对齐,还是基于锚点的左中右对齐。

相对布局 (RelativeContainer)的使用

通过 .alignRules( )来进行设置锚点设置

锚点设置

锚点设置是指设置子元素相对于父元素或兄弟元素的位置依赖关系。在水平方向上,可以设置left、middle、right的锚点。在竖直方向上,可以设置top、center、bottom的锚点。

为了明确定义锚点,必须为RelativeContainer及其子元素设置ID,用于指定锚点信息。ID默认为“container”,其余子元素的ID通过id属性设置。不设置id的组件能显示,但是不能被其他子组件作为锚点,相对布局容器会为其拼接id,此id的规律无法被应用感知。互相依赖,环形依赖时容器内子组件全部不绘制。同方向上两个以上位置设置锚点,但锚点位置逆序时此子组件大小为0,即不绘制。

RelativeContainer父组件为锚点,container代表父容器的ID。

let AlignRus: Record<string, Record<string, string | VerticalAlign | HorizontalAlign>> = {
  'top': { 'anchor': '__container__', 'align': VerticalAlign.Top },
  'left': { 'anchor': '__container__', 'align': HorizontalAlign.Start }
}
let AlignRue: Record<string, Record<string, string | VerticalAlign | HorizontalAlign>> = {
  'top': { 'anchor': '__container__', 'align': VerticalAlign.Top },
  'right': { 'anchor': '__container__', 'align': HorizontalAlign.End }
}
let Mleft: Record<string, number> = { 'left': 20 }
let BWC: Record<string, number | string> = { 'width': 2, 'color': '#6699FF' }
​
@Entry
@Component
struct Index {
  build() {
    RelativeContainer() {
      Row() {
        Text('row1')
      }
      .justifyContent(FlexAlign.Center)
      .width(100)
      .height(100)
      .backgroundColor('#a3cf62')
      .alignRules(AlignRus)
      .id("row1")
​
      Row() {
        Text('row2')
      }
      .justifyContent(FlexAlign.Center)
      .width(100)
      .height(100)
      .backgroundColor('#00ae9d')
      .alignRules(AlignRue)
      .id("row2")
    }.width(300).height(300)
    .margin(Mleft)
    .border(BWC)
  }
}

img

设置相对于锚点的对齐位置

文档中心设置相对于锚点的对齐位置

设置了锚点之后,可以通过align设置相对于锚点的对齐位置。

在水平方向上,对齐位置可以设置为HorizontalAlign.Start、HorizontalAlign.Center、HorizontalAlign.End。

img

在竖直方向上,对齐位置可以设置为VerticalAlign.Top、VerticalAlign.Center、VerticalAlign.Bottom。

img

总结

@Entry
@Component
struct Page3 {
  @State message: string = 'Hello World';
  build() {
    RelativeContainer() {
      Text(this.message)
        .id('Page3HelloWorld')
        .fontSize($r('app.float.page_text_font_size'))
        .fontWeight(FontWeight.Bold)
        .alignRules({
          center: { anchor: '__container__', align: VerticalAlign.Center },
          middle: { anchor: '__container__', align: HorizontalAlign.Center }
        })
    }
    .height('100%')
    .width('100%')
  }
}

屏幕截图 2025-02-19 192534

在这个一个代码中相对布局(RelativeContainer)下的 Text( )(文本组件下)使用了相对布局

.alignRules
({
   center: { anchor: '__container__', align: VerticalAlign.Center },
   middle: { anchor: '__container__', align: HorizontalAlign.Center }
})
​
​
//语法:
其语法为:.alignRules({  location:{ anchor: '__container__', align:Align positions}  })
.alignRules
({
    定位锚点位置设置:
    { 
        anchor(锚):'所需要的相对那个组件定位的ID名称',
        align(设置相对于锚点的对齐位置):'设置相对于锚点的对齐位置'
    }
})
定位锚点位置设置:
可选择:
在水平方向上,可以设置left、middle、right的锚点。
在竖直方向上,可以设置top、center、bottom的锚点。
​
anchor(锚):'所需要的相对那个组件定位的ID名称',
所需要的相对那个组件定位的ID名称:
以父元素或以兄弟元素
*子组件锚点可以任意选择,但需注意不要相互依赖。
​
align(设置相对于锚点的对齐位置):
    设置了锚点之后,可以通过align设置相对于锚点的对齐位置
    在水平方向上,对齐位置可以设置为
    HorizontalAlign.Start(左)
    HorizontalAlign.Center(中)
    HorizontalAlign.End(右)
    在竖直方向上,对齐位置可以设置为
    VerticalAlign.Top(上)
    VerticalAlign.Center(中)
    VerticalAlign.Bottom(下)

其语法为.alignRules({ location:{ anchor: 'container', align:Align positions} })

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值