
//step1：导入依赖webview
import web_webview from '@ohos.web.webview';
 
@Entry
@Component
struct WebComponent {
  webviewController: web_webview.WebviewController = new web_webview.WebviewController();
 
  build() {
    Column() {
      Button('loadUrl')
        .onClick(() => {
          try {
//step3：点击按钮时，通过loadUrl，跳转到指定的网页www.example1.com
            this.webviewController.loadUrl('www.example1.com');
          } catch (error) {
            console.error(`ErrorCode: ${error.code},  Message: ${error.message}`);
          }
        })
//step2：定义Web组件创建时，加载www.example.com
      Web({ src: 'www.example.com', controller: this.webviewController})
    }
  }
}

2.加载本地页面

将本地页面文件放在应用的rawfile目录下，Web组件创建的时候指定默认加载的本地页面，并且加载完成后可通过调用loadUrl()接口变更当前Web组件的页面

step1：创建本地html文件local.html


<!DOCTYPE html>
<html>
  <body>
    <p>Hello World</p>
  </body>
</html>

step2：将本地文件local.htm放置在应用的resources/rawfile目录下

step3：应用代码


import web_webview from '@ohos.web.webview';
 
@Entry
@Component
struct WebComponent {
  webviewController: web_webview.WebviewController = new web_webview.WebviewController();
 
  build() {
    Column() {
      Button('loadUrl')
        .onClick(() => {
          try {
//step2：点击按钮时，通过loadUrl，跳转到本地其他html文件 local1.html
            this.webviewController.loadUrl($rawfile("local1.html"));
          } catch (error) {
            console.error(`ErrorCode: ${error.code},  Message: ${error.message}`);
          }
        })
//step1：组件Web组件，通过$rawfile加载本地文件local.html
      Web({ src: $rawfile("local.html"), controller: this.webviewController })
    }
  }
}

3.加载html格式文本数据

Web组件可以通过loadData接口实现加载HTML格式的文本数据。当开发者不需要加载整个页面，只需要显示一些页面片段时，可通过此功能来快速加载页面

代码示例


import web_webview from '@ohos.web.webview';
 
@Entry
@Component
struct WebComponent {
  controller: web_webview.WebviewController = new web_webview.WebviewController();
 
  build() {
    Column() {
      Button('loadData')
        .onClick(() => {
          try {
//step2：点击按钮时，通过loadData，加载HTML格式的文本数据
            this.controller.loadData(
              "<html><body bgcolor=\"white\">Source:<pre>source</pre></body></html>",
              "text/html",
              "UTF-8"
            );
          } catch (error) {
            console.error(`ErrorCode: ${error.code},  Message: ${error.message}`);
          }
        })
//step1：组件创建时，默认加载www.example.com
      Web({ src: 'www.example.com', controller: this.controller })
    }
  }
}

三、设置基本属性和事件

1. 设置深色模式

1.1 darkMode

darkMode接口可以配置不同的深色模式

代码示例：


import web_webview from '@ohos.web.webview';
 
@Entry
@Component
struct WebComponent {
  controller: web_webview.WebviewController = new web_webview.WebviewController();
//step1：定义深色模式：WebDarkMode.Off模式表示关闭深色模式；WebDarkMode.On表示开启深色模式，并且深色模式跟随前端页面；WebDarkMode.Auto表示开启深色模式，并且深色模式跟随系统
  @State mode: WebDarkMode = WebDarkMode.Auto;
  build() {
    Column() {
//step2：darkMode接口配置step1定义的深色模式
      Web({ src: 'www.example.com', controller: this.controller })
        .darkMode(this.mode)
    }
  }
}

1.2 forceDarkAccess

forceDarkAccess接口可将前端页面强制配置深色模式，且深色模式不跟随前端页面和系统。配置该模式时候，需要将深色模式配置成WebDarkMode.On。

代码示例：


import web_webview from '@ohos.web.webview';
 
@Entry
@Component
struct WebComponent {
  controller: web_webview.WebviewController = new web_webview.WebviewController();
//step1：forceDarkAccess要求WebDarkMode必须为on
  @State mode: WebDarkMode = WebDarkMode.On;
  @State access: boolean = true;
  build() {
    Column() {
      Web({ src: 'www.example.com', controller: this.controller })
        .darkMode(this.mode)
//step2：页面强制配置为深色模式
        .forceDarkAccess(this.access)
    }
  }
}

2. 上传文件

Web组件支持前端页面选择文件上传功能，onShowFileSelector()接口处理前端页面文件上传的请求

step1：创建本地html文件 local.html


