HarmonyOS基本工具封装——JumpUtils可自定参数跳转PkWebView页面

前言

BasicLibrary是一个基于API 11封装的基本库
未来的计划是将其打造成一个通用的UI组件+基本工具组件，目前只做了部分基本工具组件，大家如果组件有什么需求，可以尽管提哦
BasicLibrary项目地址
BasicLibrary的openHarmony三方库中心仓

简介

鸿蒙基本库封装，提升鸿蒙开发效率

安装

ohpm install @peakmain/library

介绍

实现原生与H5高效通信

导入依赖

javascript 复制代码

import {JumpUtils}from '@peakmain/library'

1.1 跳转H5页面，携带token

public static jumpToH5(url: string, showTitle: boolean = true):void

参数

参数	参数类型	是否必填	说明
url	string	是	跳转url
showTitle	boolean	否	是否显示导航栏，默认为true，表示显示

1.2 跳转到H5页面，携带token的同时携带version

public static jumpToH5AddVersion(url: string, showTitle: boolean = true):void

参数

参数	参数类型	是否必填	说明
url	string	是	跳转url
showTitle	boolean	否	是否显示导航栏，默认为true，表示显示

1.3 跳转H5，拼接若干个参数

jumpToH5AddParams(url: string, showTitle: boolean = true, params: Map<string, string | number | boolean>,isAddToken: boolean = false):void

参数

参数	参数类型	是否必填	说明
url	string	是	跳转url
showTitle	boolean	否	是否显示导航栏，默认为true，表示显示
params	Map<string, string \| number \| boolean>	是	需要拼接的参数
isAddToken	boolean	否	是否拼接token，默认是false

1.4 为url添加版本号

static addVersionToUrl(url: string):string

参数

参数	参数类型	是否必填	说明
url	string	是	跳转url

1.5 为url添加token

static addTokenToUrl(url: string):string

参数

参数	参数类型	是否必填	说明
url	string	是	跳转url

1.6 跳转H5,自定义参数

public static jumpToH5ByBean(bean: WebViewBean)

参数

| 参数 | 参数类型 | 说明 |
|-----------------------------|-------------------------------------------------------|----------------------------------------------------------|----------------------------------------------------|
| showTitle | boolean | 是否显示标题，默认为 true |
| url | string | 网页的 URL，默认为空字符串 |
| backgroundColorResource | ResourceColor | 背景颜色资源，默认为白色 |
| leftImage | PixelMap | ResourceStr | DrawableDescriptor | | null | 左边箭头的图片资源，默认为 $r("app.media.ic_public_left_arrow") | | titleColor | ResourceColor | 标题颜色资源，默认为$ r("app.color.color_272a2b") |
| titleBold | number | FontWeight | string | 标题字体粗细，默认为粗体 |
| rightText | string | 右边显示的内容，默认为空字符串 |
| rightImage | PixelMap | ResourceStr | DrawableDescriptor | null | 右边的图片资源，默认为 null |
| showStatusBar | boolean | 是否显示状态栏，默认为 true |
| rightClick（setter） | () => void | 右边点击事件的回调函数，设置后会将该回调赋值给 WebViewManager 实例的 rightClick 属性 |
| onTitleReceiveEvent（setter） | Callback | 标题接收事件的回调函数，设置后会将该回调赋值给 WebViewManager 实例的 callback 属性 |

示例代码

跳转H5，修改状态栏为红色

ini 复制代码

let bean = new WebViewBean();
bean.url = this.url
bean.backgroundColorResource = Color.Red
bean.titleColor = Color.White
bean.leftImage = $r("app.media.app_icon")
JumpUtils.jumpToH5ByBean(bean)

跳转H5，添加右边按钮

ini 复制代码

let bean = new WebViewBean();
bean.url = this.url
bean.rightText = "去登录"
bean.rightClick = () => {
  new ToastManager(this.getUIContext()).showNormalMessage("点击去登录")
}
JumpUtils.jumpToH5ByBean(bean)

跳转H5，自定义拦截标题

ini 复制代码

let bean = new WebViewBean();
bean.url = this.url
bean.onTitleReceiveEvent = (event) =
  if (event.title.startsWith("首页")) 
    event.title = "peakmain"
  }
}
JumpUtils.jumpToH5ByBean(bean)