鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(布局约束)

鸿蒙5.0版开发:ArkTS组件通用属性-布局约束 通过组件的宽高比和显示优先级约束组件显示效果。 阅读详情

往期鸿蒙全套实战文章必看:(文中附带全栈鸿蒙学习资料)


布局约束

通过组件的宽高比和显示优先级约束组件显示效果。

说明

从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

aspectRatio

aspectRatio(value: number)

指定当前组件的宽高比,aspectRatio=width/height。

  • 仅设置width、aspectRatio时,height=width/aspectRatio。
  • 仅设置height、aspectRatio时,width=height*aspectRatio。
  • 同时设置width、height和aspectRatio时,height不生效,height=width/aspectRatio。

设置aspectRatio属性后,组件宽高会受父组件内容区大小限制。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
valuenumber是

指定当前组件的宽高比。

API version 9及以前,默认值为:1.0。

API version 10:无默认值。

说明:

该属性在不设置值或者设置非法值时不生效。

例如,Row只设置宽度且没有子组件,aspectRatio不设置值或者设置成负数时,此时Row高度为0。

displayPriority

displayPriority(value: number)

设置当前组件在布局容器中显示的优先级。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
valuenumber是

设置当前组件在布局容器中显示的优先级。

默认值:1

说明:

仅在Row/Column/Flex(单行)容器组件中生效。

小数点后的数字不作优先级区分,即区间为[x, x + 1)内的数字视为相同优先级。例如:1.0与1.9为同一优先级。

子组件的displayPriority均不大于1时,优先级没有区别。

当子组件的displayPriority大于1时,displayPriority数值越大,优先级越高。若父容器空间不足,隐藏低优先级子组件。若某一优先级的子组件被隐藏,则优先级更低的子组件也都被隐藏。

示例

示例1(设置组件宽高比)

通过aspectRatio设置不同的宽高比。

// xxx.ets
@Entry
@Component
struct AspectRatioExample {
  private children: string[] = ['1', '2', '3', '4', '5', '6']

  build() {
    Column({ space: 20 }) {
      Text('using container: row').fontSize(14).fontColor(0xCCCCCC).width('100%')
      Row({ space: 10 }) {
        ForEach(this.children, (item:string) => {
          // 组件宽度 = 组件高度*1.5 = 90
          Text(item)
            .backgroundColor(0xbbb2cb)
            .fontSize(20)
            .aspectRatio(1.5)
            .height(60)
          // 组件高度 = 组件宽度/1.5 = 60/1.5 = 40
          Text(item)
            .backgroundColor(0xbbb2cb)
            .fontSize(20)
            .aspectRatio(1.5)
            .width(60)
        }, (item:string) => item)
      }
      .size({ width: "100%", height: 100 })
      .backgroundColor(0xd2cab3)
      .clip(true)

      // grid子元素width/height=3/2
      Text('using container: grid').fontSize(14).fontColor(0xCCCCCC).width('100%')
      Grid() {
        ForEach(this.children, (item:string) => {
          GridItem() {
            Text(item)
              .backgroundColor(0xbbb2cb)
              .fontSize(40)
              .width('100%')
              .aspectRatio(1.5)
          }
        }, (item:string) => item)
      }
      .columnsTemplate('1fr 1fr 1fr')
      .columnsGap(10)
      .rowsGap(10)
      .size({ width: "100%", height: 165 })
      .backgroundColor(0xd2cab3)
    }.padding(10)
  }
}

图1 竖屏显示

图2 横屏显示

示例2(设置组件显示优先级)

使用displayPriority给子组件绑定显示优先级。

class ContainerInfo {
  label: string = '';
  size: string = '';
}

class ChildInfo {
  text: string = '';
  priority: number = 0;
}

