介绍
本文介绍如何使用high_light_guide三方库完成应用新版本功能导航。通过高亮区域与蒙版背景的明暗度对比,让用户快速锁定重点功能,了解版本变更和业务入口。
效果图预览
使用说明
- 点击页面上对应按钮或空白区域进入下一个提示,直至提示完成。
实现思路
-
在需要使用的页面引入high_light_guide库中的引导页组件。
// 引入引导页组件 import { HighLightGuideBuilder, HighLightGuideComponent, Controller, GuidePage, HighLightShape, RectF } from '@ohos/high_light_guide';
-
初始化引导页构建类,通过addHighLight绑定对应id组件的高光。此案例设定3个addGuidePage引导页配置,每个配置里添加引导页组件。
// 初始化引导页构建类 aboutToAppear() { this.builder = new HighLightGuideBuilder() .alwaysShow(true) .addGuidePage(GuidePage.newInstance()// 设定第一处提示 .setEverywhereCancelable(true)// 允许点击任意处关闭 .addHighLightWithOptions('test', HighLightShape.CIRCLE, options)// 为id为test的组件绑定特定形状高光 .setHighLightIndicator(this.firstIndicator.bind(this)) .setEnterAnimation(this.enterAnimatorParam) .setExitAnimation(this.exitAnimatorParam)) .addGuidePage(GuidePage.newInstance()// 设定第二处提示 .setHighLightIndicator(this.secondIndicator) .setEnterAnimation(this.enterAnimatorParam) .setExitAnimation(this.exitAnimatorParam)) .addGuidePage(GuidePage.newInstance()// 设定第三处提示 .setEverywhereCancelable(false) .setHighLightIndicator(this.thirdIndicator)); }
-
设定各setHighLightIndicator里的引导层布局组件
@Builder private firstIndicator() { ... // 引导层内容 }
-
计算id为test组件处于页面中的位置,为引导说明组件做位置控制。
使用@Provide装饰器和@Consume装饰器:与后代组件双向同步,将基础页面布局中id为test组件的坐标传递给引导页。
@Provide PosX: number = 0; @Provide PosY: number = 0; @State firstIndicatorHeight: number = 0; @Builder private firstIndicator() { ... // 引导层内容:提示文字等 } .onAreaChange((oldValue: Area, newValue: Area) => { this.firstIndicatorHeight = Number(newValue.height);// 获取此引导组件的高度 }) // 此案例x坐标为id为test组件宽度的一半 // y坐标为id为test组件相对于屏幕顶部的距离与自身高度的差值 .position({ x: this.PosX, y: this.PosY - this.firstIndicatorHeight })
@Consume PosX: number; @Consume PosY: number; GridItem() { ... } .onAreaChange((oldValue: Area, newValue: Area) => { this.PosX = Number(newValue.width) / RADIUS;// 此案例需获取此组件宽度的一半,作为演示 this.PosY = Number(newValue.globalPosition.y); })
-
添加引导页布局,通过HighLightGuideComponent的onReady回调参数controller控制引导层初始化显示。
build() { Stack() { ... // 添加引导页布局 HighLightGuideComponent({ highLightContainer: this.HighLightComponent, // 引导页覆盖时的内容布局插槽 currentHLIndicator: null, // 引导页的引导层插槽 builder: this.builder, // 引导页的通用配置构建类 onReady: (controller: Controller) => { // 引导页准备好的回调,获取引导页控制器 this.controller = controller; this.controller.show(); } }) ... } }
-
自定义Builder,设定底层页面基础布局。
@Builder private HighLightComponent() { Column() { ... // 布局内容 } .alignItems(HorizontalAlign.Start) .width('100%') .height('100%'); }
-
通过controller控制引导层跳转和销毁。
this.controller.showPage(1);// 跳转第二个引导页 this.controller.showPage(2);// 跳转第三个引导页 this.controller.remove(); // 移除引导层
高性能知识点
不涉及
工程结构&模块类型
highlightguide // har类型
|---src\main\ets\pages
| |---Index.ets // 功能引导页面
模块依赖
动态路由模块实现页面动态加载 high_light_guide三方库
最后
有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以有一份实用的鸿蒙(HarmonyOS NEXT)资料用来跟着学习是非常有必要的。
这份鸿蒙(HarmonyOS NEXT)资料包含了鸿蒙开发必掌握的核心知识要点,内容包含了(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等)鸿蒙(HarmonyOS NEXT)技术知识点。
希望这一份鸿蒙学习资料能够给大家带来帮助,有需要的小伙伴自行领取,限时开源,先到先得~无套路领取!!
如果你是一名有经验的资深Android移动开发、Java开发、前端开发、对鸿蒙感兴趣以及转行人员,可以直接领取这份资料
获取这份完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料
鸿蒙(HarmonyOS NEXT)最新学习路线
-
HarmonOS基础技能
- HarmonOS就业必备技能
- HarmonOS多媒体技术
- 鸿蒙NaPi组件进阶
- HarmonOS高级技能
- 初识HarmonOS内核
- 实战就业级设备开发
有了路线图,怎么能没有学习资料呢,小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙(OpenHarmony )学习手册(共计1236页)与鸿蒙(OpenHarmony )开发入门教学视频,内容包含:ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。
获取以上完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料
《鸿蒙 (OpenHarmony)开发入门教学视频》
《鸿蒙生态应用开发V2.0白皮书》
《鸿蒙 (OpenHarmony)开发基础到实战手册》
OpenHarmony北向、南向开发环境搭建
《鸿蒙开发基础》
- ArkTS语言
- 安装DevEco Studio
- 运用你的第一个ArkTS应用
- ArkUI声明式UI开发
- .……
《鸿蒙开发进阶》
- Stage模型入门
- 网络管理
- 数据管理
- 电话服务
- 分布式应用开发
- 通知与窗口管理
- 多媒体技术
- 安全技能
- 任务管理
- WebGL
- 国际化开发
- 应用测试
- DFX面向未来设计
- 鸿蒙系统移植和裁剪定制
- ……
《鸿蒙进阶实战》
- ArkTS实践
- UIAbility应用
- 网络案例
- ……
获取以上完整鸿蒙HarmonyOS学习资料,请点击→纯血版全套鸿蒙HarmonyOS学习资料
总结
总的来说,华为鸿蒙不再兼容安卓,对中年程序员来说是一个挑战,也是一个机会。只有积极应对变化,不断学习和提升自己,他们才能在这个变革的时代中立于不败之地。