史上最全webview詳解

風靈使發表於2018-04-02
WebView

WebView在現在的專案中使用的頻率應該還是非常高的。
我個人總覺得HTML5是一種趨勢。找了一些東西，在此總結。
本篇最後有一個非常不錯 的 Html5Activity 載入類，不想看的可以直接跳下載。

##WebSettings

WebSettings webSettings = mWebView .getSettings();

//支援獲取手勢焦點，輸入使用者名稱、密碼或其他
webview.requestFocusFromTouch();

setJavaScriptEnabled(true);  //支援js
setPluginsEnabled(true);  //支援外掛 

設定自適應螢幕，兩者合用
setUseWideViewPort(true);  //將圖片調整到適合webview的大小 
setLoadWithOverviewMode(true); // 縮放至螢幕的大小


setSupportZoom(true);  //支援縮放，預設為true。是下面那個的前提。
setBuiltInZoomControls(true); //設定內建的縮放控制元件。
  若上面是false，則該WebView不可縮放，這個不管設定什麼都不能縮放。

setDisplayZoomControls(false); //隱藏原生的縮放控制元件

setLayoutAlgorithm(LayoutAlgorithm.SINGLE_COLUMN); //支援內容重新佈局  
supportMultipleWindows();  //多視窗 
setCacheMode(WebSettings.LOAD_CACHE_ELSE_NETWORK);  //關閉webview中快取 
setAllowFileAccess(true);  //設定可以訪問檔案 
setNeedInitialFocus(true); //當webview呼叫requestFocus時為webview設定節點
setJavaScriptCanOpenWindowsAutomatically(true); //支援通過JS開啟新視窗 
setLoadsImagesAutomatically(true);  //支援自動載入圖片
setDefaultTextEncodingName("utf-8");//設定編碼格式

##載入方式
載入一個網頁：

webView.loadUrl("http://www.google.com/");

載入apk包中的一個html頁面

webView.loadUrl("file:///android_asset/test.html");

載入手機本地的一個html頁面的方法：

webView.loadUrl("content://com.android.htmlfileprovider/sdcard/test.html");

##WebViewClient
WebViewClient就是幫助WebView處理各種通知、請求事件的。
開啟網頁時不呼叫系統瀏覽器， 而是在本WebView中顯示：

 mWebView.setWebViewClient(new WebViewClient(){
      @Override
      public boolean shouldOverrideUrlLoading(WebView view, String url) {
          view.loadUrl(url);
      return true;
      }
  });

WebViewClient 方法

WebViewClient mWebViewClient = new WebViewClient()  
{  
    shouldOverrideUrlLoading(WebView view, String url)  最常用的，比如上面的。
    //在網頁上的所有載入都經過這個方法,這個函式我們可以做很多操作。
    //比如獲取url，檢視url.contains(“add”)，進行新增操作

    shouldOverrideKeyEvent(WebView view, KeyEvent event)
    //重寫此方法才能夠處理在瀏覽器中的按鍵事件。 

    onPageStarted(WebView view, String url, Bitmap favicon) 
    //這個事件就是開始載入頁面呼叫的，我們可以設定一個loading的頁面，告訴使用者程式在等待網路響應。 

    onPageFinished(WebView view, String url)
    //在頁面載入結束時呼叫。同樣道理，我們可以關閉loading 條，切換程式動作。 

    onLoadResource(WebView view, String url) 
    // 在載入頁面資源時會呼叫，每一個資源（比如圖片）的載入都會呼叫一次。 

    onReceivedError(WebView view, int errorCode, String description, String failingUrl)
    // (報告錯誤資訊) 

    doUpdateVisitedHistory(WebView view, String url, boolean isReload)  
    //(更新歷史記錄) 

    onFormResubmission(WebView view, Message dontResend, Message resend) 
    //(應用程式重新請求網頁資料) 

    onReceivedHttpAuthRequest(WebView view, HttpAuthHandler handler, String host,String realm)
    //（獲取返回資訊授權請求） 

    onReceivedSslError(WebView view, SslErrorHandler handler, SslError error) 
    //重寫此方法可以讓webview處理https請求。

    onScaleChanged(WebView view, float oldScale, float newScale) 
    // (WebView發生改變時呼叫) 

    onUnhandledKeyEvent(WebView view, KeyEvent event) 
    //（Key事件未被載入時呼叫） 
}

將上面定義的WebViewClient設定給WebView：

  webView.setWebViewClient(webViewClient);

##WebChromeClient

WebChromeClient是輔助WebView處理Javascript的對話方塊，網站圖示，網站title，載入進度等 :
方法中的程式碼都是由Android端自己處理。

