相对布局（RelativeContainer）

最新推荐文章于 2025-03-28 14:33:01 发布
最新推荐文章于 2025-03-28 14:33:01 发布
阅读量793 收藏 5
点赞数 25
文章标签： harmonyos 华为
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/F15239359611/article/details/144992487
版权

概述

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

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

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

基本概念

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

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

设置依赖关系

锚点设置

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

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

  • RelativeContainer父组件为锚点，__container__代表父容器的ID。

@Entry
@Component
struct MyComponent {
  build() {
    RelativeContainer() {
      Row(){
        Text('row1')
      }
      .justifyContent(FlexAlign.Center)
      .width(100)
      .height(100)
      .backgroundColor('#a3cf62')
      .alignRules({
        // anchor:锚点    __container__:父容器的ID   VerticalAlign.Top:指的是锚点的顶部
        // 这行代码表示该组件的top（上部）与 锚点（父容器）的top 对应
        top: { 'anchor': '__container__', 'align': VerticalAlign.Top },
        
        // 该组件的left（左侧）与 锚点（父容器）的start（开始）对应
        left: { anchor: '__container__', 'align': HorizontalAlign.Start }
      })
      .id("row1")

      Row(){
        Text('row2')
      }
      .justifyContent(FlexAlign.Center)
      .width(100)
      .height(100)
      .backgroundColor('#00ae9d')
      .alignRules({
        //该组件的top（上部）与 锚点（父容器）的top 对应
        top: { 'anchor': '__container__', 'align': VerticalAlign.Top },
        //该组件的right（右侧）与 锚点（父容器）的end（结尾）对应
        right: { anchor: '__container__', 'align': HorizontalAlign.End }
      })
      .id("row2")

    }
    .width('100%')
  }
}

 

 RelativeContainer(){
      Row(){
        Text('row1')
      }
      .justifyContent(FlexAlign.Center)
      .width(100)
      .height(100)
      .backgroundColor(Color.Pink)
      .alignRules({
        center:{anchor:'__container__',align:VerticalAlign.Center},
        middle:{anchor:'__container__',align:HorizontalAlign.Center}
      })
    }
    .width('100%')
    .height(300)
    .backgroundColor(Color.Yellow)
  • 以兄弟元素为锚点。

let AlignRus: Record<string, Record<string, string | VerticalAlign | HorizontalAlign>> = {
  'top': { 'anchor': '__container__', 'align': VerticalAlign.Top },
  'left': { 'anchor': '__container__', 'align': HorizontalAlign.Start }
}
let RelConB: Record<string, Record<string, string | VerticalAlign | HorizontalAlign>> = {
  'top': { 'anchor': 'row1', 'align': VerticalAlign.Bottom },
  'left': { 'anchor': 'row1', 'align': HorizontalAlign.Start }
}
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('#00ae9d')
      .alignRules(AlignRus)  //row1 的 锚点 是 父容器
      .id("row1")

      Row() {
        Text('row2')
      }
      .justifyContent(FlexAlign.Center)
      .width(100)
      .height(100)
      .backgroundColor('#a3cf62')
      .alignRules(RelConB)  // row2 的 锚点 是 row1
      .id("row2")
    }.width(300).height(300)
    .margin(Mleft)
    .border(BWC)
  }
}
  •  子组件锚点可以任意选择，但需注意不要相互依赖。