<html>
<head>
    <meta charset="utf-8">
    <title>Document</title>
</head>
 
<body>
// 点击文件上传按钮
<input type="file" value="file"></br>
</body>
</html>

step2：本地local.html文件放置到对应目录下

step3：应用侧代码


import web_webview from '@ohos.web.webview';
@Entry
@Component
struct WebComponent {
  controller: web_webview.WebviewController = new web_webview.WebviewController()
  build() {
    Column() {
//step1：加载本地local.html页面
      Web({ src: $rawfile('local.html'), controller: this.controller })
//step2：当用户在前端页面点击文件上传按钮，应用侧在onShowFileSelector()接口中收到文件上传请求，在此接口中开发者将上传的本地文件路径设置给前端页面
        .onShowFileSelector((event) => {
           let fileList: Array<string> = [
              'xxx/test.png',
           ]
           if(event){
              event.result.handleFileList(fileList)
           }
           return true;
        })
    }
  }
}

3. 在新窗口打开页面

Web组件提供了在新窗口打开页面的能力，通过multiWindowAccess()接口来设置是否允许网页在新窗口打开。当有新窗口打开时，应用侧会在onWindowNew()接口中收到Web组件新窗口事件，开发者需要在此接口事件中，新建窗口来处理Web组件窗口请求。

4. 管理位置权限

Web组件提供位置权限管理能力，通过onGeolocationShow()接口对某个网站进行位置权限管理。Web组件根据接口响应结果，决定是否赋予前端页面权限。获取设备位置，需要开发者配置ohos.permission.LOCATION权限。

step1：定义本地页面


<!DOCTYPE html>
<html>
<body>
<p id="locationInfo">位置信息</p>
<button onclick="getLocation()">获取位置</button>
<script>
var locationInfo=document.getElementById("locationInfo");
function getLocation(){
  if (navigator.geolocation) {
    <!-- 前端页面访问设备地理位置 -->
    navigator.geolocation.getCurrentPosition(showPosition);
  }
}
function showPosition(position){
  locationInfo.innerHTML="Latitude: " + position.coords.latitude + "<br />Longitude: " + position.coords.longitude;
}
</script>
</body>
</html>

step2：应用侧代码


import web_webview from '@ohos.web.webview';
import common from '@ohos.app.ability.common';
import abilityAccessCtrl from '@ohos.abilityAccessCtrl';
import geoLocationManager from '@ohos.geoLocationManager';
 
let context = getContext(this) as common.UIAbilityContext;
let atManager = abilityAccessCtrl.createAtManager();
 
try{
  atManager.requestPermissionsFromUser(context, ["ohos.permission.APPROXIMATELY_LOCATION"], (err, data) => {
    let requestInfo: geoLocationManager.LocationRequest = {
      'priority': 0x203,
      'scenario': 0x300,
      'maxAccuracy': 0
    };
    let locationChange = (location: geoLocationManager.Location):void => {
      if(location){
        console.log('locationChanger: location=' + JSON.stringify(location));
      }
    };
    try{
      geoLocationManager.on('locationChange', requestInfo, locationChange);
      geoLocationManager.off('locationChange', locationChange);
    } catch (err) {
      console.error("errCode:" + err.code + ", errMessage:" + err.message);
    }
  })
} catch (err) {
  console.error("err:", err);
}
 
@Entry
@Component
struct WebComponent {
  controller: web_webview.WebviewController = new web_webview.WebviewController();
  build() {
    Column() {
      Web({ src:$rawfile('getLocation.html'), controller:this.controller })
        .geolocationAccess(true)
        .onGeolocationShow((event) => {  // 地理位置权限申请通知
          AlertDialog.show({
            title: '位置权限请求',
            message: '是否允许获取位置信息',
            primaryButton: {
              value: 'cancel',
              action: () => {
                if(event){
                event.geolocation.invoke(event.origin, false, false);   // 不允许此站点地理位置权限请求
                }
              }
            },
            secondaryButton: {
              value: 'ok',
              action: () => {
                if(event){
                event.geolocation.invoke(event.origin, true, false);    // 允许此站点地理位置权限请求
                }                
              }
            },
            cancel: () => {
              if(event){
              event.geolocation.invoke(event.origin, false, false);   // 不允许此站点地理位置权限请求
              }
            }
          })
        })
    }
  }
}

页面渲染，web组件中默认加载locationInfo.html页面

总结

本文学习了鸿蒙开发web相关的知识，了解web组件的基本概念，以及加载页面的三种方式，同时也学习了web组件的的基本属性和事件，下文将学习web的其他知识。

声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/花生_TL007/article/detail/335250