【中工开发者】鸿蒙——沉浸式页面的开发

wx6750468446c7a
发布于 2024-12-7 17:42
浏览
0收藏


简介

本项目介绍了设置窗口全屏和扩展组件安全区域两种实现沉浸式效果的方式,并对状态栏、导航栏、挖空区域根据不同场景进行适配,为用户提供更优的视觉体验。

部分页面展示

【中工开发者】鸿蒙——沉浸式页面的开发-鸿蒙开发者社区

【中工开发者】鸿蒙——沉浸式页面的开发-鸿蒙开发者社区

【中工开发者】鸿蒙——沉浸式页面的开发-鸿蒙开发者社区首页

【中工开发者】鸿蒙——沉浸式页面的开发-鸿蒙开发者社区商城页

【中工开发者】鸿蒙——沉浸式页面的开发-鸿蒙开发者社区游戏页

部分代码展示

  1. import{ Shopping, ProductDetail, FaqList, ShoppingFullScreen }from'shopping';
  2. import{ Route, ROUTES }from'../constants/Constants';
  3. import{ VideoPlayer }from'./VideoPlayer';
  4. import{ MiniGame }from'./MiniGame';
  5. import{ MusicPlayer }from'./MusicPlayer';
  6. @Entry
  7. @Component
  8. struct Index
  9. @ProvidenavPageInfos: NavPathStack =newNavPathStack();

  10. go(to:string|undefined) {
  11. if(!to) {
  12. return;
  13. }
  14. this.navPageInfos.pushPath({name: to });
  15. }

  16. @Builder
  17. NavPageMap(name:string) {
  18. if(name ==='Shopping') {
  19. Shopping();
  20. }elseif(name ==='ProductDetail') {
  21. ProductDetail();
  22. }elseif(name ==='FaqList') {
  23. FaqList();
  24. }elseif(name ==='VideoPlayer') {
  25. VideoPlayer();
  26. }elseif(name ==='MiniGame') {
  27. MiniGame();
  28. }elseif(name ==='MusicPlayer') {
  29. MusicPlayer();
  30. }elseif(name ==='ShoppingFullScreen') {
  31. ShoppingFullScreen()
  32. }
  33. }

  34. build() {
  35. Navigation(this.navPageInfos) {
  36. Column() {
  37. Text($r('app.string.title'))
  38. fontWeight(FontWeight.Bold)
  39. fontSize(30)
  40. fontColor('#E6000000')
  41. width('100%')
  42. height(140)
  43. ForEach(ROUTES, (route: Route) =>
  44. Text(route.title)
  45. width('100%')
  46. fontColor('#99000000')
  47. fontSize(18)
  48. Column() {
  49. ForEach(route.children || [], (routeItem: Route, index) =>
  50. if(index !==0) {
  51. Divider()
  52. color('#0D000000')
  53. strokeWidth(0.5)
  54. }
  55. Row() {
  56. Text(routeItem.title)
  57. fontWeight(FontWeight.Medium)
  58. Blank()
  59. Image($r('app.media.arrow_right'))
  60. width(24)
  61. height(24)
  62. }
  63. width('100%')
  64. padding({top:12,bottom:12})
  65. onClick(() => this.go(routeItem.to))
  66. (routerItem: Route) => JSON.stringify(routerItem))
  67. }
  68. width('100%')
  69. backgroundColor(Color.White)
  70. borderRadius(20)
  71. margin({top:16,bottom:28})
  72. padding({left:12,right:12})
  73. (route: Route) => JSON.stringify(route))
  74. }
  75. width('100%')
  76. height('100%')
  77. backgroundColor('#F1F3F5')
  78. padding(16)
  79. }
  80. hideToolBar(true)
  81. hideTitleBar(true)
  82. mode(NavigationMode.Stack)
  83. navDestination(this.NavPageMap)
  84. }
  85. }

