【鸿蒙 HarmonyOS 4.0】Web组件

一、介绍

页面加载是Web组件的基本功能。根据页面加载数据来源可以分为三种常用场景，包括加载网络页面、加载本地页面、加载HTML格式的富文本数据。

二、加载网页

2.1、加载在线网页

Web组件的使用非常简单，只需要在Page目录下的ArkTS文件中创建一个Web组件，传入两个参数就可以了。其中src指定引用的网页路径，controller为组件的控制器，通过controller绑定Web组件，用于实现对Web组件的控制。

import webview from '@ohos.web.webview'
@Entry
@Component
struct WebPage {private controller:WebviewController = new webview.WebviewControllerbuild() {Column(){Web({src:'https://blog.csdn.net/weixin_71403100?spm=1000.2115.3001.5343',controller:this.controller})}}
}

代码运行效果图如下：

备注：预览器是打不开此页面的，需要使用本地模拟器或真机调试

访问在线网页时您需要在module.json5文件中申明网络访问权限：ohos.permission.INTERNET。

{"module" : {"requestPermissions":[{"name": "ohos.permission.INTERNET"}]}
}

2.2、加载本地网页

前面实现了Web组件加载在线网页，Web组件同样也可以加载本地网页。首先在main/resources/rawfile目录下创建一个HTML文件，然后通过$rawfile引用本地网页资源，示例代码如下：

import webview from '@ohos.web.webview'
@Entry
@Component
struct WebPage {private controller:WebviewController = new webview.WebviewControllerbuild() {Column(){Web({src:$rawfile('index.html'),controller:this.controller})}}
}

main/resources/rawfile目录下创建的HTML文件代码如下：

<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Document</title><style>p{font-size: 50px;text-align: center;color: red;}</style>
</head>
<body><p>Hello World</p>
</body>
</html>

代码运行效果图如下：

三、网页缩放

有的网页可能不能很好适配手机屏幕，需要对其缩放才能有更好的效果，可以根据需要给Web组件设置zoomAccess属性，zoomAccess用于设置是否支持手势进行缩放，默认允许执行缩放。Web组件默认支持手势进行缩放。

Web({ src:'www.example.com', controller:this.controller }).zoomAccess(true)

如果需要对文本进行缩放，可以使用textZoomAtio(textZoomAtio: number)方法。其中textZoomAtio用于设置页面的文本缩放百分比，默认值为100，表示100%，以下示例代码将文本放大为原来的1.5倍。

Web({ src:'www.example.com', controller:this.controller }).textZoomAtio(150)

从上面的效果图可以看出使用textZoomAtio，文本会放大，但是图片不会随着文本一起放大。

四、处理页面导航

在使用浏览器浏览网页时，可以执行返回、前进、刷新等操作，Web组件同样支持这些操作。

import webview from '@ohos.web.webview'
@Entry
@Component
struct WebPage {private controller:WebviewController = new webview.WebviewControllerbuild() {Column(){Row(){Button('前进').onClick(()=>this.controller.forward())Button('后退').onClick(()=>this.controller.backward())Button('刷新').onClick(()=>this.controller.refresh())Button('停止').onClick(()=>this.controller.stop())Button('清除历史').onClick(()=>this.controller.clearHistory())}.padding(12).backgroundColor(Color.Gray).width('100%')Web({src:'https://developer.harmonyos.com/',controller:this.controller})}.height('100%')}
}

五、Web和JavaScript交互

在开发专为适配Web组件的网页时，您可以实现Web组件和JavaScript代码之间的交互。Web组件可以调用JavaScript方法，JavaScript也可以调用Web组件里面的方法。

在main/resources/rawfile目录下创建login.html、login.css、login.js文件

5.1、启用JavaScript

Web({ src:'https://www.example.com', controller:this.controller }).javaScriptAccess(true)

5.2、Web组件调用JS方法

点击按钮添加runJavaScript方法，事件是网页加载完成时的回调，runJavaScript方法可以执行HTML中的JavaScript脚本。

import webview from '@ohos.web.webview'
@Entry
@Component
struct WebPage {private controller:WebviewController = new webview.WebviewControllerbuild() {Column(){Button('获取js中的方法').onClick(()=>{this.controller.runJavaScript('getUserInfo()',(err,res)=>{if(!err){console.log('lucy',res)}})})Web({src:$rawfile('login.html'),controller:this.controller}).javaScriptAccess(true)}.height('100%')}
}

当页面加载完成时，触发点击事件，调用HTML文件中的getUserInfo()方法并将结果返回给Web组件。

5.3、JS调用Web组件方法

import webview from '@ohos.web.webview'
@Entry
@Component
struct WebPage {private controller:WebviewController = new webview.WebviewControllerbuild() {Column(){Button('注册信息到js中').onClick(()=>{this.controller.registerJavaScriptProxy({getAuth:()=>JSON.stringify({username:'tom',password:'123'})},'windowarkTs',['getAuth'])this.controller.refresh()})Web({src:$rawfile('login.html'),controller:this.controller}).javaScriptAccess(true)}.height('100%')}
}

//login.js文件代码
username.value = JSON.parse(windowarkTs.getAuth()).username
password.value = JSON.parse(windowarkTs.getAuth()).passwordconst handlelogin = () => {console.log(`lucy--用户名---${username.value}`);console.log(`lucy--密码---${password.value}`);
}const getUserInfo = ()=>{return {username:username.value,password:password.value}
}

点击按钮时，直接将getAuth里面的信息注册到js中