一、简介
WebView是一个基于webkit引擎、继承自View,用于展现web页面的控件。
Android的Webview在低版本和高版本采用了不同的webkit版本内核,4.4后直接使用了 Chromium。更改后会提升WebView性能,并支持HTML5,CSS3和JavaScript的标准已匹配最新的Web浏览器。
二、使用介绍
- WebView类常见方法
- WebView工具类WebSettings、WebViewClient、WebChromeClient
2.1 WebView类常用方法
2.2.1加载URL
//1、加载网页
webView.loadUrl("https://www.baidu.com/");
//2、加载assets中的html文件
webView.loadUrl("file:///android_asset/demo.html");
//3、加载手机本地html文件
webView.loadUrl("content://com.android.htmlfileprovider/sdcard/test.html"");
//4、加载html中的部分内容
loadData(String data, String mimeType, String encoding);
参数说明:
data String: a String of data in the given encoding '#',* '%', '\', '?' should be replaced by %23, %25, %27, %3f respectively
mimeType String: the MIME type of the data, e.g. 'text/html'. This value may be null.
encoding String: the encoding of the data This value may be null.
2.1.2WebView的状态
//在上一次调用onPause()后恢复WebView为活跃状态,能正常执行网页的响应
webView.onResume();
//尽可能的暂停可以安全暂停的处理,如动画和定位。注意这个调用不会暂停Java//Script,要全局暂停JavaScript需要使用pauseTimers()
webView.onPause();
//暂停所有的WebView的layout、parsing和JavaScript计时器。这个是一个全局的//请求,并不是针对当前的WebView。当应用程序切换到后台时这个方法会很有用。
webView.pauseTimers();
//恢复所有WebView的layout、parsing和JavaScript计时器
webView.resumeTimers();
//销毁Webview
//在关闭了Activity时,如果Webview的音乐或视频,还在播放。就必须销毁Webview
//但是注意:webview调用destory时,webview仍绑定在Activity上
//这是由于自定义webview构建时传入了该Activity的context对象
//因此需要先从父容器中移除webview,然后再销毁webview:
rootLayout.removeView(webView);
//一定要父容器中移除后调用此方法,销毁后不能在此WebView上调用其他方法
webView.destory();
2.1.3前进 / 后退网页方法
//是否可以后退
Webview.canGoBack()
//后退网页
Webview.goBack()
//是否可以前进
Webview.canGoForward()
//前进网页
Webview.goForward()
//以当前的index为起始点前进或者后退到历史记录中指定的steps
//如果steps为负数则为后退,正数则为前进
Webview.goBackOrForward(intsteps)
常见用法:Back键控制网页后退
public void onBackPressed(){
if(webView != null && webView.canGoBack()){
webView.goBack();
return;
}
super.onBackPressed();
}
2.1.4清除缓存数据
//清除网页访问留下的缓存
//由于内核缓存是全局的因此这个方法不仅仅针对webview而是针对整个应用程序.
webView.clearCache(boolean includeDiskFiles);
//清除当前webview访问的历史记录
//只会webview访问历史记录里的所有记录除了当前访问记录
Webview.clearHistory();
//这个api仅仅清除自动完成填充的表单数据,并不会清除WebView存储到本地的数据
Webview.clearFormData();
2.2WebSetting类
作用:对WebView进行配置和管理
常用方法
//获取WebSetting子类
WebSettings settings = webView.getSettings();
//若访问页面中有JavaScript交互,则必须设置支持Javascript
settings.setJavaScriptEnabled(true);
// 若加载的 html 里有JS 在执行动画等操作,会造成资源浪费(CPU、电量)
// 在 onStop 和 onResume 里分别把 setJavaScriptEnabled() 给设置成 false 和 true 即可
//支持插件
webSettings.setPluginsEnabled(true);
//设置自适应屏幕,两者合用
webSettings.setUseWideViewPort(true); //将图片调整到适合webview的大小
webSettings.setLoadWithOverviewMode(true); // 缩放至屏幕的大小
//缩放操作
webSettings.setSupportZoom(true); //支持缩放,默认为true。是下面那个的前提。
webSettings.setBuiltInZoomControls(true); //设置内置的缩放控件。若为false,则该WebView不可缩放
webSettings.setDisplayZoomControls(false); //隐藏原生的缩放控件
//其他细节操作
webSettings.setCacheMode(WebSettings.LOAD_CACHE_ELSE_NETWORK); //关闭webview中缓存
webSettings.setAllowFileAccess(true); //设置可以访问文件
webSettings.setJavaScriptCanOpenWindowsAutomatically(true); //支持通过JS打开新窗口
webSettings.setLoadsImagesAutomatically(true); //支持自动加载图片
webSettings.setDefaultTextEncodingName("utf-8");//设置编码格式
常见用法:设置WebView缓存
当加载 html 页面时,WebView会在/data/data/包名目录下生成 database 与 cache 两个文件夹
请求的 URL记录保存在 WebViewCache.db,而 URL的内容是保存在 WebViewCache 文件夹下
是否启用缓存:
//优先使用缓存:
WebView.getSettings().setCacheMode(WebSettings.LOAD_CACHE_ELSE_NETWORK);
//缓存模式如下:
//LOAD_CACHE_ONLY: 不使用网络,只读取本地缓存数据
//LOAD_DEFAULT: (默认)根据cache-control决定是否从网络上取数据。
//LOAD_NO_CACHE: 不使用缓存,只从网络获取数据.
//LOAD_CACHE_ELSE_NETWORK,只要本地有,无论是否过期,或者no-cache,都使用缓存中的数据。
//不使用缓存:
WebView.getSettings().setCacheMode(WebSettings.LOAD_NO_CACHE);
结合使用(离线加载)
if (NetStatusUtil.isConnected(getApplicationContext())) {
webSettings.setCacheMode(WebSettings.LOAD_DEFAULT);//根据cache-control决定是否从网络上取数据。
} else {
webSettings.setCacheMode(WebSettings.LOAD_CACHE_ELSE_NETWORK);//没网,则从本地获取,即离线加载
}
webSettings.setDomStorageEnabled(true); // 开启 DOM storage API 功能
webSettings.setDatabaseEnabled(true); //开启 database storage API 功能
webSettings.setAppCacheEnabled(true);//开启 Application Caches 功能
String cacheDirPath = getFilesDir().getAbsolutePath() + APP_CACAHE_DIRNAME;
webSettings.setAppCachePath(cacheDirPath); //设置 Application Caches 缓存目录
注意: 每个 Application 只调用一次 WebSettings.setAppCachePath(),WebSettings.setAppCacheMaxSize()
3.2.2WebViewClient类
- 作用:处理各种通知和事件
- 常用方法
setWebViewClient(new WebViewClient(){
//在当前WebView中加载新的url时,给宿主应用一个接管控制权的机会。如果没有///提供WebViewClient, WebView会请求Activity //Manager为URL选择一个合适的处理程序。如果提供了WebViewClient,return //true表示宿主应用程序处理url,return false表示当前WebView处理url。
@Override
public boolean shouldOverrideUrlLoading(WebView view, String url) {
view.loadUrl(url);
return true;
//开始加载页面时调用,页面内容的变化不会调用
@Override
public void onPageStarted(WebView view, String url, Bitmap favicon) {
//设定加载开始的操作
}
//页面加载结束时调用
@Override
public void onPageFinished(WebView view, String url) {
}
//WebView将加载由给定url指定的资源
//url WebView将会加载url的资源
@Override
public void onLoadResource(WebView view, String url) {
}
//界面加载失败
@Override
public void onReceivedError(WebView view, WebResourceRequest request, WebResourceError error) {
}
}
2.3WebChromeClient类
作用:辅助 WebView 处理 Javascript 的对话框,网站图标,网站标题等等。
webView.setWebChromeClient(new WebChromeClient(){
//加载进度
@Override
public void onProgressChanged(WebView view, int newProgress) {
super.onProgressChanged(view, newProgress);
}
//获取网页标题
@Override
public void onReceivedTitle(WebView view, String title) {
super.onReceivedTitle(view, title);
}
//获取网页图标
@Override
public void onReceivedIcon(WebView view, Bitmap icon) {
super.onReceivedIcon(view, icon);
}
//支持javascript的警告框
@Override
public boolean onJsAlert(WebView view, String url, String message, JsResult result) {
return super.onJsAlert(view, url, message, result);
}
//支持javascript的确认框
@Override
public boolean onJsConfirm(WebView view, String url, String message, JsResult result) {
return super.onJsConfirm(view, url, message, result);
}
//支持javascript输入框
@Override
public boolean onJsPrompt(WebView view, String url, String message, String defaultValue, JsPromptResult result) {
return super.onJsPrompt(view, url, message, defaultValue, result);
}
});
参考资料:
WebView相关类的源码注释
https://mp.weixin.qq.com/s/0vVe-vh_OFW1nbWIv6o_4g
https://www.jianshu.com/p/b9164500d3fb
https://www.jianshu.com/p/3c94ae673e2a