SplitLayout

上下结构布局介绍了常用的页面布局样式。主要分为上下文本和上下图文两种类型。

说明：

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

• 该组件仅可在Stage模型下使用。

• 如果SplitLayout设置通用属性和通用事件，编译工具链会额外生成节点__Common__，并将通用属性或通用事件挂载在__Common__上，而不是直接应用到SplitLayout本身。这可能导致开发者设置的通用属性或通用事件不生效或不符合预期，因此，不建议SplitLayout设置通用属性和通用事件。

导入模块

import { SplitLayout } from '@kit.ArkUI';

子组件

无

SplitLayout

SplitLayout({mainImage: Resource, primaryText: string, secondaryText?: string, tertiaryText?: string, container: () => void })

装饰器类型：@Component

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

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

设备行为差异： 该接口在Wearable设备上使用时，应用程序运行异常，异常信息中提示接口未定义，在其他设备中可正常调用。

名称	类型	必填	装饰器类型	说明
mainImage	ResourceStr	是	@State	传入图片。
primaryText	ResourceStr	是	@Prop	标题内容。
secondaryText	ResourceStr	否	@Prop	副标题内容。当需要在标题下方显示副标题时传入，不传入时取默认值，不显示副标题。
tertiaryText	ResourceStr	否	@Prop	辅助文本。当需要显示辅助文本时传入，不传入时取默认值，不显示辅助文本。
container	() => void	是	@BuilderParam	容器内组件。

事件

不支持通用事件。

示例

该示例通过SplitLayout实现了页面布局，并具备自适应能力。

import { SplitLayout } from '@kit.ArkUI';

@Entry
@Component
struct Index {
  @State demoImage: Resource = $r("app.media.background");

  build() {
    Column() {
      SplitLayout({
        mainImage: this.demoImage,
        primaryText: '新歌推荐',
        secondaryText: '私人订制新歌精选站，为你推荐专属优质新歌;',
        tertiaryText: '每日更新',
      }) {
        Text('示例：空白区域容器内可添加组件')
          .margin({ top: 36 })
      }
    }
    .justifyContent(FlexAlign.SpaceBetween)
    .height('100%')
    .width('100%')
  }
}

小于等于600vp布局：

大于600vp且小于等于840vp的布局：

大于840vp布局：