HarmonyOS ：适配折叠屏展开与收起，实现单屏与双屏UI的无缝切换 ...

引言

随着移动设备技能不停革新，折叠屏手机以其独特的设计和灵活的表现能力，为用户带来了亘古未有的视觉体验。然而，这种新型屏幕情势也对界面设计提出了全新挑战。如安在用户展开或收起折叠屏时，即时相应并做出相应的UI调解，是确保用户体验连贯性的关键。
在如许的背景下，实现界面布局在单屏与双屏模式之间的无缝切换。不但能让应用在单屏模式下保持简便优雅，也能在双屏模式下提供更广阔的视野和更丰富的交互体验。
适配前后对比

• 适配前不做任何处理惩罚，UI布局会根据折叠屏的展开、收起自适应屏幕，示比方下：
  

• 适配后，单屏、双屏各自一套 UI 设计 可根据折叠屏的展开、收起两种状态，实现差异性UI交互设计，示比方下：
  

   现实开发中，我们可以在同一个页面，共用一套数据，实现从单屏到双屏的平滑过渡，让用户在使用过程中感受到无缝的体验。
  及时监听折叠屏状态

HarmonyOS NEXT 提供 媒体查询 (@ohos.mediaquery) 可用于实现监听折叠屏展开、收起变革。
该方法库适用于 鸿蒙APP开发、元服务开发，关键代码如下：

1. listener = mediaquery.matchMediaSync('(min-width: 400vp)')
2. onPortrait(mediaQueryResult:mediaquery.MediaQueryResult) {
3.     if (mediaQueryResult.matches) {
4.       // 展开态
5.     } else {
6.       // 折叠态
7.     }
8. }   

复制代码

为了方便，我们可把该能力封装成工具类：

1. import mediaquery from '@ohos.mediaquery'
3. /// 折叠屏幕变化监听
4. abstract class FoldStatusObserver {
5.   public static readonly foldStatusKey = 'foldStatusKey'
6.   private static listener?: mediaquery.MediaQueryListener
8.   /// 在 MainPage aboutToAppear 生命周期内调用
9.   public static startListening() {
10.     FoldStatusObserver.listener = mediaquery.matchMediaSync('screen and (min-width: 400vp)')
11.     FoldStatusObserver.listener.on('change', FoldStatusObserver.onFoldStatusChange)
12.   }
14.   /// 在 MainPage aboutToDisappear 生命周期内调用
15.   public static stopListening() {
16.     FoldStatusObserver.listener?.off('change', FoldStatusObserver.onFoldStatusChange)
17.   }
19.   /// 在任意 Component 内通过使用 `@StorageProp('foldStatusKey') isFold: boolean = false` 进行监听变化
20.   private static onFoldStatusChange(result: mediaquery.MediaQueryResult): void {
21.     const status = AppStorage.get<boolean>(FoldStatusObserver.foldStatusKey)
22.     if (result.matches !== status) {
23.       AppStorage.set(FoldStatusObserver.foldStatusKey, result.matches)
24.     }
25.   }
26. }
28. export { FoldStatusObserver }

复制代码

使用方式：

• 第一步，在 EntryAbility onCreate 生命周期内设置默认值：
  

1. onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
2.   hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
3.   AppStorage.setOrCreate('foldStatusKey', false)
4. }

复制代码

• 第二步，在 MainPage aboutToAppear、aboutToDisappear 生命周期内开启、关闭折叠状态监听：
  

1. struct MainPage {
2.   aboutToAppear(): void {
3.     FoldStatusObserver.startListening()
4.   }
6.   aboutToDisappear(): void {
7.     FoldStatusObserver.stopListening()
8.   }
9. }

复制代码

• 第三步，在恣意 Component 内通过使用 @StorageProp(‘foldStatusKey’) isFold 举行监听折叠屏状态变革
  

1. @Component
2. export struct MyComponent {
3.   @StorageProp('foldStatusKey') isFold: boolean = false
5.   build() {
6.     Stack() {
7.       if (this.isFold) {
8.         // 这是折叠屏展开时UI
9.       } else {
10.         // 这是折叠屏收起时UI
11.       }
12.     }
13.     .width('100%')
14.     .height('100%')
15.   }
16. }

复制代码

容器封装与UI自适应

封装一个相应折叠状态变革的父容器，我们可以在需要折叠屏差异化设计的页面，通过使用父容器的方式让代码变得更简便。

• 抛砖引玉，容器封装：
  

