鸿蒙 Next 开发实践：使用 WebView 适配移动端网站

2025/2/10 17:31:56 来源：https://blog.csdn.net/lbcyllqj/article/details/145480575 浏览: 次关键词：鸿蒙 Next 开发实践：使用 WebView 适配移动端网站

在移动应用开发中，有时我们需要将已有的移动端网站嵌入到原生应用中，以实现快速开发和功能扩展。鸿蒙 Next 提供了强大的 WebView 组件，可以轻松实现这一目标。本文将通过一个简单的示例，展示如何在鸿蒙 Next 应用中使用 WebView 适配已经做好的移动端网站。

效果图

场景背景

假设我们已经有一个移动端网站，例如一个查询系统https://lefu.lesaosao.cn/chaxun/#/Indexhttps://lefu.lesaosao.cn/chaxun/#/Index%EF%BC%89%EF%BC%8C%E7%8E%B0%E5%9C%A8%E9%9C%80%E8%A6%81%E5%B0%86%E5%85%B6%E5%B5%8C%E5%85%A5%E5%88%B0%E9%B8%BF%E8%92%99 现在需要将其嵌入到鸿蒙Next 应用中，让用户可以在原生应用中直接访问该网站的功能。

鸿蒙 Next WebView 组件介绍

WebView 是鸿蒙 Next 提供的一个用于加载网页的组件。它支持加载本地 HTML 文件或网络 URL，并且可以与原生应用进行交互。通过 WebView，我们可以在鸿蒙应用中无缝嵌入网页内容。

示例代码

以下是一个简单的示例代码，展示如何在鸿蒙 Next 应用中嵌入移动端网站。

import { webview } from '@kit.ArkWeb';@Entry
@Component
struct WebComponent {controller: webview.WebviewController = new webview.WebviewController();build() {Column() {Web({ src: 'https://lefu.lesaosao.cn/chaxun/#/Index', controller: this.controller }).domStorageAccess(true)}}onBackPress() {// 当前页面是否可前进或者后退给定的step步(-1),正数代表前进，负数代表后退if (this.controller.accessStep(-1)) {this.controller.backward(); // 返回上一个web页// 执行用户自定义返回逻辑return true;} else {// 执行系统默认返回逻辑，返回上一个page页return false;}}
}

代码解析

导入 WebView 模块

import { webview } from '@kit.ArkWeb';

通过导入@kit.ArkWeb模块，我们可以使用 WebView 相关的功能。

定义组件

@Entry
@Component
struct WebComponent {controller: webview.WebviewController = new webview.WebviewController();
}

定义一个名为WebComponent的组件，并初始化一个WebviewController，用于控制 WebView 的行为。

构建界面

build() {Column() {Web({ src: 'https://lefu.lesaosao.cn/chaxun/#/Index', controller: this.controller }).domStorageAccess(true)}
}

在build方法中，我们使用Column布局，并嵌入一个Web组件。通过src属性指定要加载的网页地址，并将controller绑定到Web组件上。domStorageAccess(true)允许网页使用 DOM 存储功能。

处理返回按键

onBackPress() {if (this.controller.accessStep(-1)) {this.controller.backward();return true;} else {return false;}
}

重写onBackPress方法，当用户点击返回按键时，检查 WebView 是否可以后退。如果可以后退，则调用backward方法返回上一个网页；否则，执行系统默认的返回逻辑。

适配移动端网站的注意事项

网页响应式设计 确保嵌入的移动端网站采用了响应式设计，能够自适应不同尺寸的屏幕。如果网站未进行响应式设计，可能需要与前端开发团队合作，优化网页的适配性。
交互体验 考虑到用户体验，可以在 WebView 中添加一些原生的交互功能。例如，自定义返回按钮、加载进度条等。
安全问题 加载网络 URL 时，需要注意网络安全问题。确保加载的网站是可信的，避免加载恶意网站内容。