鸿蒙OpenHarmony【FoldSplitContainer】ArkTS栅格与分栏

最新推荐文章于 2025-11-03 10:14:19 发布

原创

最新推荐文章于 2025-11-03 10:14:19 发布 · 1.9k 阅读

CC 4.0 BY-SA版权

文章标签：

FoldSplitContainer分栏布局，实现折叠屏二分栏、三分栏在展开态、悬停态以及折叠态的区域控制。

说明

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

无

FoldSplitContainer({

primary: Callback,

secondary: Callback,

extra?: Callback,

expandedLayoutOptions?: ExpandedRegionLayoutOptions,

hoverModeLayoutOptions?: HoverModeRegionLayoutOptions,

foldedLayoutOptions?: FoldedRegionLayoutOptions,

animationOptions?: AnimateParam,

onHoverStatusChange?: onHoverStatusChangeHandler

})

装饰器类型： @Component

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

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

参数：

名称	参数类型	必填	装饰器类型	说明
primary	()=>void	否	@BuilderParam	主要区域回调函数。
secondary	()=>void	否	@BuilderParam	次要区域回调函数。
extra	()=>void	否	@BuilderParam	扩展区域回调函数，不传入的情况，没有对应区域。
expandedLayoutOptions	[ExpandedRegionLayoutOptions]	否	@Prop	展开态布局信息。
hoverModeLayoutOptions	[HoverModeRegionLayoutOptions]	否	@Prop	悬停态布局信息。
foldedLayoutOptions	[FoldedRegionLayoutOptions]	否	@Prop	折叠态布局信息。
animationOptions	[AnimateParam]	null	否	@Prop
onHoverStatusChange	[onHoverStatusChangeHandler]	否	-	折叠屏进入或退出悬停模式时触发的回调函数。

装饰器类型： @Prop

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

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

展开态布局信息。

名称	类型	必填	说明
isExtraRegionPerpendicular	boolean	否	扩展区域是否从上到下贯穿整个组件，当且仅当extra有效时此字段才生效。默认值：true。
verticalSplitRatio	number	否	主要区域与次要区域之间的高度比例。默认值：PresetSplitRatio.LAYOUT_1V1。
horizontalSplitRatio	number	否	主要区域与扩展区域之间的宽度比例，当且仅当extra有效时此字段才生效。默认值：PresetSplitRatio.LAYOUT_3V2。
extraRegionPosition	[ExtraRegionPosition]	否	扩展区域的位置信息，当且仅当isExtraRegionPerpendicular = false有效时此字段才生效。默认值：ExtraRegionPosition.top。