Android WebView

使用流程

方式一

  1. 在Activity布局文件中添加控件
  2. 在代码中获取控件实例,调用loadUrl方法加载web页面

方式二

  1. 在Activity的onCreate方法中new一个WebView实例,传入一个Context
  2. 在代码中获取控件实例,调用loadUrl方法加载web页面

在webView中使用JavaScript

启用JavaScript

   WebView myWebView = (WebView) findViewById(R.id.webview);

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

绑定JavaScript代码给Android代码

定义Java接口,暴露方法给JavaScript

public class WebAppInterface {
   Context mContext;

   /** Instantiate the interface and set the context */
   WebAppInterface(Context c) {
   
   mContext = c;
   }

   /** Show a toast from the web page targetSdkVersion>=17需要注解*/
   @JavascriptInterface
   public void showToast(String toast) {
   Toast.makeText(mContext, toast, Toast.LENGTH_SHORT).show();
   }
}

绑定一个命名为Android的接口给WebView,

WebView webView = (WebView) findViewById(R.id.webview);
webView.addJavascriptInterface(new WebAppInterface(this), "Android");

在JavaScript中使用这个接口




操控页面导航

点击WebView中的链接的默认行为是启动默认浏览器打开这个URL。如果想要在自己的WebView中打开:

WebView myWebView = (WebView) findViewById(R.id.webview);
myWebView.setWebViewClient(MyWebViewClient);

复写WebViewClient的shouldOverrideUrlLoading方法:

private class MyWebViewClient extends WebViewClient {
   @Override
    public boolean shouldOverrideUrlLoading(WebView view, String url) {
        if (Uri.parse(url).getHost().equals("https:\/\/www.example.com")) {

        // This is my website, so do not override; let my WebView load the  page **/

          return false;
        }
       //  Otherwise, the link is not for a page on my site, so launch another  */

        Activity that handles URLs
        Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
        startActivity(intent);
        return true;
    }
}

WebView历史导航

canGoBack()如果实际存在用户要访问的网页历史记录,则该方法返回true。同样,您可以使用canGoForward()检查是否存在转发历史记录。如果您不执行此检查,则一旦用户到达历史记录的末尾,goBack()或goForward()什么都不做。

@Override
public boolean onKeyDown(int keyCode, KeyEvent event) {
   // Check if the key event was the Back button and if there's history

  if ((keyCode == KeyEvent.KEYCODE_BACK) && myWebView.canGoBack()) {
   myWebView.goBack();
   return true;
   }
   // If it wasn't the Back key or there's no web page history, bubble up to the default
   // system behavior (probably exit the activity)
   return super.onKeyDown(keyCode, event);
}
}

WebSettings

WebSettings用来对WebView做各种设置, 你可以这样获取WebSettings:


WebSettings webSettings = mWebView .getSettings();

WebSettings的常见设置如下所示:

JS处理

  • setJavaScriptEnabled(true); //支持js

  • setPluginsEnabled(true); //支持插件

  • setJavaScriptCanOpenWindowsAutomatically(true); //支持通过JS打开新窗口
    缩放处理

  • setUseWideViewPort(true); //将图片调整到适合webview的大小

  • setLoadWithOverviewMode(true); // 缩放至屏幕的大小

  • setSupportZoom(true); //支持缩放,默认为true。是下面那个的前提。

  • setBuiltInZoomControls(true); //设置内置的缩放控件。 这个取决于setSupportZoom(), 若setSupportZoom(false),则该WebView不可缩放,这个不管设置什么都不能缩放。

  • setDisplayZoomControls(false); //隐藏原生的缩放控件
    内容布局

  • setLayoutAlgorithm(LayoutAlgorithm.SINGLE_COLUMN); //支持内容重新布局

  • supportMultipleWindows(); //多窗口
    文件缓存

  • setCacheMode(WebSettings.LOAD_CACHE_ELSE_NETWORK); //关闭webview中缓存

  • setAllowFileAccess(true); //设置可以访问文件
    其他设置

  • setNeedInitialFocus(true); //当webview调用requestFocus时为webview设置节点

  • setLoadsImagesAutomatically(true); //支持自动加载图片

  • setDefaultTextEncodingName("utf-8"); //设置编码格式

  • setPluginState(PluginState.OFF); //设置是否支持flash插件

  • setDefaultFontSize(20); //设置默认字体大小

WebViewClient

