折叠屏提供独特的手持操作体验“悬停态”,用户可以将设备半折后立在桌面上,实现免手持体验。悬停态适用于不需要频繁交互的任务,如视频通话、视频播放、拍照和听歌。进入悬停态时,中间弯折区域难以操作且显示内容会变形,建议页面内容进行折痕区避让适配。

本文提供折叠屏悬停态的三种实现方式,并根据其特点给出各自的适用场景。
实现悬停态的三种方式中,FolderStack组件使用简便,无需关注设备状态,支持自定义页面布局。FoldSplitContainer组件同样易于使用,但其固定的二分栏和三分栏布局限制了使用场景。自定义实现悬停态需要开发者自行监听设备状态并调整组件布局,支持自定义布局,且由于自定义实现悬停态监听,可以限制设备进入悬停态的场景(例如仅允许在横屏下半折叠时进入悬停态)以及自定义窗口旋转策略,使用更加灵活。
FolderStack | FoldSplitContainer | 自定义实现悬停态 | |
|---|---|---|---|
展开态/折叠态是否支持自定义布局 | 支持 | 不支持,固定二分栏/三分栏 | 支持 |
是否支持由其他页面进入悬停态页面 | 支持 | 支持 | 支持 |
是否支持自定义设备状态进入悬停态页面 | 不支持 | 不支持 | 支持 |
是否支持自定义悬停态窗口旋转策略 | 不支持 | 不支持 | 支持 |
开发难度 | 简单 | 简单 | 困难 |
本文以视频播放类应用的全屏播放页面为例,介绍FolderStack的自定义悬停态实现。同时,以游戏界面为例,介绍FoldSplitContainer的悬停态实现。

FolderStack是系统提供的ArkTS组件,继承自层叠布局(Stack)。在Stack组件的基础上,FolderStack提供监控设备是否进入悬停态并进行重新布局的能力。
FolderStack通过upperItems字段来实现悬停态布局,当设备进入悬停态时,被upperItems字段修饰的组件会堆叠在上半屏,其他未被修饰的组件会堆叠在下半屏并且自动避让折叠屏折痕区。
FolderStack需要撑满页面全屏,如果不撑满页面全屏,则只作为普通Stack使用。
使用FolderStack组件实现悬停态的代码时,将页面的父容器设置为FolderStack,并将视频播放组件的ID注册到upperItems数组中。这样,悬停态时视频播放组件会自动调整到上半屏显示,视频控制组件和顶部返回组件则显示在下半屏。
FolderStack({ upperItems: ['upper'] }) {
VideoPlayView({ avPlayerUtil: this.avPlayerUtil })
.id('upper')
VideoControlView({ avPlayerUtil: this.avPlayerUtil })
BackTitleView({
title: Const.PAGE_TITLES[0]
})
} 
FoldSplitContainer是系统提供的分栏类型的ArkTS组件,支持在展开态、悬停态及折叠态下对二分栏和三分栏进行区域布局控制。其中二分栏是上下分栏,三分栏是在二分栏基础上加上侧边栏。
FoldSplitContainer的primary和secondary参数分别设置二分栏的上下区域的布局,extra参数设置三分栏中侧栏区域的布局;通过LayoutOptions参数设置各区域分栏的比例。当设备进入悬停态时,FoldSplitContainer会自动避让折叠屏折痕区。

使用FoldSplitContainer组件实现悬停态的代码结构是将上下屏的组件分别注册到primary和secondary参数的回调中。这样页面呈现为上下分栏布局,并且会在悬停态自动避让折痕区域。二分栏结构已实现页面布局,因此未实现extra参数对应的侧栏。
FoldSplitContainer({
primary: () => {
this.primaryArea();
},
secondary: () => {
this.secondaryArea();
}
}) 
自定义悬停态布局需要在折叠屏进入悬停态时通过规避折痕避让区,调整页面内组件的尺寸和位置来实现,可分为监听悬停态和调整布局两部分。
自定义悬停态的视频播放页UI结构较自由,主要实现悬停态监听和组件重新布局。
多设备场景库封装了悬停态的判断条件,并提供了isHover状态变量,开发者无需关心折叠屏设备的差异,即可高效配悬停态场景。
在EntryAbility中引入多设备场景库并初始化。
const abilityRegi: AbilityRegister = new AbilityRegister(data);
AppStorage.setOrCreate('multidevicelibrary.abilities', abilityRegi.registerContext('defaults')); 通过多设备场景库获取悬停态变量isHover和折痕区变量creaseTopVp,creaseHeightVp。
@StorageLink('multidevicelibrary.abilities') @Watch('hoverChange') ctx:
DefaultContext<Record<keyof string, ConditionValue>> | undefined = undefined;
@State isHover: boolean = this.ctx?.getField('isHover') as boolean ?? false;
@State creaseTopVp: number = this.ctx?.getField('creaseTopVp') as number ?? 0;
@State creaseHeightVp: number = this.ctx?.getField('creaseHeightVp') as number ?? 0;
private videoHeight: number = DeviceScreen.getDeviceHeight();
private avPlayerUtil?: AvPlayerUtil;
private xComponentController: XComponentController = new XComponentController();
private DEFAULT_VIDEO_RATIO = 1.78
hoverChange() {
this.isHover = this.ctx?.getField('isHover') as boolean ?? false;
this.creaseTopVp = this.ctx?.getField('creaseTopVp') as number ?? 0;
this.creaseHeightVp = this.ctx?.getField('creaseHeightVp') as number ?? 0;
Logger.info(`Hover state change ${this.isHover}, ${this.creaseTopVp}, ${this.creaseHeightVp}.`);
try {
if (this.windowObj) {
const screenWidth: number = this.windowObj.getWindowProperties().windowRect.width;
let currentVideoHeight = this.getUIContext().px2vp(screenWidth) / this.DEFAULT_VIDEO_RATIO;
this.videoHeight = currentVideoHeight > this.creaseTopVp ? this.creaseTopVp : currentVideoHeight;
}
} catch (error) {
Logger.error(`Window properties get failed, code: ${error.code}, message: ${error.message}.`);
}
} try {
if (this.windowObj) {
const screenWidth: number = this.windowObj.getWindowProperties().windowRect.width;
let currentVideoHeight = this.getUIContext().px2vp(screenWidth) / this.DEFAULT_VIDEO_RATIO;
this.videoHeight = currentVideoHeight > this.creaseTopVp ? this.creaseTopVp : currentVideoHeight;
}
} catch (error) {
Logger.error(`Window properties get failed, code: ${error.code}, message: ${error.message}.`);
} XComponent({
id: 'home',
type: XComponentType.SURFACE,
controller: this.xComponentController
})
.onLoad(() => {
// ...
})
.aspectRatio(this.DEFAULT_VIDEO_RATIO)
.height(this.isHover ? this.videoHeight : -1) 处于悬停态时,视频播放组件将上移至屏幕上方。
Column() {
XComponent({
id: 'home',
type: XComponentType.SURFACE,
controller: this.xComponentController
})
// ...
}
.justifyContent(this.isHover ? FlexAlign.Start : FlexAlign.Center)
.height(CommonConstants.FULL_PERCENT)
.width(CommonConstants.FULL_PERCENT) 视频控制组件位于下半屏,无需调整。
Column() {
Row() {
TimeText({ time: this.currentTime })
.margin({
left: 36,
right: 2
})
// ...
}
.height(CommonConstants.FULL_PERCENT)
.width(CommonConstants.FULL_PERCENT)
.justifyContent(FlexAlign.End)
.visibility(Visibility.Visible) 