当前位置：首页 > article >正文

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

article 2025/2/7 9:53:46

在移动应用开发中，有时我们需要将已有的移动端网站嵌入到原生应用中，以实现快速开发和功能扩展。鸿蒙 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 时，需要注意网络安全问题。确保加载的网站是可信的，避免加载恶意网站内容。