Stack

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

说明：

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

子组件

可以包含子组件。

接口

Stack(options?: StackOptions)

说明：

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

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

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

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

参数：

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

StackOptions¹⁸⁺对象说明

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

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

系统能力： 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

示例

Stack的alignContent设置为Alignment.Bottom条件下子组件显示效果。

// 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 })
  }
}