跳到主要内容

Stack

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

  • 该组件从API version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
  • 通用属性align在该组件上支持镜像能力。

子组件​

可以包含子组件。

接口​

Stack(options?: StackOptions)

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

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

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

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

参数：

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

StackOptions18+对象说明​

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

卡片能力： 从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

参数：

参数名类型必填说明
valueAlignment是所有子组件在容器内的对齐方式。 默认值：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 })
  }
}