@Entry
@Component
struct DisplayPriorityExample {
  // 显示容器大小
  private container: ContainerInfo[] = [
    { label: 'Big container', size: '90%' },
    { label: 'Middle container', size: '50%' },
    { label: 'Small container', size: '30%' }
  ]
  private children: ChildInfo[] = [
    { text: '1\n(priority:2)', priority: 2 },
    { text: '2\n(priority:1)', priority: 1 },
    { text: '3\n(priority:3)', priority: 3 },
    { text: '4\n(priority:1)', priority: 1 },
    { text: '5\n(priority:2)', priority: 2 }
  ]
  @State currentIndex: number = 0;

  build() {
    Column({ space: 10 }) {
      // 切换父级容器大小
      Button(this.container[this.currentIndex].label).backgroundColor(0x317aff)
        .onClick(() => {
          this.currentIndex = (this.currentIndex + 1) % this.container.length;
        })
      // 通过变量设置Flex父容器宽度
      Flex({ justifyContent: FlexAlign.SpaceBetween }) {
        ForEach(this.children, (item:ChildInfo) => {
          // 使用displayPriority给子组件绑定显示优先级
          Text(item.text)
            .width(120)
            .height(60)
            .fontSize(24)
            .textAlign(TextAlign.Center)
            .backgroundColor(0xbbb2cb)
            .displayPriority(item.priority)
        }, (item:ChildInfo) => item.text)
      }
      .width(this.container[this.currentIndex].size)
      .backgroundColor(0xd2cab3)
    }.width("100%").margin({ top: 50 })
  }
}

横屏显示

鸿蒙HarmonyOS NEXT开发:布局约束(ArkTS通用属性) 通过组件的宽高比和显示优先级约束组件显示效果。 阅读详情

相关推荐

鸿蒙Harmony应用开发—ArkTS声明式开发(基础手势:RichText)

ArkTS声明式开发(基础手势:RichText)

m0_64420071的博客 1920

鸿蒙开发-UI-布局-列表

上文详细学习常见布局方式-栅格布局,学习栅格布局中列数控制,子组件的排列方向已经间距控制,也学习了栅格容器子组件占用列数以及偏移和顺序的定义方式。本文将学习List布局1.设置内容间距在初始化列表时,如需在列表项之间添加间距,可以使用space参数。如下代码所示,在每个列表项之间沿主轴方向添加10vp的间距...2.添加分割线List提供了divider属性用于给列表项之间添加分隔线。在设置divider属性时,可以通过strokeWidth和color属性设置分隔线的粗细和颜色。

中年程序员 2382

鸿蒙Harmony应用开发—ArkTS声明式开发(容器组件:RelativeContainer)

ArkTS声明式开发(容器组件:RelativeContainer)

m0_64420071的博客 2574

鸿蒙API13开发【布局约束】ArkTS组件

通过组件的宽高比和显示优先级约束组件显示效果。

鸿蒙的技术博客 851

【Android、IOS、Flutter、鸿蒙、ReactNative 】约束布局

Android XML 约束布局、Android Compose 约束布局、IOS Object-c 约束布局、IOS Swifit 约束布局、Flutter 约束布局、鸿蒙 布局 Flexbox、ReactNative Flexbox。

我很好 1381

RK3588开发板实战:从零开始移植Ubuntu 24.04(讯为SDK版)

本文详细介绍了如何在RK3588开发板上从零开始移植Ubuntu 24.04系统(讯为SDK版),涵盖开发环境准备、SDK解析、根文件系统定制、驱动适配、系统集成与烧录等全流程。通过实战案例,帮助开发者快速掌握RK3588开发板的系统移植技巧,适用于嵌入式开发与定制化Linux系统构建。

sand8的博客 439

【鸿蒙 HarmonyOS】Ability 中使用 XML 布局文件 绘制布局及 UI 组件

一、创建 XML 布局文件、 二、XML 布局文件中添加子组件、 三、创建 Ability、 四、配置 Ability、 五、Ability 加载布局文件、 六、完整代码及效果展示、 四、GitHub 地址、

让 学习 成为一种 习惯 ( 韩曙亮 の 技术博客 ) 3728

AUTOSAR OS

