【Android】WebView控件最全使用解析

本文目录WebView 概述WebView基础篇- 基本用法添加权限和布局加载远程网页加载本地网页加载HTML片段WebView 常用方法清除缓存WebView 中网页的前进 / 后退本地网页跳转解决跳转用默认浏览器打开的问题WebView 进阶篇-常用子类WebSettings类WebViewClient类常见方法使用案例WebChromeClient类常用方法使用案例测试网页WebView .

Teacher.Hu

9389人浏览 · 2022-08-20 21:18:17

Teacher.Hu · 2022-08-20 21:18:17 发布

WebView控件最全使用解析

一、WebView 概述
二、WebView使用基础篇
三、WebView 进阶篇

一、WebView 概述

Android WebView控件是一个可以用来显示Web 网页的控件
Android的Webview在4.4之前采用了不webkit内核，4.4后直接使用了Chrome内核。
WebView继承自 AbsoluteLayout,继承关系如下：
在这里插入图片描述

二、WebView使用基础篇

2.1添加方式

在Manifest文件中添加访问权限

<!--    访问网络权限-->
 <uses-permission android:name="android.permission.INTERNET" />
 <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
 <!--    访问sd卡需要添加的权限-->
 <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
 <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

并在application节点下添加 android:usesCleartextTraffic="true"

在布局文件里添加一个WebView控件

<WebView
  android:id="@+id/webview"
  android:layout_width="match_parent"
  android:layout_height="match_parent" />

2.2 加载远程网页

WebView webView = findViewById(R.id.webview);
webView.loadUrl("http://csdn.net");

2.3 加载本地网页

首先创建一个普通的html网页

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>WebView Study</title>
</head>
<body>
    <h1>这是H1</h1>
    <h2>这是H2</h2>
    <div>content</div>
</body>
</html>

把上面的html网页添加到Android工程的assert目录或者sd卡中

WebView webView =   findViewById(R.id.webview);
//加载本地assets目录下的网页
webView.loadUrl("file:///android_asset/test.html");
// 加载data/data 目录
webView.loadUrl("file:///data/data/包名/files/test.html");
//加载手机本地的html页面  -- 需要申请sd卡动态权限
webView.loadUrl("file://mnt/sdcard/test.html");

加载SD卡的文件需要申请动态权限，动态权限申请方法：Android 动态权限最全解析

2.4 加载HTML片段

String html = "<!DOCTYPE html>\n" +
        "<html lang=\"en\">\n" +
        "<head>\n" +
        "    <meta charset=\"UTF-8\">\n" +
        "    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n" +
        "    <title>WebView Study</title>\n" +
        "</head>\n" +
        "<body>\n" +
        "    <h1>这是H1</h1>\n" +
        "    <h2>这是H2</h2>\n" +
        "    <div>content</div>\n" +
        "</body>\n" +
        "</html>";
  WebView webView = findViewById(R.id.webview);
  webView.loadData(html, "text/html", "UTF-8");

效果如下：

在这里插入图片描述

2.5 WebView 常用方法

清除缓存

//清除网页访问留下的缓存
//由于内核缓存是全局的因此这个方法不仅仅针对webview而是针对整个应用程序.
Webview.clearCache(true);

//清除当前webview访问的历史记录
//只会webview访问历史记录里的所有记录除了当前访问记录
Webview.clearHistory()；

//这个api仅仅清除自动完成填充的表单数据，并不会清除WebView存储到本地的数据
Webview.clearFormData()；

WebView 中网页的前进 / 后退

webView.goBack();//跳到上个页面
webView.goForward();//跳到下个页面
webView.canGoBack();//是否可以跳到上一页(如果返回false,说明已经是第一页)
webView.canGoForward();//是否可以跳到下一页(如果返回false,说明已经是最后一页)
    
//以当前的index为起始点前进或者后退到历史记录中指定的steps
//如果steps为负数则为后退，正数则为前进
Webview.goBackOrForward(intsteps) 
//重新加载当前请求
Webview.reload()

