logo
积分中心
鸿蒙UI开发——布局优先级
头像 蓝亭书序 2026-11-18 14:32:08    发布
0 浏览 0 收藏

1、概 述

针对常见的开发场景,ArkUI开发框架提供了非常多的自适应布局能力,这些布局可以独立使用,也可多种布局叠加使用。本文针对ArkUI提供的显示优先级能力做简单讨论。

容器组件内的子组件,按照其预设的显示优先级,随容器组件尺寸变化显示或隐藏。相同显示优先级的子组件同时显示或隐藏。效果如下:

图片

2、显示优先级控制显隐

通过显示优先级可以实现组件的动态隐藏能力。

隐藏能力是指:容器组件内的子组件,按照其预设的显示优先级,随容器组件尺寸变化显示或隐藏,其中相同显示优先级的子组件同时显示或隐藏。

显隐控制是一种比较高级的布局方式,常用于分辨率变化较大,且不同分辨率下显示内容有所差异的场景。主要思想是通过增加或减少显示内容,来保持最佳的显示效果。

隐藏能力通过设置布局优先级(displayPriority属性)来控制显隐,当布局主轴方向剩余尺寸不足以满足全部元素时,按照布局优先级大小,从小到大依次隐藏,直到容器能够完整显示剩余元素。具有相同布局优先级的元素将同时显示或者隐藏。

3、displayPriority

displayPriority用于设置当前组件在布局容器中显示的优先级。接口定义如下:


// 设置当前组件在布局容器中显示的优先级。 value 默认值:1
displayPriority(value: number)


说明:

  • 仅在Row/Column/Flex(单行)容器组件中生效。
  • 小数点后的数字不作优先级区分,即区间为[x, x + 1)内的数字视为相同优先级。例如:1.0与1.9为同一优先级。
  • 子组件的displayPriority均不大于1时,优先级没有区别。
  • 当子组件的displayPriority大于1时,displayPriority数值越大,优先级越高。若父容器空间不足,隐藏低优先级子组件。若某一优先级的子组件被隐藏,则优先级更低的子组件也都被隐藏。


4、案例

父容器尺寸发生变化时,其子元素按照预设的优先级显示或隐藏。

效果如下:

图片

代码如下:


@Entry
@Component
struct HiddenCapabilitySample {
  @State rate: number = 0.45
  // 底部滑块,可以通过拖拽滑块改变容器尺寸
  @Builder slider() {
    Slider({ value: this.rate * 100, min: 10, max: 45, style: SliderStyle.OutSet })
      .blockColor(Color.White)
      .width('60%')
      .height(50)
      .onChange((value: number) => {
        this.rate = value / 100
      })
      .position({ x: '20%', y: '80%' })
  }
  build() {
    Column() {
      Row({ space:24 }) {
        Text('会话')
          .width(48)
          .height(48)
          .textAlign(TextAlign.Center)
          .displayPriority(1)  // 布局优先级
        Text('联系人')
          .width(48)
          .height(48)
          .textAlign(TextAlign.Center)
          .displayPriority(2)  // 布局优先级
        Text('短视频')
          .width(48)
          .height(48)
          .textAlign(TextAlign.Center)
          .displayPriority(3)  // 布局优先级
        Text('动态')
          .width(48)
          .height(48)
          .textAlign(TextAlign.Center)
          .displayPriority(2)  // 布局优先级
        Text('发现')
          .width(48)
          .height(48)
          .textAlign(TextAlign.Center)
          .displayPriority(1)  // 布局优先级
      }
      .width(this.rate * 100 + '%')
      .height(96)
      .borderRadius(16)
      .backgroundColor('#FFFFFF')
      .justifyContent(FlexAlign.Center)
      .alignItems(VerticalAlign.Center)
      this.slider()
    }
    .width('100%')
    .height('100%')
    .backgroundColor('#F1F3F5')
    .justifyContent(FlexAlign.Center)
    .alignItems(HorizontalAlign.Center)
  }
}




©本站发布的所有内容,包括但不限于文字、图片、音频、视频、图表、标志、标识、广告、商标、商号、域名、软件、程序等,除特别标明外,均来源于网络或用户投稿,版权归原作者或原出处所有。我们致力于保护原作者版权,若涉及版权问题,请及时联系我们进行处理。
分类
HarmonyOS

暂无评论数据

加载中...

发布

地址:北京市朝阳区北三环东路三元桥曙光西里甲1号第三置业A座1508室 电话:13391790444或(010)62178877
版权所有:电脑商情信息服务集团 北京赢邦策略咨询有限责任公司
声明:本媒体部分图片、文章来源于网络,版权归原作者所有,我司致力于保护作者版权,如有侵权,请与我司联系删除

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255