鸿蒙5.0开发进阶：UI框架-ArkTS组件（SplitLayout）

往期鸿蒙全套实战文章必看：（文中附带全栈鸿蒙学习资料）

• 鸿蒙开发核心知识点，看这篇文章就够了

• 最新版！鸿蒙HarmonyOS Next应用开发实战学习路线

• 鸿蒙HarmonyOS NEXT开发技术最全学习路线指南

• 鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）

---

SplitLayout

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

说明

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

导入模块

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

参数：

名称	参数类型	必填	装饰器类型	说明
mainImage	ResourceStr	是	-	传入图片。
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.music")

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

小于600vp布局：

大于600vp小于840vp布局：

大于840vp布局：