HarmonyOS4.0体系性深入开发38Web组件概述

锦通  金牌会员 | 2024-8-18 15:05:39 | 显示全部楼层 | 阅读模式
打印 上一主题 下一主题
楼主

主题 553|帖子 553|积分 1659

Web组件概述

Web组件用于在应用程序中表现Web页面内容，为开发者提供页面加载、页面交互、页面调试等能力。


  • 页面加载：Web组件提供底子的前端页面加载的能力，包括加载网络页面、本地页面、Html格式文本数据。
  • 页面交互：Web组件提供丰富的页面交互的方式，包括：设置前端页面深色模式，新窗口中加载页面，位置权限管理，Cookie管理，应用侧使用前端页面JavaScript等能力。
  • 页面调试：Web组件支持使用Devtools工具调试前端页面。
下面通过常见使用场景举例，来具体先容Web组件功能特性。
Web组件概述

Web组件用于在应用程序中表现Web页面内容，为开发者提供页面加载、页面交互、页面调试等能力。


  • 页面加载：Web组件提供底子的前端页面加载的能力，包括加载网络页面、本地页面、Html格式文本数据。
  • 页面交互：Web组件提供丰富的页面交互的方式，包括：设置前端页面深色模式，新窗口中加载页面，位置权限管理，Cookie管理，应用侧使用前端页面JavaScript等能力。
  • 页面调试：Web组件支持使用Devtools工具调试前端页面。
下面通过常见使用场景举例，来具体先容Web组件功能特性。
设置深色模式

Web组件支持对前端页面进行深色模式配置。


  • 通过
    darkMode()
    接口可以配置差别的深色模式，
    WebDarkMode.Off
    模式表示关闭深色模式。
    WebDarkMode.On
    表示开启深色模式，而且深色模式跟随前端页面。
    WebDarkMode.Auto
    表示开启深色模式，而且深色模式跟随体系。
    在下面的示例中, 通过darkMode()接口将页面深色模式配置为跟随体系。
    1. // xxx.ets
    2. import web_webview from '@ohos.web.webview';
    4. @Entry
    5. @Component
    6. struct WebComponent {
    7.   controller: web_webview.WebviewController = new web_webview.WebviewController();
    8.   @State mode: WebDarkMode = WebDarkMode.Auto;
    9.   build() {
    10.     Column() {
    11.       Web({ src: 'www.example.com', controller: this.controller })
    12.         .darkMode(this.mode)
    13.     }
    14.   }
    15. }
    复制代码
  • 通过
    forceDarkAccess()
    接口可将前端页面欺压配置深色模式，且深色模式不跟随前端页面和体系。配置该模式时候，必要将深色模式配置成WebDarkMode.On。
    在下面的示例中, 通过forceDarkAccess()接口将页面欺压配置为深色模式。
    1. // xxx.etsimport web_webview from '@ohos.web.webview';
    2. @Entry@Componentstruct WebComponent {  controller: web_webview.WebviewController = new web_webview.WebviewController();  @State mode: WebDarkMode = WebDarkMode.On;  @State access: boolean = true;  build() {    Column() {      Web({ src: 'www.example.com', controller: this.controller })        .darkMode(this.mode)        .forceDarkAccess(this.access)    }  }}
    复制代码
上传文件