本地网页跳转

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>WebView Study</title>
</head>
<body>
<h1>这是H1</h1>
<h2>这是H2</h2>
<div>content</div>
<a href="file:///android_asset/test1.html">页面跳转1</a>
</body>
</html>

解决跳转用默认浏览器打开的问题

webView.setWebViewClient(new WebViewClient(){
         @Override
         public boolean shouldOverrideUrlLoading(WebView view, String url) {
             view.loadUrl(url);// 强制在当前 WebView 中加载 url
             return true;
         }
     });

三、WebView 进阶篇

3.1 WebSettings类

 WebSettings webSettings = webView.getSettings();
 //如果访问的页面中要与Javascript交互，则webview必须设置支持Javascript
 webSettings.setJavaScriptEnabled(true);
//设置自适应屏幕
 webSettings.setUseWideViewPort(true); //将图片调整到适合webview的大小
 webSettings.setLoadWithOverviewMode(false); // 缩放至屏幕的大小
 //缩放操作
webSettings.setSupportZoom(false); //支持缩放，默认为true。是下面那个的前提。
webSettings.setBuiltInZoomControls(true); //设置内置的缩放控件。若为false，则该WebView不可缩放
webSettings.setDisplayZoomControls(false); //隐藏原生的缩放控件

//其他细节操作
//缓存模式如下：
//LOAD_CACHE_ONLY: 不使用网络，只读取本地缓存数据
 //LOAD_DEFAULT: （默认）根据cache-control决定是否从网络上取数据。
 //LOAD_NO_CACHE: 不使用缓存，只从网络获取数据.
 //LOAD_CACHE_ELSE_NETWORK，只要本地有，无论是否过期，或者no-cache，都使用缓存中的数据
webSettings.setCacheMode(WebSettings.LOAD_CACHE_ELSE_NETWORK); //webview缓存设置
webSettings.setAllowFileAccess(true); //设置可以访问本地文件
webSettings.setJavaScriptCanOpenWindowsAutomatically(true); //支持通过JS打开新窗口
webSettings.setLoadsImagesAutomatically(true); //支持自动加载图片
webSettings.setDefaultTextEncodingName("utf-8");//设置编码格式
webSettings.setDatabaseEnabled(true)://是否开启数据库缓存

3.2 WebViewClient类

该类作用：处理各种通知 & 请求事件

常见方法

onPageStarted(WebView view, String url, Bitmap favicon):WebView 开始加载页面时回调，一次Frame加载对应一次回调。
onLoadResource(WebView view, String url):WebView 加载页面资源时会回调，每一个资源产生的一次网络加载，除非本地有当前 url 对应有缓存，否则就会加载。
shouldInterceptRequest(WebView view, String url):WebView 可以拦截某一次的 request 来返回我们自己加载的数据，这个方法在后面缓存会有很大作用。
shouldOverrideUrlLoading(WebView view, String url):是否在 WebView 内加载页面。
onReceivedSslError(WebView view, SslErrorHandler handler, SslError error):WebView ssl 访问证书出错，handler.cancel()取消加载，handler.proceed()对然错误也继续加载。
onPageFinished(WebView view, String url):WebView 完成加载页面时回调，一次Frame加载对应一次回调。
onReceivedError(WebView view, int errorCode, String description, String failingUrl):WebView 访问 url 出错。

使用案例