1. /// 响应折叠屏变化的父容器
2. @Component
3. export struct FoldStatusContainer {
4.   @StorageProp('foldStatusKey') isFold: boolean = false
5.   // 非折叠状态 UI 布局
6.   @BuilderParam unFoldBodyContainer: () => void = this.defaultContainer
7.   // 折叠状态 UI 布局
8.   @BuilderParam foldBodyContainer: () => void = this.defaultContainer
10.   @Builder
11.   defaultContainer() {
12.     Column()
13.   }
15.   build() {
16.     Stack() {
17.       if (this.isFold) {
18.         this.foldBodyContainer()
19.       } else {
20.         this.unFoldBodyContainer()
21.       }
22.     }
23.     .width('100%')
24.     .height('100%')
25.   }
26. }

复制代码

• 在需要折叠屏差异化UI设计的页面里，我们如许使用 FoldStatusContainer ：
  

1. // 适配折叠屏示例页面
2. @Component
3. export struct FixFoldUiExample {
5.   @Builder
6.   unFoldUiContainer() {
7.     Stack() {
8.       Text('我是全屏内容').fontSize(20)
9.     }
10.     .width('100%')
11.     .height('100%')
12.     .backgroundColor(Color.Orange)
13.   }
15.   @Builder
16.   foldUiContainer() {
17.     Row() {
18.       Stack() {
19.         Text('我是左边的分屏内容').fontSize(20)
20.       }
21.       .backgroundColor(Color.Grey)
22.       .height('100%')
23.       .layoutWeight(1)
25.       Stack() {
26.         Text('我是右边的分屏内容').fontSize(20)
27.       }
28.       .backgroundColor(Color.Pink)
29.       .height('100%')
30.       .layoutWeight(1)
31.     }
32.     .width('100%')
33.     .height('100%')
34.   }
36.   @Builder
37.   bodyContainer() {
38.     FoldStatusContainer({
39.       unFoldBodyContainer: this.unFoldUiContainer,
40.       foldBodyContainer: this.foldUiContainer,
41.     })
42.   }
44.   build() {
45.     NavDestination() {
46.       Column() {
47.         this.bodyContainer()
48.       }
49.       .height('100%')
50.       .width('100%')
51.       .justifyContent(FlexAlign.Center)
52.     }.title('适配折叠屏')
53.   }
54. }

复制代码

该页面的效果如下：

总结

• 通过适配折叠屏，用户可以在不同形态下获得最佳的交互体验，无论是单屏还是展开后的双屏模式。
  
• 折叠屏为UI设计提供了新的交互方式，如拖拽、分屏等，适配后的应用可以利用这些特性创造新的用户交互体验。
  

更新

从 API version 12开始，支持在元服务中使用以下 api 举行折叠屏适配

• 检查设备是否可折叠：链接
  

1. import { display } from '@kit.ArkUI';
3. let ret: isFoldable = display.isFoldable();

复制代码

• 获取可折叠设备的当前折叠状态：链接
  

1. import { display } from '@kit.ArkUI';
3. let data: display.FoldStatus = display.getFoldStatus();

复制代码

• 开启折叠设备折叠状态变革的监听：链接
  

1. import { Callback } from '@kit.BasicServicesKit';
3. let callback: Callback<display.FoldStatus> = (data: display.FoldStatus) => {
4.     console.info('Listening enabled. Data: ' + JSON.stringify(data));
5. };
6. display.on('foldStatusChange', callback);

复制代码

附注（Example）

Demo 示例已上传：
GitHub：https://github.com/liyufengrex/HarmonyAtomicService
GitCode：https://gitcode.com/liyufengrex/HarmonyAtomicService
（基于API11开发，支持NEXT及以上版本运行）已上传可供参考，包含如下内容：

• 静态库+动态包+多模块设计
  
• 状态管理
  
• 统一路由管理（router+navPathStack）
  
• 网络哀求、Loading 等工具库封装
  
• 自定义组件、自定义弹窗（解耦）
  
• EventBus 变乱通知
  
• 扩展修饰器，实现 节省、防抖、权限申请
  
• 动态路由 （navPathStack + 动态import + WrappedBuilder）
  
• UI动态节点操作 (BuilderNode + NodeController)
  
• 折叠屏适配示例
  
• 组件工厂示例
  
• 组件动态属性设置示例
  
• 云函数、云数据库使用示例
  
• 华为账号服务示例（快速登岸、快速验证手机号）
  

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。