AUTOSAR OS总共包含以下。Core中基本对象关系如上图所示,以单核为例,。每个基本对象必须从属于某个OS Application,否则会出现错误。同时OS Application可分为Trusted与Not Trusted这两种类型。

2301_76563067的博客 2344

【鸿蒙next开发】ArkUI框架:ArkTS组件-布局约束

本文介绍了鸿蒙5.0开发中的核心知识点,特别是布局约束中的aspectRatio和displayPriority属性。

m0_73088370的博客 1110

Ubuntu 24.04 搭建 Squid 代理服务器终极指南:从入门到 HTTPS 缓存AI模型

本文详细指导在Ubuntu 24.04系统部署Squid代理服务器,实现AI大模型文件的高效缓存。重点内容包括:1) 安装squid及必备的squid-openssl扩展包;2) 配置HTTPS拦截(SSL-Bumping)功能,创建CA证书和SSL数据库;3) 优化缓存策略,设置4TB存储空间并强制缓存常见大文件格式;4) 结合华为防火墙实现透明代理。文章特别强调实际部署中的关键注意事项和常见错误解决方案,如证书路径配置、权限设置等问题,帮助用户快速搭建企业级缓存代理服务。

zlt315的博客 1921

QGIS|如何将WGS84转换为CGCS 2000坐标系?

QGIS 3中如何将WGS84转换为国家2000大地坐标系? 今天来回答一位朋友在后台留言提出的问题:怎么将WGS84坐标转换为国家2000大地坐标系。 01工程坐标系 从地图窗口右下角的状态栏可以看到当前地图窗口的坐标系,即工程坐标系(Project CRS)。当前地图可以由多个图层组成,各种来源数据的坐标参照系(Layer CRS)并不一定相同,QGIS在绘制图层之前将根据工程坐标系进行动态坐标转换,然后显示在地图画布中。 因此,在处理空间数据的过程中,一定要特别注意...

QGISClass的博客 1万+

【鸿蒙next开发】ArkUI框架:ArkTS组件-RelativeContainer

本文详细介绍了鸿蒙5.0开发中的RelativeContainer相对布局组件的使用方法和规则。

m0_73088370的博客 852

要配置西门子G120XA变频器实现**端子启停**和**Modbus RTU(485)频率给定

如有问题,可通过STARTER软件在线诊断Modbus通讯状态。要配置西门子G120AX变频器实现。

微:13763355074 4859

鸿蒙NEXT开发:ArkTS组件-通用属性(布局约束)

通过组件的宽高比和显示优先级约束组件显示效果。

ZPYQAQ的博客 1138

【8】mctp & pldm

异步会check seq,保证不丢包,虽然发一条req,不用等,但是不能发下一条req,等上条response回来后才能发下一条。TO(tag owner)=1是request,TO=0是response,但是异步通信response由0改为1。如下还有kcs,i3c,serial等。

持续更新ing... 1084

无人机——电机篇(一)

1. 电机的定义 电机俗称“马达”,是无人机的动力来源,无人机通过改变电机的转速来改变无人机的飞行状态。即改变每个电机的速度,使得无人机能够盘旋空中,上升或下降,或向各个方向移动。2. 电机的分类 电机分为:“无刷电机”和“有刷电机” - 无刷电机:是采用半导体开关器件来实现电子换向,具有可靠性高、低干扰、低噪声低、寿命长等优点。一般应用在稍大型的飞行器,载重大,可以有更广泛的用途。 - 有刷电机:是内含电刷装置的将电能转换成机械能(电动机)或将机械能转换成电能(发电机)的旋转电机。有刷电机是所有电机的基

weixin_46066938的博客 1万+

【鸿蒙next开发】ArkUI框架:ArkTS组件-RichText

鸿蒙HarmonyOS的RichText组件用于解析和显示HTML格式文本,适用于基本HTML内容展示场景。

m0_73088370的博客 1191

ImportError: DLL load failed while importing _pydantic_core: 找不到指定的程序对应解决方案

