纯血鸿蒙APP实战开发——页面间共享组件实例的案例

05-13 1981阅读

介绍

本示例提供组件实例在页面间共享的解决方案：通过Stack容器，下层放地图组件，上层放Navigation组件来管理页面，页面可以共享下层的地图组件，页面中需要显示地图的区域设置为透明，并参考触摸交互控制，设置事件透传及响应区域。

效果图预览

使用说明

页面间共享地图组件的场景：

使用地图组件替换代码中模拟的地图组件。
添加新页面，需要预留地图组件的显示区域，参考首页代码的实现。
其他组件实例共享的场景：
- 参考实现思路即可。
  实现思路
  
  场景：组件实例页面间共享
  
  本示例实现模拟的地图组件实例在两个页面间共享。
  - 通过Stack容器，下层放地图组件，上层放Navigation组件管理两个页面，且需要设置Navigation组件的事件透传到地图组件，源码参考。
```
  build() {
    Stack({alignContent: Alignment.Bottom}) {
      // 地图组件放在底层，navigation组件放在上层，navigation中的页面需要显示地图组件的位置处设置透明和事件透传
      MapComponent()
      // 应用主页用NavDestination承载，Navigation为空页面直接跳转到MainPage主页面
      Navigation(this.pageStackForComponentSharedPages) {
      }
      .onAppear(()=>{
        this.pageStackForComponentSharedPages.pushPathByName("MainPage", null, false)
      })
      .hideTitleBar(true)
      // navigation组件设置事件透传给兄弟组件
      .hitTestBehavior(HitTestMode.Transparent)
      .navDestination(this.pageMap)
    }
    .width('100%')
    .height('100%')
  }
```
    - Navigation中的页面需要显示地图的区域设置透明,由于本示例主页面是一个Scroll，所以选择放一个空的Column容器组件占位，默认是透明源码参考。
```
 // 页面用于显示地图的区域，放一个空的容器组件，背景默认透明，来显示下层的地图组件（该组件父组件也需要设置透明）
 Column() {
 }
 .width('100%')
 .height(this.transParentInitHeight)
```
      - 为避免上层内容区域(非透明区域)的事件也影响下层地图组件，需要分别设置地图组件和内容区域对事件的响应范围，两组响应区域不重叠，随内容区域的变化而变化。
        // 地图组件的手势事件响应区域设置 .responseRegion({ x: 0, y: 0, width: '100%', height: this.mapResponseRegionHeight })
        
        // 主页面的手势事件响应区域设置 .responseRegion({ x: 0, y: this.mapResponseRegionHeight, width: '100%', height: this.pageHeight - this.mapResponseRegionHeight })
        
        主页面Scroll滑动过程中Column组件(透明，用于显示下层地图组件)逐渐划出页面，地图的显示区域随之变化，因此需要滑动过程中更新地图的事件响应区域源码参考。
        .onScrollFrameBegin((offset) => { this.scrollCurOffset = this.scroller.currentOffset().yOffset; this.mapResponseRegionHeight = this.transParentInitHeight - this.scrollCurOffset > 0 ? this.transParentInitHeight - this.scrollCurOffset:0; return {offsetRemain : offset} })
        
        高性能知识点
        
        ForEach循环渲染会一次性加载所有组件，会导致页面启动时间长，影响用户体验，长列表场景推荐使用数据懒加载，参考优化指导。
        onActionUpdate、onScrollFrameBegin、onAreaChange，这些函数是系统高频回调函数，避免在函数中进行冗余或耗时操作。例如应该减少或避免在函数打印日志，会有较大的性能损耗。
        工程结构&模块类型
        
        componentinstancesharedinpages // har类型 |---src/main/ets/pages | |---ComponentSharedInPages.ets // 视图层-壳页面 | |---MainPage.ets // 视图层-主页面 | |---TakeTaxiDetailPage.ets // 视图层-打车页面 |---src/main/ets/Components | |---MapComponent.ets // 视图层-地图组件 |---src/main/ets/model | |---CommonConstants.ets // 模型层-通用常量
        
        模块依赖
        
        本实例依赖common模块来实现日志的打印、资源
        的调用，依赖routermodule模块来实现路由注册管理。
        
        参考资料
        
        Stack参考文档
        
        Navigation参考文档
        
        触摸交互控制参考文档
        
        鸿蒙全栈开发全新学习指南
        
        也为了积极培养鸿蒙生态人才，让大家都能学习到鸿蒙开发最新的技术，针对一些在职人员、0基础小白、应届生/计算机专业、鸿蒙爱好者等人群，整理了一套纯血版鸿蒙（HarmonyOS Next）全栈开发技术的学习路线【包含了大APP实战项目开发】。
        
        本路线共分为四个阶段：
        
        第一阶段：鸿蒙初中级开发必备技能
        
        
        
        第二阶段：鸿蒙南北双向高工技能基础：gitee.com/MNxiaona/733GH
        
        第三阶段：应用开发中高级就业技术
        
        
        
        第四阶段：全网首发-工业级南向设备开发就业技术：https://gitee.com/MNxiaona/733GH
        
        《鸿蒙 (Harmony OS)开发学习手册》（共计892页）
        
        如何快速入门？
        
        1.基本概念
        2.构建第一个ArkTS应用
        3.……
        
        开发基础知识:gitee.com/MNxiaona/733GH
        
        1.应用基础知识
        2.配置文件
        3.应用数据管理
        4.应用安全管理
        5.应用隐私保护
        6.三方应用调用管控机制
        7.资源分类与访问
        8.学习ArkTS语言
        9.……
        
        基于ArkTS 开发
        
        1.Ability开发
        2.UI开发
        3.公共事件与通知
        4.窗口管理
        5.媒体
        6.安全
        7.网络与链接
        8.电话服务
        9.数据管理
        10.后台任务(Background Task)管理
        11.设备管理
        12.设备使用信息统计
        13.DFX
        14.国际化开发
        15.折叠屏系列
        16.……
        
        鸿蒙开发面试真题（含参考答案）:gitee.com/MNxiaona/733GH
        
        鸿蒙入门教学视频：
        
        美团APP实战开发教学：gitee.com/MNxiaona/733GH
        
        写在最后
        
        如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我三个小忙：
        点赞，转发，有你们的『点赞和评论』，才是我创造的动力。
        关注小编，同时可以期待后续文章ing🚀，不定期分享原创知识。
        想要获取更多完整鸿蒙最新学习资源，请移步前往小编：gitee.com/MNxiaona/733GH