Web组件支持前端页面选择文件上传功能，应用开发者可以使用onShowFileSelector()接口来处理前端页面文件上传的请求。
下面的示例中，当用户在前端页面点击文件上传按钮，应用侧在onShowFileSelector()接口中收到文件上传请求，在此接口中开发者将上传的本地文件路径设置给前端页面。


  • 应用侧代码。
    1. // xxx.ets
    2. import web_webview from '@ohos.web.webview';
    3. @Entry
    4. @Component
    5. struct WebComponent {
    6.   controller: web_webview.WebviewController = new web_webview.WebviewController()
    7.   build() {
    8.     Column() {
    9.       // 加载本地local.html页面
    10.       Web({ src: $rawfile('local.html'), controller: this.controller })
    11.         .onShowFileSelector((event) => {
    12.             // 开发者设置要上传的文件路径
    13.            let fileList: Array<string> = [
    14.               'xxx/test.png',
    15.            ]
    16.            if(event){
    17.               event.result.handleFileList(fileList)
    18.            }
    19.            return true;
    20.         })
    21.     }
    22.   }
    23. }
    复制代码
  • local.html页面代码。
    1. <!DOCTYPE html>
    2. <html>
    3. <head>
    4.     <meta charset="utf-8">
    5.     <title>Document</title>
    6. </head>
    8. <body>
    9. // 点击文件上传按钮
    10. <input type="file" value="file"></br>
    11. </body>
    12. </html>
    复制代码
    在新窗口中打开页面

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

    • 假如开发者在onWindowNew()接口关照中不必要打开新窗口，必要将ControllerHandler.setWebController()接口返回值设置成null。
    如下面的本地示例，当用户点击“新窗口中打开网页”按钮时，应用侧会在onWindowNew()接口中收到Web组件新窗口事件。
       

    • 应用侧代码。
      1. // xxx.ets
      2. import web_webview from '@ohos.web.webview'
      4. //在同一page页有两个web组件。在WebComponent新开窗口时，会跳转到NewWebViewComp。
      5. @CustomDialog
      6. struct NewWebViewComp {
      7. controller?: CustomDialogController
      8. webviewController1: web_webview.WebviewController = new web_webview.WebviewController()
      9. build() {
      10.     Column() {
      11.       Web({ src: "", controller: this.webviewController1 })
      12.         .javaScriptAccess(true)
      13.         .multiWindowAccess(false)
      14.         .onWindowExit(()=> {
      15.           console.info("NewWebViewComp onWindowExit")
      16.           if (this.controller) {
      17.             this.controller.close()
      18.           }
      19.         })
      20.       }
      21.   }
      22. }
      24. @Entry
      25. @Component
      26. struct WebComponent {
      27.     controller: web_webview.WebviewController = new web_webview.WebviewController()
      28.     dialogController: CustomDialogController | null = null
      29.     build() {
      30.       Column() {
      31.         Web({ src:$rawfile("window.html"), controller: this.controller })
      32.           .javaScriptAccess(true)
      33.          //需要使能multiWindowAccess
      34.           .multiWindowAccess(true)
      35.           .onWindowNew((event) => {
      36.           if (this.dialogController) {
      37.             this.dialogController.close()
      38.           }
      39.           let popController:web_webview.WebviewController = new web_webview.WebviewController()
      40.           this.dialogController = new CustomDialogController({
      41.             builder: NewWebViewComp({webviewController1: popController})
      42.           })
      43.           this.dialogController.open()
      44.           //将新窗口对应WebviewController返回给Web内核。
      45.           //如果不需要打开新窗口请调用event.handler.setWebController接口设置成null。
      46.           //若不调用event.handler.setWebController接口，会造成render进程阻塞。
      47.           event.handler.setWebController(popController)
      48.         })
      49.     }
      50.   }
      51. }
      复制代码
    • window.html页面代码。
      1. <!DOCTYPE html>
      2. <html>
      3. <head>
      4.     <meta charset="utf-8">
      5.     <title>WindowEvent</title>
      6. </head>
      7. <body>
      8. <input type="button" value="新窗口中打开网页" onclick="OpenNewWindow()">
      9. <script type="text/javascript">
      10.     function OpenNewWindow()
      11.     {
      12.         let openedWindow = window.open("about:blank", "", "location=no,status=no,scrollvars=no");
      13.         openedWindow.document.write("<p>这是我的窗口</p>");
      14.         openedWindow.focus();
      15.     }
      16. </script>
      17. </body>
      18. </html>
      复制代码

管理位置权限

Web组件提供位置权限管理能力。开发者可以通过onGeolocationShow()接口对某个网站进行位置权限管理。Web组件根据接口相应结果，决定是否赋予前端页面权限。获取设备位置，必要开发者配置ohos.permission.LOCATION权限。
在下面的示例中，用户点击前端页面"获取位置"按钮，Web组件通过弹窗的形式关照应用侧位置权限请求消息，示例代码如下：


  • 前端页面代码。
    1. <!DOCTYPE html>
    2. <html>
    3. <body>
    4. <p id="locationInfo">位置信息</p>
    5. <button onclick="getLocation()">获取位置</button>
    6. <script>
    7. var locationInfo=document.getElementById("locationInfo");
    8. function getLocation(){
    9.   if (navigator.geolocation) {
    10.     <!-- 前端页面访问设备地理位置 -->
    11.     navigator.geolocation.getCurrentPosition(showPosition);
    12.   }
    13. }
    14. function showPosition(position){
    15.   locationInfo.innerHTML="Latitude: " + position.coords.latitude + "<br />Longitude: " + position.coords.longitude;
    16. }
    17. </script>
    18. </body>
    19. </html>
    复制代码
  • 应用代码。
    1. <!DOCTYPE html>
    2. <html>
    3. <body>
    4. <p id="locationInfo">位置信息</p>
    5. <button onclick="getLocation()">获取位置</button>
    6. <script>
    7. var locationInfo=document.getElementById("locationInfo");
    8. function getLocation(){
    9.   if (navigator.geolocation) {
    10.     <!-- 前端页面访问设备地理位置 -->
    11.     navigator.geolocation.getCurrentPosition(showPosition);
    12.   }
    13. }
    14. function showPosition(position){
    15.   locationInfo.innerHTML="Latitude: " + position.coords.latitude + "<br />Longitude: " + position.coords.longitude;
    16. }
    17. </script>
    18. </body>
    19. </html>
    复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。
回复

使用道具 举报

0 个回复

倒序浏览
返回列表

快速回复

高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 or 立即注册

本版积分规则

锦通

金牌会员
这个人很懒什么都没写!

楼主热帖

标签云

挺好的 服务器
微信订阅号
微信服务号
微信客服
小程序
H5
关于我们 商务合作 网站地图
©Copyright 2022-2024 杭州祥升科技有限公司 版权所有 浙ICP备20004199号
快速回复 返回顶部 返回列表