鸿蒙5.0开发【适配折叠屏展开与收起，实现单屏与双屏UI的无缝切换】_鸿蒙折叠屏适配

随着移动设备技术不断革新，折叠屏手机以其独特的设计和灵活的显示能力，为用户带来了前所未有的视觉体验。然而，这种新型屏幕形式也对界面设计提出了全新挑战。如何在用户��开或收起折叠屏时，即时响应并做出相应的UI调整，是确保用户体验连贯性的关键。

在这样的背景下，实现界面布局在单屏与双屏模式之间的无缝切换。不仅能让应用在单屏模式下保持简洁优雅，也能在双屏模式下提供更广阔的视野和更丰富的交互体验。

适配前后对比

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

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

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

实时监听折叠屏状态

HarmonyOS NEXT 提供 *媒体查询 (@ohos.mediaquery) *可用于实现监听折叠屏展开、收起变化。

该方法库适用于 鸿蒙APP开发、元服务开发，关键代码如下：

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

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

import mediaquery from '@ohos.mediaquery'

/// 折叠屏幕变化监听
abstract class FoldStatusObserver {
  public static readonly foldStatusKey = 'foldStatusKey'
  private static listener?: mediaquery.MediaQueryListener

  /// 在 MainPage aboutToAppear 生命周期内调用
  public static startListening() {
    FoldStatusObserver.listener = mediaquery.matchMediaSync('screen and (min-width: 400vp)')
    FoldStatusObserver.listener.on('change', FoldStatusObserver.onFoldStatusChange)
  }

  /// 在 MainPage aboutToDisappear 生命周期内调用
  public static stopListening() {
    FoldStatusObserver.listener?.off('change', FoldStatusObserver.onFoldStatusChange)
  }

  /// 在任意 Component 内通过使用 `@StorageProp('foldStatusKey') isFold: boolean = false` 进行监听变化
  private static onFoldStatusChange(result: mediaquery.MediaQueryResult): void {
    const status = AppStorage.get<boolean>(FoldStatusObserver.foldStatusKey)
    if (result.matches !== status) {
      AppStorage.set(FoldStatusObserver.foldStatusKey, result.matches)
    }
  }
}

export { FoldStatusObserver }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

使用方式：

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

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

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

struct MainPage {
  aboutToAppear(): void {
    FoldStatusObserver.startListening()
  }

  aboutToDisappear(): void {
    FoldStatusObserver.stopListening()
  }
}
1
2
3
4
5
6
7
8
9

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

@Component
export struct MyComponent {
  @StorageProp('foldStatusKey') isFold: boolean = false

  build() {
    Stack() {
      if (this.isFold) {
        // 这是折叠屏展开时UI
      } else {
        // 这是折叠屏收起时UI
      }
    }
    .width('100%')
    .height('100%')
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

容器封装与UI自适应

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

• 抛砖引玉，容器封装：

/// 响应折叠屏变化的父容器
@Component
export struct FoldStatusContainer {
  @StorageProp('foldStatusKey') isFold: boolean = false
  // 非折叠状态 UI 布局
  @BuilderParam unFoldBodyContainer: () => void = this.defaultContainer
  // 折叠状态 UI 布局
  @BuilderParam foldBodyContainer: () => void = this.defaultContainer

  @Builder
  defaultContainer() {
    Column()
  }

  build() {
    Stack() {
      if (this.isFold) {
        this.foldBodyContainer()
      } else {
        this.unFoldBodyContainer()
      }
    }
    .width('100%')
    .height('100%')
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

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

// 适配折叠屏示例页面
@Component
export struct FixFoldUiExample {

  @Builder
  unFoldUiContainer() {
    Stack() {
      Text('我是全屏内容').fontSize(20)
    }
    .width('100%')
    .height('100%')
    .backgroundColor(Color.Orange)
  }

  @Builder
  foldUiContainer() {
    Row() {
      Stack() {
        Text('我是左边的分屏内容').fontSize(20)
      }
      .backgroundColor(Color.Grey)
      .height('100%')
      .layoutWeight(1)

      Stack() {
        Text('我是右边的分屏内容').fontSize(20)
      }
      .backgroundColor(Color.Pink)
      .height('100%')
      .layoutWeight(1)
    }
    .width('100%')
    .height('100%')
  }

  @Builder
  bodyContainer() {
    FoldStatusContainer({
      unFoldBodyContainer: this.unFoldUiContainer,
      foldBodyContainer: this.foldUiContainer,
    })
  }

  build() {
    NavDestination() {
      Column() {
        this.bodyContainer()
      }
      .height('100%')
      .width('100%')
      .justifyContent(FlexAlign.Center)
    }.title('适配折叠屏')
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

该页面的效果如下：

总结

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

​
最后呢，很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

​​​​

高清完整版请点击→《鸿蒙NEXT星河版开发学习文档》

针对鸿蒙成长路线打造的鸿蒙学习文档。话不多说，我们直接看详细资料鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，帮助大家在技术的道路上更进一步。

《鸿蒙 (OpenHarmony)开发学习视频》

《鸿蒙生态应用开发V2.0白皮书》

《鸿蒙 (OpenHarmony)开发基础到实战手册》

《鸿蒙开发基础》

《鸿蒙开发进阶》

《鸿蒙开发实战》

获取这份鸿蒙星河版学习资料，请点击→《鸿蒙NEXT星河版开发学习文档》

总结

鸿蒙—作为国家主力推送的国产操作系统。部分的高校已经取消了安卓课程，从而开设鸿蒙课程；企业纷纷跟进启动了鸿蒙研发。

并且鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，未来将会支持 50 万款的应用。那么这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！