使用说明:

  1. 首页列出了沉浸式页面的实现方式和常见场景,点击对应的菜单项进入即可。
  2. 商城首页中点击某个商品进入商品详情页,点击详情页中常见问题区域进入商品常见问题页面,下滑到观察列表底部的避让情况。
  3. 避让挖孔的小游戏页面可通过切换不同挖孔位置的机型观察避让挖孔功能。

工程目录

├──commons
│  ├──commons/src/main/ets
│  │  └──utils	                    
│  │     └──Breakpoint.ets                 // 断点处理模块
│  └──commons/src/main/resources           // 应用静态资源目录
├──features
│  ├──shopping/src/main/ets
│  │  ├──constants
│  │  │  ├──Detail.ets                     // 商品详情页常量资源
│  │  │  ├──Home.ets                       // 商城首页常量资源
│  │  │  └──Index.ets                      // 商城入口页常量资源
│  │  ├──models
│  │  │  ├──Detail.ets                     // 商品详情页数据
│  │  │  ├──Home.ets                       // 商城首页数据
│  │  │  └──Index.ets                      // 商城入口页数据
│  │  └──views	                    
│  │     ├──detail
│  │     │  ├──Banner.ets                  // 商品详情页图片展示模块
│  │     │  ├──Discount.ets                // 商品详情页折扣模块
│  │     │  ├──Faq.ets                     // 商品详情页常见问题模块
│  │     │  ├──FaqList.ets                 // 常见问题列表页
│  │     │  ├──Footer.ets                  // 商品详情页底部按钮
│  │     │  ├──Index.ets                   // 商品详情页
│  │     │  ├──Information.ets             // 商品详情页详细信息模块
│  │     │  └──Toolbar.ets                 // 商品详情页顶部工具栏
│  │  	 ├──home
│  │     │  ├──Banner.ets                  // 商城首页图片展示模块
│  │     │  ├──Categories.ets              // 商城首页分类模块
│  │     │  ├──Header.ets                  // 商品首页头部标签栏和搜索栏
│  │     │  ├──Index.ets                   // 商城首页
│  │     │  ├──Recommend.ets               // 商城首页甄选推荐模块
│  │     │  └──Welfare.ets                 // 商城首页福利专区模块
│  │     └──Index.ets                      // 商城入口页面
│  └──shopping/src/main/resources          // 应用静态资源目录
└──products                  
   ├──entry/src/main/ets
   │  ├──constants
   │  │  └──Constants.ets                  // 常量资源
   │  ├──entryability
   │  │  └──EntryAbility.ets               // 程序入口类
   │  └──pages    
   │     ├──Index.ets                      // 主页面     
   │     ├──MiniGame.ets                   // 小游戏页面(避让挖孔场景) 
   │     ├──MusicPlayer.ets                // 音乐播放页面(深色背景状态栏适配场景) 
   │     └──VideoPlayer.ets                // 视频播放页面(隐藏状态栏和导航条场景)
   └──entry/src/main/resources             // 应用静态资源目录

【中工开发者】鸿蒙——沉浸式页面的开发-鸿蒙开发者社区

项目相关描述

具体实现

  1. 使用​​setWindowLayoutFullScreen()​​方法设置窗口全屏或设置​​expandSafeArea​​属性扩展组件安全区域实现沉浸式效果。
  2. 常见沉浸式效果中的具体适配详见代码。

相关权限

不涉及。

依赖

不涉及

约束与限制

1.本示例仅支持标准系统上运行,支持设备:华为手机。

2.HarmonyOS系统:HarmonyOS 5.0.0 Release及以上。

3.DevEco Studio版本:DevEco Studio 5.0.0 Release及以上。

4.HarmonyOS SDK版本:HarmonyOS 5.0.0 Release SDK及以上。

总结

   本项目实现了一些简单的功能,但可以再对其进行完善,从而使其功能种类更加丰富。

分类
收藏
回复
举报
回复
    相关推荐