@Entry
@Component
struct Index {
  build() {
    Row() {
      RelativeContainer() {
        Row(){Text('row1')}.justifyContent(FlexAlign.Center).width(100).height(100)
        .backgroundColor('#a3cf62')
        .alignRules({
          top: {anchor: "__container__", align: VerticalAlign.Top},
          left: {anchor: "__container__", align: HorizontalAlign.Start}
        })
        .id("row1")

        Row(){Text('row2')}.justifyContent(FlexAlign.Center).width(100)
        .backgroundColor('#00ae9d')
        .alignRules({
          top: {anchor: "__container__", align: VerticalAlign.Top},
          right: {anchor: "__container__", align: HorizontalAlign.End},
          bottom: {anchor: "row1", align: VerticalAlign.Center},
        })
        .id("row2")

        Row(){Text('row3')}.justifyContent(FlexAlign.Center).height(100)
        .backgroundColor('#0a59f7')
        .alignRules({
          top: {anchor: "row1", align: VerticalAlign.Bottom},
          left: {anchor: "row1", align: HorizontalAlign.Start},
          right: {anchor: "row2", align: HorizontalAlign.Start}
        })
        .id("row3")

        Row(){Text('row4')}.justifyContent(FlexAlign.Center)
        .backgroundColor('#2ca9e0')
        .alignRules({
          top: {anchor: "row3", align: VerticalAlign.Bottom},
          left: {anchor: "row1", align: HorizontalAlign.Center},
          right: {anchor: "row2", align: HorizontalAlign.End},
          bottom: {anchor: "__container__", align: VerticalAlign.Bottom}
        })
        .id("row4")
      }
      .width(300).height(300)
      .margin({left: 50})
      .border({width:2, color: "#6699FF"})
    }
    .height('100%')
  }
}

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

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

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

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

子组件位置偏移

子组件经过相对位置对齐后，位置可能还不是目标位置，开发者可根据需要进行额外偏移设置offset。

@Entry
@Component
struct Index {
  build() {
    RelativeContainer(){
      Row(){
        Text('row1')
      }
      .justifyContent(FlexAlign.Center)
      .width(100)
      .height(100)
      .backgroundColor(Color.Pink)
      .alignRules({
        top:{anchor:'__container__',align:VerticalAlign.Top},
        left:{anchor:'__container__',align:HorizontalAlign.Start}
      })
      .offset({
        x:20,
        y:30
      })

      Row(){
        Text('row2')
      }
      .justifyContent(FlexAlign.Center)
      .width(100)
      .height(100)
      .backgroundColor(Color.Pink)
      .alignRules({
        bottom:{anchor:'__container__',align:VerticalAlign.Bottom},
        right:{anchor:'__container__',align:HorizontalAlign.End}
      })
      .offset({
        x:-20,
        y:-30
      })
    }
    .width('100%')
    .height(300)
    .backgroundColor(Color.Yellow)
  }
}

多种组件的对齐布局

Row、Column、Flex、Stack等多种布局组件，可按照RelativeContainer组件规则进行对齐排布。

@Entry
@Component
struct Index {
@State value: number = 0

build() {
  Row() {

    RelativeContainer() {
      Row()
        .width(100)
        .height(100)
        .backgroundColor('#a3cf62')
        .alignRules({
          top: { anchor: "__container__", align: VerticalAlign.Top },
          left: { anchor: "__container__", align: HorizontalAlign.Start }
        })
        .id("row1")

      Column()
        .width('50%')
        .height(30)
        .backgroundColor('#00ae9d')
        .alignRules({
          top: { anchor: "__container__", align: VerticalAlign.Top },
          left: { anchor: "__container__", align: HorizontalAlign.Center }
        })
        .id("row2")

      Flex({ direction: FlexDirection.Row }) {
        Text('1').width('20%').height(50).backgroundColor('#0a59f7')
        Text('2').width('20%').height(50).backgroundColor('#2ca9e0')
        Text('3').width('20%').height(50).backgroundColor('#0a59f7')
        Text('4').width('20%').height(50).backgroundColor('#2ca9e0')
      }
      .padding(10)
      .backgroundColor('#30c9f7')
      .alignRules({
        top: { anchor: "row2", align: VerticalAlign.Bottom },
        left: { anchor: "__container__", align: HorizontalAlign.Start },
        bottom: { anchor: "__container__", align: VerticalAlign.Center },
        right: { anchor: "row2", align: HorizontalAlign.Center }
      })
      .id("row3")

      Stack({ alignContent: Alignment.Bottom }) {
        Text('First child, show in bottom').width('90%').height('100%').backgroundColor('#a3cf62').align(Alignment.Top)
        Text('Second child, show in top').width('70%').height('60%').backgroundColor('#00ae9d').align(Alignment.Top)
      }
      .margin({ top: 5 })
      .alignRules({
        top: { anchor: "row3", align: VerticalAlign.Bottom },
        left: { anchor: "__container__", align: HorizontalAlign.Start },
        bottom: { anchor: "__container__", align: VerticalAlign.Bottom },
        right: { anchor: "row3", align: HorizontalAlign.End }
      })
      .id("row4")

    }
    .width(300).height(300)
    .margin({ left: 50 })
    .border({ width: 2, color: "#6699FF" })
  }
  .height('100%')
}
}

