使用流程
方式一
- 在Activity布局文件中添加控件
- 在代码中获取控件实例,调用loadUrl方法加载web页面
方式二
- 在Activity的onCreate方法中new一个WebView实例,传入一个Context
- 在代码中获取控件实例,调用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并重载它的方法可以实现不同功能的定制。主要方法:
shouldOverrideUrlLoading(WebView view, String url) //在网页上的所有加载都经过这个方法,这个函数我们可以做很多操作。比如获取url,查看url.contains(“add”),进行添加操作。于API level 24过时. 使用 shouldOverrideUrlLoading(WebView, WebResourceRequest) 替代.
shouldOverrideUrlLoading(WebView view, WebResourceRequest request) //在网页上的所有加载都经过这个方法,这个函数我们可以做很多操作。比如获取url,查看url.contains(“add”),进行添加操作。
shouldInterceptRequest(WebView view, String url) //通知有资源请求的主机,允许应用返回数据了。于API level 21过时. 使用 shouldInterceptRequest(WebView, WebResourceRequest) 替代.
shouldInterceptRequest(WebView view, WebResourceRequest request) //通知有资源请求的主机,允许应用返回数据了。
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事件未被加载时调用
WebChromeClient
WebChromeClient用来帮助WebView处理JS的对话框、网址图标、网址标题和加载进度等。同样地, 通过继承WebChromeClient并重载它的方法也可以实现不同功能的定制, 如下所示:
public void onProgressChanged(WebView view, int newProgress); //获得网页的加载进度,显示在右上角的TextView控件中
public void onReceivedTitle(WebView view, String title); //获取Web页中的title用来设置自己界面中的title, 当加载出错的时候,比如无网络,这时onReceiveTitle中获取的标题为"找不到该网页",
public void onReceivedIcon(WebView view, Bitmap icon); //获取Web页中的icon
public boolean onCreateWindow(WebView view, boolean isDialog, boolean isUserGesture, Message resultMsg);
public void onCloseWindow(WebView window);
public boolean onJsAlert(WebView view, String url, String message, JsResult result); //处理alert弹出框,html 弹框的一种方式
public boolean onJsPrompt(WebView view, String url, String message, String defaultValue, JsPromptResult result) //处理confirm弹出框
public boolean onJsConfirm(WebView view, String url, String message, JsResult result); //处理prompt弹出框
WebView生命周期
onResume()
WebView为活跃状态时回调,可以正常执行网页的响应。onPause()
WebView被切换到后台时回调, 页面被失去焦点, 变成不可见状态,onPause动作通知内核暂停所有的动作,比如DOM的解析、plugin的执行、JavaScript执行。pauseTimers()
当应用程序被切换到后台时回调,该方法针对全应用程序的WebView,它会暂停所有webview的layout,parsing,javascripttimer。降低CPU功耗。resumeTimers()
恢复pauseTimers时的动作。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();// 生命周期销毁
参考文档
- Building web apps in WebView-https://developer.android.com/guide/webapps/webview#java
- Best practices for web apps
- 处理运行时变更
- WebView三部曲:基本用法
- WebView三部曲:性能优化