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 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。