本文主要介绍了ImportError: DLL load failed while importing _pydantic_core: 找不到指定的程序对应解决方案,希望能对使用Python的同学们有所帮助。 文章目录 1. 问题描述 2. 解决方案

weixin_43178406的博客 19万+

【鸿蒙next开发】ArkUI框架:ArkTS组件-Blank

Blank空白填充组件是鸿蒙HarmonyOS开发中的重要布局组件,主要用于在Row/Column/Flex容器主轴方向上自动填充剩余空间。

m0_73088370的博客 755

计算机控制技术及应用

《计算机控制技术及应用》通过总结作者的科研成果和吸收国内外的先进理论、方法和技术,以计算机控制系统的网络化、开放化、智能化和集成化发展趋势为主线索,主要介绍计算机控制系统的基本概念和计算机控制系统的典型形式,计算机控制系统的数学描述与基本分析方法,以及数字PID控制器、最少拍控制系统、达林算法、状态变量设计法等设计方法及其各种改进算法。重点突出计算机控制系统输入输出通道接口的设计方法和典型控制系统的设计案例与实现方法等。

jdk-8u144-linux-x64.tar.gz.

该资源为搭建Linux系统Java环境用,资源的后缀为tar.gz格式的压缩包

【鸿蒙next开发】ArkUI框架:ArkTS组件-EmbeddedComponent

本文介绍了鸿蒙HarmonyOS 5.0中的EmbeddedComponent组件开发实战。

m0_73088370的博客 929

ssm框架搭建

这个是一个在idea上成功跑起来的ssm框架项目,保存在这里方便以后使用直接下载

鸿蒙5.0开发进阶:ArkTS API-PhotoEditorExtensionContext

PhotoEditorExtensionContext是PhotoEditorExtensionAbility的上下文..........

Androidbye的博客 804

精雕软件(JDpaint) 5.5 绿色版

精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版

【鸿蒙next开发】ArkUI框架:ArkTS组件-Refresh

本文详细介绍了鸿蒙5.0开发中的Refresh组件,该组件用于实现页面下拉刷新功能,并支持显示刷新动效。

m0_73088370的博客 820

【鸿蒙next开发】ArkUI框架:ArkTS组件-安全(LocationButton)

文章详细介绍了鸿蒙5.0开发中的LocationButton控件功能,该组件允许用户无需权限弹窗即可临时获取精准定位。

m0_73088370的博客 862

基于React Native鸿蒙跨平台 HarmonyOS ArkTS API 24 核心样式属性在鸿蒙系统中会被精准转换为ArkUI的布局属性

在企业考勤管理体系中,外勤打卡是移动办公场景下的核心功能模块,其对位置信息记录、签到签退状态闭环、跨端数据同步有着严苛要求。鸿蒙系统的分布式全场景能力为企业移动办公应用的多终端部署提供了底层支撑,而React Native凭借“一次开发、多端运行”的技术特性,成为这类外勤打卡应用跨端开发的核心技术底座。本文将从外勤打卡状态管理、空值安全处理、位置信息适配到鸿蒙跨端兼容的底层实现,全方位拆解这款外勤打卡应用的技术架构,剖析React Native与鸿蒙生态深度融合的关键技术要点。

2401_86113894的博客 817

【鸿蒙next开发】ArkUI框架:ArkTS组件-Image

本文详细介绍了鸿蒙HarmonyOS开发中的Image组件功能,涵盖基本使用和高级特性。

m0_73088370的博客 1173

【鸿蒙next开发】ArkUI框架:ArkTS组件-安全(SaveButton)

鸿蒙HarmonyOS 5.0的SaveButton组件从API 10开始支持,为用户提供临时存储权限获取功能。该组件支持自定义图标样式(FULL_FILLED或LINES)、文本描述(11种预设选项)和背景样式,要求至少配置icon或text属性。

m0_73088370的博客 1092
上一篇: 鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(位置设置)
下一篇: 鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(组件级像素取整)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值