大网数据广告活动
OpenHarmony 设备与应用开发

OpenHarmony 中文参考:Stack

· 52CE 我爱测

设置子组件在容器内的对齐方式。该属性与align同时设置时,后设置的属性生效。该属性与接口的构造入参同时设置时,生效属性上的设置效果。

Stack

堆叠容器,子组件按照顺序依次入栈,后一个子组件覆盖前一个子组件。

说明:

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

  • 通用属性align在该组件上支持镜像能力。

子组件

可以包含子组件。

接口

Stack(options?: StackOptions)

堆叠容器,子组件按照顺序依次入栈,后一个子组件覆盖前一个子组件。

说明:

过多的组件嵌套会导致性能劣化。在部分场景中,直接使用组件属性或借助系统API的能力可以替代层叠容器的效果,减少了嵌套组件数进而优化性能。最佳实践请参考组件嵌套优化-优先使用组件属性代替嵌套组件。

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

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

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

参数:

参数名 类型 必填 说明
options StackOptions 否 设置子组件在容器内的对齐方式。

StackOptions18+对象说明

设置堆叠容器的子组件对齐方式。

说明:

为规范匿名对象的定义,API 18版本修改了此处的元素定义。其中,保留了历史匿名对象的起始版本信息,会出现外层元素@since版本号高于内层元素版本号的情况,但这不影响接口的使用。

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

原子化服务API: 从API version 18开始,该接口支持在原子化服务中使用。

模型约束: 此接口仅可在Stage模型下使用。

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

名称 类型 只读 可选 说明
alignContent7+ Alignment 否 是 设置子组件在容器内的对齐方式。
默认值:Alignment.Center
非法值:按默认值处理。
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。

属性

除支持通用属性外,还支持以下属性:

alignContent

alignContent(value: Alignment)

设置子组件在容器内的对齐方式。该属性与align同时设置时,后设置的属性生效。该属性与接口的构造入参同时设置时,生效属性上的设置效果。

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

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

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

参数:

参数名 类型 必填 说明
value Alignment 是 所有子组件在容器内的对齐方式。
默认值:Alignment.Center
非法值:按默认值处理。

syncLoad

syncLoad(enable: boolean)

设置是否同步加载Stack区域内所有子组件。

起始版本: 26.0.0

原子化服务API: 从API版本26.0.0开始,该接口支持在原子化服务中使用。

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

模型约束: 此接口仅可在Stage模型下使用。

参数:

参数名 类型 必填 说明
enable boolean 是 是否同步加载Stack区域内所有子组件。
true表示同步加载;false表示异步加载。
默认值:true
说明:
设置为false时,在首次显示场景,若当前帧布局耗时超过50ms,会将Stack区域内尚未布局的子组件延后到下一帧进行布局。

事件

支持通用事件。

示例

当Stack的alignContent属性设为Alignment.Bottom,且syncLoad为true时,其子组件的显示效果表现为在Stack组件底部横向居中并且所有子组件在同一帧内加载完成。

从API版本26.0.0开始,新增syncLoad属性。

// xxx.ets
@Entry
@Component
struct StackExample {
  build() {
    Stack({ alignContent: Alignment.Bottom }) {
      Text('First child, show in bottom').width('90%').height('100%').backgroundColor(0xd2cab3).align(Alignment.Top)
      Text('Second child, show in top').width('70%').height('60%').backgroundColor(0xc1cbac).align(Alignment.Top)
    }.width('100%').height(150).margin({ top: 5 })
    // 从API版本26.0.0开始,新增syncLoad属性。
    .syncLoad(true)
  }
}

[图示请参阅官方原文]

本文来自 OpenHarmony 文档贡献者,按 CC BY 4.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
OpenHarmony 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。