WebChromeClient mWebChromeClient = new WebChromeClient() {


    //獲得網頁的載入進度，顯示在右上角的TextView控制元件中
    @Override
    public void onProgressChanged(WebView view, int newProgress) {
        if (newProgress < 100) {
            String progress = newProgress + "%";
        } else {
        }
    }

    //獲取Web頁中的title用來設定自己介面中的title
    //當載入出錯的時候，比如無網路，這時onReceiveTitle中獲取的標題為 找不到該網頁,
    //因此建議當觸發onReceiveError時，不要使用獲取到的title
    @Override
    public void onReceivedTitle(WebView view, String title) {
        MainActivity.this.setTitle(title);
    }

    @Override
    public void onReceivedIcon(WebView view, Bitmap icon) {
        //
    }

    @Override
    public boolean onCreateWindow(WebView view, boolean isDialog, boolean isUserGesture, Message resultMsg) {
        //
        return true;
    }

    @Override
    public void onCloseWindow(WebView window) {
    }

    //處理alert彈出框，html 彈框的一種方式
    @Override
    public boolean onJsAlert(WebView view, String url, String message, JsResult result) {
        //
        return true;
    }

    //處理confirm彈出框
    @Override
    public boolean onJsPrompt(WebView view, String url, String message, String defaultValue, JsPromptResult 
            result) {
        //
        return true;
    }

    //處理prompt彈出框
    @Override
    public boolean onJsConfirm(WebView view, String url, String message, JsResult result) {
        //
        return true;
    }
};

同樣，將上面定義的WebChromeClient設定給WebView：

  webView.setWebChromeClient(mWebChromeClient);

呼叫JS程式碼

  WebSettings webSettings = mWebView .getSettings(); 
  webSettings.setJavaScriptEnabled(true); 

  mWebView.addJavascriptInterface(getHtmlObject(), "jsObj");

上面這是前提！！！
然後實現上面的方法。

private Object getHtmlObject(){
    Object insertObj = new Object(){

        //給html提供的方法，js中可以通過：var str = window.jsObj.HtmlcallJava(); 獲取到
        public String HtmlcallJava(){
            return "Html call Java";
        }

        //給html提供的有參函式 ： window.jsObj.HtmlcallJava2("IT-homer blog");
        public String HtmlcallJava2(final String param){
            return "Html call Java : " + param;
        }

        //Html給我們提供的函式
        public void JavacallHtml(){
            runOnUiThread(new Runnable() {
                @Override
                public void run() {
                    //這裡是呼叫方法
                    mWebView.loadUrl("javascript: showFromHtml()");
                    Toast.makeText(JSAndroidActivity.this, "clickBtn", Toast.LENGTH_SHORT).show();
                }
            });
        }

        //Html給我們提供的有參函式
        public void JavacallHtml2(final String param){
            runOnUiThread(new Runnable() {
                @Override
                public void run() {
                    mWebView.loadUrl("javascript: showFromHtml2('IT-homer blog')");
                    Toast.makeText(JSAndroidActivity.this, "clickBtn2", Toast.LENGTH_SHORT).show();
                }
            });
        }
    };

    return insertObj;
}

Android 呼叫js有個漏洞：
http://blog.csdn.net/leehong2005/article/details/11808557

##WebView的方法
前進、後退

goBack ()  //後退
goForward ()//前進
goBackOrForward (int steps) //以當前的index為起始點前進或者後退到歷史記錄中指定的steps，  
                              如果steps為負數則為後退，正數則為前進

canGoForward ()  //是否可以前進
canGoBack () //是否可以後退

清除快取資料：

clearCache(true);   //清除網頁訪問留下的快取，由於核心快取是全域性的因此這個方法不僅僅針對webview而是針對整個應用程式.
clearHistory ()  //清除當前webview訪問的歷史記錄，只會webview訪問歷史記錄裡的所有記錄除了當前訪問記錄.
clearFormData ()  //這個api僅僅清除自動完成填充的表單資料，並不會清除WebView儲存到本地的資料。

WebView的狀態：


onResume ()  //啟用WebView為活躍狀態，能正常執行網頁的響應
onPause ()  //當頁面被失去焦點被切換到後臺不可見狀態，需要執行onPause動過， onPause動作通知核心暫停所有的動作，比如DOM的解析、plugin的執行、JavaScript執行。

pauseTimers () //當應用程式被切換到後臺我們使用了webview， 這個方法不僅僅針對當前的webview而是全域性的全應用程式的webview，它會暫停所有webview的layout，parsing，javascripttimer。降低CPU功耗。
resumeTimers ()  //恢復pauseTimers時的動作。

destroy () //銷燬，關閉了Activity時，音樂或視訊，還在播放。就必須銷燬。

但是注意：
webview呼叫destory時,webview仍繫結在Activity上.這是由於自定義webview構建時傳入了該Activity的context物件,因此需要先從父容器中移除webview,然後再銷燬webview:

  rootLayout.removeView(webView);  
  webView.destroy();

判斷WebView是否已經滾動到頁面底端 或者 頂端:
getScrollY() //方法返回的是當前可見區域的頂端距整個頁面頂端的距離,也就是當前內容滾動的距離.
getHeight()或者getBottom() //方法都返回當前WebView 這個容器的高度
getContentHeight() 返回的是整個html 的高度,但並不等同於當前整個頁面的高度,因為WebView 有縮放功能, 所以當前整個頁面的高度實際上應該是原始html 的高度再乘上縮放比例. 因此,更正後的結果,準確的判斷方法應該是：

    if (webView.getContentHeight() * webView.getScale() == (webView.getHeight() + webView.getScrollY())) {
        //已經處於底端
    }

    if(webView.getScrollY() == 0){
        //處於頂端
    }