webView.setWebViewClient(new WebViewClient() {
     // 作用：开始载入页面调用的，我们可以设定一个loading的页面，告诉用户程序在等待网络响应
     @Override
     public void onPageStarted(WebView view, String url, Bitmap favicon) {
         super.onPageStarted(view, url, favicon);
         Log.d("MainActivity", "开始加载");
     }

     //作用：在页面加载结束时调用。我们可以关闭loading 条，切换程序动作。
     @Override
     public void onPageFinished(WebView view, String url) {
         super.onPageFinished(view, url);
         Log.d("MainActivity", "加载结束");
     }

     // 链接跳转都会走这个方法
     @Override
     public boolean shouldOverrideUrlLoading(WebView view, String url) {
         Log.d("MainActivity", "Url：" + url);
         view.loadUrl(url);// 强制在当前 WebView 中加载 url
         return true;
     }


     //作用：在加载页面资源时会调用，每一个资源（比如图片）的加载都会调用一次。
     @Override
     public void onLoadResource(WebView view, String url) {
         //设定加载资源的操作
     }

     //作用：加载页面的服务器出现错误时（如404）调用。
     @Override
     public void onReceivedError(WebView view, int errorCode, String description, String failingUrl) {
         switch (errorCode) {
             case 404:
                 view.loadUrl("file:///android_assets/error_handle.html");
                 break;
         }
     }

     //作用：处理https请求
     //webView默认是不处理https请求的，页面显示空白，需要进行如下设置：
     @Override
     public void onReceivedSslError(WebView view, SslErrorHandler handler, SslError error) {
         handler.proceed();    //表示等待证书响应
         // handler.cancel();      //表示挂起连接，为默认方式
         // handler.handleMessage(null);    //可做其他处理
     }
 });

3.3 WebChromeClient类

该类作用：辅助 WebView 处理 Javascript 的对话框,网站图标,网站标题等。

常用方法

onConsoleMessage(String message, int lineNumber,String sourceID):输出Web 端日志。
onProgressChanged(WebView view, int newProgress):当前 WebView
加载网页进度。
onJsPrompt(WebView view, String url, String message, String
defaultValue, JsPromptResult result):处理 JS 中的 Prompt对话框
onJsAlert(WebView view, String url, String message, JsResult result):
Js 中调用 alert() 函数，产生的对话框。
onReceivedTitle(WebView view, String title):接收web页面的 Title。
onReceivedIcon(WebView view, Bitmap icon):接收web页面的icon。

使用案例

 webView.setWebChromeClient(new WebChromeClient(){
            //作用：获得网页的加载进度并显示
            @Override
            public void onProgressChanged(WebView view, int newProgress) {
                Log.d("MainActivity","newProgress："+ newProgress );
                super.onProgressChanged(view, newProgress);
            }

            //作用：输出Web 端日志
            @Override
            public boolean onConsoleMessage(ConsoleMessage consoleMessage) {
                Log.d("MainActivity","consoleMessage："+ consoleMessage.message() );
                return super.onConsoleMessage(consoleMessage);
            }

            //作用：获取Web页中的标题
            @Override
            public void onReceivedTitle(WebView view, String title) {
                super.onReceivedTitle(view, title);
                Log.d("MainActivity","标题："+ title);
            }

            //作用：获取Web页中的图标
            @Override
            public void onReceivedIcon(WebView view, Bitmap icon) {
                super.onReceivedIcon(view, icon);
            }

            //作用：获取Web页中 Js中调用alert()函数，产生的对话框
            @Override
            public boolean onJsAlert(WebView view, String url, String message, final JsResult result) {
                Log.d("MainActivity","onJsAlert："+ message);
                return super.onJsAlert(view, url, message, result);
            }

            @Override
            public boolean onJsPrompt(WebView view, String url, String message, String defaultValue, JsPromptResult result) {
                Log.d("MainActivity","onJsPrompt："+ message);
                return super.onJsPrompt(view, url, message, defaultValue, result);
            }

            @Override
            public boolean onJsConfirm(WebView view, String url, String message, JsResult result) {
                Log.d("MainActivity","onJsConfirm："+ message);
                return super.onJsConfirm(view, url, message, result);
            }
        });

测试网页

<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>WebView Study</title>
    <script>
        function clickPrompt() {
            prompt("prompt");
        }
        function clickAlert() {
            alert("alert");
        }

        function clicConfirm() {
            confirm("Confirm");
        }
    </script>
</head>

<body>
<button type="button" onclick="clickPrompt()">Prompt调用</button>
<button type="button" onclick="clickAlert()">Alert调用</button>
<button type="button" onclick="clicConfirm()">Confirm调用</button>
</body>

</html>