WebViewClient用来帮助WebView处理各种通知, 请求事件。我们通过继承WebViewClient并重载它的方法可以实现不同功能的定制。主要方法:

  1. shouldOverrideUrlLoading(WebView view, String url) //在网页上的所有加载都经过这个方法,这个函数我们可以做很多操作。比如获取url,查看url.contains(“add”),进行添加操作。于API level 24过时. 使用 shouldOverrideUrlLoading(WebView, WebResourceRequest) 替代.

  2. shouldOverrideUrlLoading(WebView view, WebResourceRequest request) //在网页上的所有加载都经过这个方法,这个函数我们可以做很多操作。比如获取url,查看url.contains(“add”),进行添加操作。

  3. shouldInterceptRequest(WebView view, String url) //通知有资源请求的主机,允许应用返回数据了。于API level 21过时. 使用 shouldInterceptRequest(WebView, WebResourceRequest) 替代.

  4. shouldInterceptRequest(WebView view, WebResourceRequest request) //通知有资源请求的主机,允许应用返回数据了。

  5. shouldOverrideKeyEvent(WebView view, KeyEvent event) //处理在浏览器中的按键事件。给主机应用同步处理事件的机会。

  6. onPageStarted(WebView view, String url, Bitmap favicon) //开始载入页面时调用的,我们可以设定一个loading的页面,告诉用户程序在等待网络响应。

  7. onPageFinished(WebView view, String url) //在页面加载结束时调用, 我们可以关闭loading 条,切换程序动作。

  8. onLoadResource(WebView view, String url) //在加载页面资源时会调用,每一个资源(比如图片)的加载都会调用一次。

  9. onReceivedError(WebView view, int errorCode, String description, String failingUrl) //报告错误信息

  10. doUpdateVisitedHistory(WebView view, String url, boolean isReload) //更新历史记录

  11. onFormResubmission(WebView view, Message dontResend, Message resend) //应用程序重新请求网页数据

  12. onReceivedHttpAuthRequest(WebView view, HttpAuthHandler handler, String host,String realm) //获取返回信息授权请求

  13. onReceivedSslError(WebView view, SslErrorHandler handler, SslError error) //让webview处理https请求。

  14. onScaleChanged(WebView view, float oldScale, float newScale) //WebView发生改变时调用

  15. onUnhandledKeyEvent(WebView view, KeyEvent event) //Key事件未被加载时调用

WebChromeClient

WebChromeClient用来帮助WebView处理JS的对话框、网址图标、网址标题和加载进度等。同样地, 通过继承WebChromeClient并重载它的方法也可以实现不同功能的定制, 如下所示:

  1. public void onProgressChanged(WebView view, int newProgress); //获得网页的加载进度,显示在右上角的TextView控件中

  2. public void onReceivedTitle(WebView view, String title); //获取Web页中的title用来设置自己界面中的title, 当加载出错的时候,比如无网络,这时onReceiveTitle中获取的标题为"找不到该网页",

  3. public void onReceivedIcon(WebView view, Bitmap icon); //获取Web页中的icon

  4. public boolean onCreateWindow(WebView view, boolean isDialog, boolean isUserGesture, Message resultMsg);

  5. public void onCloseWindow(WebView window);

  6. public boolean onJsAlert(WebView view, String url, String message, JsResult result); //处理alert弹出框,html 弹框的一种方式

  7. public boolean onJsPrompt(WebView view, String url, String message, String defaultValue, JsPromptResult result) //处理confirm弹出框

  8. public boolean onJsConfirm(WebView view, String url, String message, JsResult result); //处理prompt弹出框

WebView生命周期

  1. onResume()
    WebView为活跃状态时回调,可以正常执行网页的响应。

  2. onPause()
    WebView被切换到后台时回调, 页面被失去焦点, 变成不可见状态,onPause动作通知内核暂停所有的动作,比如DOM的解析、plugin的执行、JavaScript执行。

  3. pauseTimers()
    当应用程序被切换到后台时回调,该方法针对全应用程序的WebView,它会暂停所有webview的layout,parsing,javascripttimer。降低CPU功耗。

  4. resumeTimers()
    恢复pauseTimers时的动作。

  5. destroy()
    关闭了Activity时回调, WebView调用destory时, WebView仍绑定在Activity上.这是由于自定义WebView构建时传入了该Activity的context对象, 因此需要先从父
    容器中移除WebView, 然后再销毁webview。

mRootLayout.removeView(webView);  
mWebView.destroy();

WebView的常用方法

 mWebView.loadUrl("http://www.jianshu.com/u/fa272f63280a");// 加载url,也可以执行js函数
    mWebView.setWebViewClient(new SafeWebViewClient());// 设置 WebViewClient 
    mWebView.setWebChromeClient(new SafeWebChromeClient());// 设置 WebChromeClient
    mWebView.onResume();// 生命周期onResume
    mWebView.resumeTimers();//生命周期resumeTimers
    mWebView.onPause();//生命周期onPause
    mWebView.pauseTimers();//生命周期pauseTimers (上数四个方法都是成对出现)
    mWebView.stopLoading();// 停止当前加载
    mWebView.clearMatches();// 清除网页查找的高亮匹配字符。
    mWebView.clearHistory();// 清除当前 WebView 访问的历史记录
    mWebView.clearSslPreferences();//清除ssl信息
    mWebView.clearCache(true);//清空网页访问留下的缓存数据。需要注意的时,由于缓存是全局的,所以只要是WebView用到的缓存都会被清空,即便其他地方也会使用到。该方法接受一个参数,从命名即可看出作用。若设为false,则只清空内存里的资源缓存,而不清空磁盘里的。
    mWebView.loadUrl("about:blank");// 清空当前加载
    mWebView.removeAllViews();// 清空子 View
    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.JELLY_BEAN_MR2) {
        mWebView.removeJavascriptInterface("AndroidNative");// 向 Web端注入 java 对象
    }
    mWebView.destroy();// 生命周期销毁

参考文档

  1. Building web apps in WebView-https://developer.android.com/guide/webapps/webview#java
  2. Best practices for web apps
  3. 处理运行时变更
  4. WebView三部曲:基本用法
  5. WebView三部曲:性能优化

你可能感兴趣的:(Android WebView)