返回鍵
返回上一次瀏覽的頁面

public boolean onKeyDown(int keyCode, KeyEvent event) {       
    if ((keyCode == KeyEvent.KEYCODE_BACK) && mWebView.canGoBack()) {       
        mWebView.goBack();       
        return true;       
    }       
    return super.onKeyDown(keyCode, event);       
}

有一個非常不錯的 Html5Activity 載入類帖出來：

package com.lyl.web;

import android.graphics.Bitmap;
import android.os.Bundle;
import android.os.Message;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;
import android.view.KeyEvent;
import android.webkit.GeolocationPermissions;
import android.webkit.WebChromeClient;
import android.webkit.WebSettings;
import android.webkit.WebView;
import android.webkit.WebViewClient;

import com.lyl.test.R;

public class Html5Activity extends AppCompatActivity {

    private String mUrl;

    private WebView mWebView;


    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_web);

        Bundle bundle = getIntent().getBundleExtra("bundle");
        mUrl = bundle.getString("url");

        Log.d("Url:", mUrl);

        mWebView = (WebView) findViewById(R.id.web);

        WebSettings mWebSettings = mWebView.getSettings();
        mWebSettings.setSupportZoom(true);
        mWebSettings.setLoadWithOverviewMode(true);
        mWebSettings.setUseWideViewPort(true);
        mWebSettings.setDefaultTextEncodingName("utf-8");
        mWebSettings.setLoadsImagesAutomatically(true);

        //呼叫JS方法.安卓版本大於17,加上註解 @JavascriptInterface
        mWebSettings.setJavaScriptEnabled(true);

        saveData(mWebSettings);

        newWin(mWebSettings);

        mWebView.setWebChromeClient(webChromeClient);
        mWebView.setWebViewClient(webViewClient);
        mWebView.loadUrl(mUrl);
    }

    /**
     * 多視窗的問題
     */
    private void newWin(WebSettings mWebSettings) {
        //html中的_bank標籤就是新建視窗開啟，有時會打不開，需要加以下
        //然後 複寫 WebChromeClient的onCreateWindow方法
        mWebSettings.setSupportMultipleWindows(true);
        mWebSettings.setJavaScriptCanOpenWindowsAutomatically(true);
    }


    /**
     * HTML5資料儲存
     */
    private void saveData(WebSettings mWebSettings) {
        //有時候網頁需要自己儲存一些關鍵資料,Android WebView 需要自己設定
        mWebSettings.setDomStorageEnabled(true);
        mWebSettings.setDatabaseEnabled(true);
        mWebSettings.setAppCacheEnabled(true);
        String appCachePath = getApplicationContext().getCacheDir().getAbsolutePath();
        mWebSettings.setAppCachePath(appCachePath);
    }

    WebViewClient webViewClient = new WebViewClient(){

        /**
         * 多頁面在同一個WebView中開啟，就是不新建activity或者呼叫系統瀏覽器開啟
         */
        @Override
        public boolean shouldOverrideUrlLoading(WebView view, String url) {
            view.loadUrl(url);
            return true;
        }

    };

    WebChromeClient webChromeClient = new WebChromeClient() {

        //=========HTML5定位==========================================================
        //需要先加入許可權
        //<uses-permission android:name="android.permission.INTERNET"/>
        //<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
        //<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
        @Override
        public void onReceivedIcon(WebView view, Bitmap icon) {
            super.onReceivedIcon(view, icon);
        }

        @Override
        public void onGeolocationPermissionsHidePrompt() {
            super.onGeolocationPermissionsHidePrompt();
        }

        @Override
        public void onGeolocationPermissionsShowPrompt(final String origin, final GeolocationPermissions.Callback callback) {
            callback.invoke(origin, true, false);//注意個函式，第二個引數就是是否同意定位許可權，第三個是是否希望核心記住
            super.onGeolocationPermissionsShowPrompt(origin, callback);
        }
        //=========HTML5定位==========================================================


        //=========多視窗的問題==========================================================
        @Override
        public boolean onCreateWindow(WebView view, boolean isDialog, boolean isUserGesture, Message resultMsg) {
            WebView.WebViewTransport transport = (WebView.WebViewTransport) resultMsg.obj;
            transport.setWebView(mWebView);
            resultMsg.sendToTarget();
            return true;
        }
        //=========多視窗的問題==========================================================
    };


    @Override
    public boolean onKeyDown(int keyCode, KeyEvent event) {
        if (keyCode == KeyEvent.KEYCODE_BACK && mWebView.canGoBack()) {
            mWebView.goBack();
            return true;
        }

        return super.onKeyDown(keyCode, event);
    }

}

相關文章