组件尺寸

子组件尺寸大小不会受到相对布局规则的影响。若子组件某个方向上设置两个或以上alignRules时最好不设置此方向尺寸大小，否则对齐规则确定的组件尺寸与开发者设置的尺寸可能产生冲突。

@Entry
@Component
struct Index {
build() {
  Row() {
    RelativeContainer() {
      Row() {
        Text('row1')
      }
      .justifyContent(FlexAlign.Center)
      .width(100)
      .height(100)
      .backgroundColor('#a3cf62')
      .alignRules({
        top: { anchor: "__container__", align: VerticalAlign.Top },
        left: { anchor: "__container__", align: HorizontalAlign.Start }
      })
      .id("row1")

      Row() {
        Text('row2')
      }
      .justifyContent(FlexAlign.Center)
      .width(100)
      .backgroundColor('#00ae9d')
      .alignRules({
        top: { anchor: "__container__", align: VerticalAlign.Top },
        right: { anchor: "__container__", align: HorizontalAlign.End },
        bottom: { anchor: "row1", align: VerticalAlign.Center },
      })
      .id("row2")

      Row() {
        Text('row3')
      }
      .justifyContent(FlexAlign.Center)
      .height(100)
      .backgroundColor('#0a59f7')
      .alignRules({
        top: { anchor: "row1", align: VerticalAlign.Bottom },
        left: { anchor: "row1", align: HorizontalAlign.End },
        right: { anchor: "row2", align: HorizontalAlign.Start }
      })
      .id("row3")

      Row() {
        Text('row4')
      }.justifyContent(FlexAlign.Center)
      .backgroundColor('#2ca9e0')
      .alignRules({
        top: { anchor: "row3", align: VerticalAlign.Bottom },
        bottom: { anchor: "__container__", align: VerticalAlign.Bottom },
        left: { anchor: "__container__", align: HorizontalAlign.Start },
        right: { anchor: "row1", align: HorizontalAlign.End }
      })
      .id("row4")

      Row() {
        Text('row5')
      }.justifyContent(FlexAlign.Center)
      .backgroundColor('#30c9f7')
      .alignRules({
        top: { anchor: "row3", align: VerticalAlign.Bottom },
        bottom: { anchor: "__container__", align: VerticalAlign.Bottom },
        left: { anchor: "row2", align: HorizontalAlign.Start },
        right: { anchor: "row2", align: HorizontalAlign.End }
      })
      .id("row5")

      Row() {
        Text('row6')
      }
      .justifyContent(FlexAlign.Center)
      .backgroundColor('#ff33ffb5')
      .alignRules({
        top: { anchor: "row3", align: VerticalAlign.Bottom },
        bottom: { anchor: "row4", align: VerticalAlign.Bottom },
        left: { anchor: "row3", align: HorizontalAlign.Start },
        right: { anchor: "row3", align: HorizontalAlign.End }
      })
      .id("row6")
      .backgroundImagePosition(Alignment.Bottom)
      .backgroundImageSize(ImageSize.Cover)
    }
    .width(300).height(300)
    .margin({ left: 50 })
    .border({ width: 2, color: "#6699FF" })
  }
  .height('100%')
}
}

99天梭哈HarmonyOS到入职成功-第2天-一次开发多端部署方案（栅格布局GridRow/GridCol和相对布局RelativeContainer）
康宝的博客
02-22 584
99天梭哈HarmonyOS到入职成功-第2天-一次开发多端部署方案（栅格布局GridRow/GridCol和相对布局RelativeContainer）
OpenHarmony实战开发-相对布局 (RelativeContainer)
m0_70749039的博客
04-26 1029
在应用的开发过程中，经常需要设计复杂界面，此时涉及到多个相同或不同组件之间的嵌套。如果布局组件嵌套深度过深，或者嵌套组件数过多，会带来额外的开销。如果在布局的方式上进行优化，就可以有效的提升性能，减少时间开销。请参考优化布局时间了解RelativeContainer相对于List，在布局时间上的性能提升。
【愚公系列】2023年12月 HarmonyOS教学课程 008-ArkUI组件（RelativeContainer）
热门推荐
时光隧道
12-02 6万+
ArkUI组件中的RelativeContainer是一个相对定位的容器，可以用来将子组件按照相对位置布局。在RelativeContainer中，每个子组件都可以设置相对于父容器或其他组件的位置和大小。可以通过设置相对位置、偏移量、宽度和高度来实现布局。相对位置可以设置为左侧、上方、右侧和下方。偏移量可以设置为相对位置的偏移值，例如向右偏移10像素或向下偏移5像素。宽度和高度可以设置为相对值或绝对值。使用RelativeContainer时，要注意避免组件重叠或越出容器边界的情况。
鸿蒙next开发：ArkUI组件（RelativeContainer）
最新发布
Aym88的博客
03-28 569
ArkUI组件中的RelativeContainer是一个相对定位的容器，可以用来将子组件按照相对位置布局。
HarmonyOS ArkUI容器类组件-相对布局容器（RelativeContainer）
m0_71263309的博客
04-22 713
ArkUI 开发框架提供了 RelativeContainer 组件实现相对布局的能力，该布局适用于复杂场景下多元素对齐的情况。该组件可以包含多个子组件，本节笔者简单介绍一下 RelativeContainer 的使用。
鸿蒙Harmony应用开发—ArkTS声明式开发（容器组件：RelativeContainer）
m0_64420071的博客
03-15 2311
ArkTS声明式开发（容器组件：RelativeContainer）
HarmonyOS 实战开发 —— 相对布局 RelativeContainer
CTrup的博客
11-09 511
对于组件的尺寸，若子组件某个方向上设置两个或以上 alignRules 时最好不设置此方向尺寸大小，否则对齐规则确定的组件尺寸与开发者设置的尺寸可能产生冲突。比如某个组件在垂直方向设置了 top 和 bottom 约束，那么在实际的开发过程中就不要再次设置该组件的高度。我们可以结合 Column 和 Row 容器实现上面效果，但是今天主要讲下 RelativeContainer 相对布局容器，这有点类似于 iOS 开发中的布局约束概念，实现方式都是以某个元素为锚点进行相对布局。即可实现我们想要的效果。
HarmonyOS 开发实践——相对布局 RelativeContainer
liuhaojiabin的博客
10-31 442
对于组件的尺寸，若子组件某个方向上设置两个或以上 alignRules 时最好不设置此方向尺寸大小，否则对齐规则确定的组件尺寸与开发者设置的尺寸可能产生冲突。比如某个组件在垂直方向设置了 top 和 bottom 约束，那么在实际的开发过程中就不要再次设置该组件的高度。我们可以结合 Column 和 Row 容器实现上面效果，但是今天主要讲下 RelativeContainer 相对布局容器，这有点类似于 iOS 开发中的布局约束概念，实现方式都是以某个元素为锚点进行相对布局。即可实现我们想要的效果。
华为仓颉鸿蒙HarmonyOS NEXT仓颉容器组件相对布局RelativeContainer
BinShaosir的专栏
12-25 715
barrier参数，用于定义一条barrier的id、方向和生成时所依赖的组件。guideLine参数，用于定义一条guideline的id、方向和位置。guideLine位置参数，用于定义guideline的位置。设置RelativeContaine容器内的辅助线。设置RelativeContaine容器内的屏障。创建一个RelativeContainer组件。创建一个RelativeContainer组件。相对布局组件，用于复杂场景中元素对齐的布局。👇🏻👇🏻👇🏻求关注👇🏻👇🏻👇🏻。技术交流群可加wx“
【鸿蒙开发】—— 相对布局 (RelativeContainer)
2401_88547687的博客
11-03 941
RelativeContainer为采用相对布局的容器，支持容器内部的子元素设置相对位置关系，适用于界面复杂场景的情况，对多个子组件进行对齐和排列。子元素支持指定兄弟元素作为锚点，也支持指定父容器作为锚点，基于锚点做相对位置布局。下图是一个RelativeContainer的概念图，图中的虚线表示位置的依赖关系。
【HarmonyOS NEXT】相对布局：RelativeContainer
weixin_71403100的博客
09-05 872
Entry@Componentbuild() {Row() {Row()top: { anchor: '__container__', align: VerticalAlign.Top }, //以父容器为锚点，竖直方向顶头对齐middle: { anchor: '__container__', align: HorizontalAlign.Center } //以父容器为锚点，水平方向居中对齐}).id('row1') //设置锚点为row1Row() {
鸿蒙HarmonyOS实战-ArkUI组件（RelativeContainer）
shudaoshanQAQ的博客
01-04 1926
如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我三个小忙：关注小编，同时可以期待后续文章ing🚀，不定期分享原创知识。想要获取文中提到的学习资料，请点击→全套鸿蒙HarmonyOS学习资料或者关注小编后私信回复【666】也可获取资料哦~~
第十二讲_ArkUI相对布局（RelativeContainer）
wenqi1992的博客
01-23 1173
介绍ArkUI相对布局RelativeContainer容器组件
2.4、相对布局（RelativeContainer）
lujianfeiccie2009的专栏
03-20 293
为采用相对布局的容器，支持容器内部的子元素设置相对位置关系。子元素支持指定兄弟元素作为锚点，也支持指定父容器作为锚点，基于锚点做相对位置布局。下图是一个的概念图，图中的虚线表示位置的依赖关系。
鸿蒙开发：RelativeContainer 相对布局详解【全套华为认证学习资料分享（考试大纲、培训教材、实验手册等等）】
HuaweiLab_Peach的博客
03-06 433
在最新版本的 DevEco Studio 中，官方在创建新项目时，默认使用。
鸿蒙Harmony-相对布局（RelativeContainer）详解
袁震的博客
01-14 4211
成年人的世界，从来没有容易二字，想要什么，就得凭自己的努力去拿，遇到事情就得自己生生的硬抗，希望你即使再辛苦，但还是会选择这滚烫的人生，加油陌生的朋友们
鸿蒙开发---布局-相对布局 (RelativeContainer)的自己理解和解释
2201_75775965的博客
02-21 893
Entry@Componentbuild() {})在这个一个代码中相对布局（RelativeContainer）下的 Text( )（文本组件下）使用了相对布局({})​​//语法：其语法为：.alignRules（{ location：{ anchor: '__container__', align:Align positions} }）({定位锚点位置设置:anchor(锚):'所需要的相对那个组件定位的ID名称',
RelativeContainer未满屏
12-06
RelativeContainer未满屏的问题通常出现在使用相对布局（RelativeLayout）时。以下是一些可能的原因和解决方法： 1. **布局参数设置不正确**： - 确保RelativeContainer的宽度和高度设置为`match_parent`，以使其...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值