文章目录
- 前言
- 一、常见用法
- 二、基础属性
- webView的常用方法
- WebViewClient的常用方法
- WebChromeClient的常用方法
- WebSettings的相关方法
- 三、加载流程和事件回调
- 四、webview和JS之间的互相调用
- 总结
- 五、参考链接
前言
最近项目又用到了webview,在回顾复习一次webview相关的知识,顺手整理下。
webview是一个基于webkit引擎、展现web页面的控件(4.4以下使用webkit引擎,4.4以后使用chrome内核),在Android开发中常用于展示网页和执行JavaScript。
一、常见用法
webview展示网页需要联网,网络权限需要配置,以下为常用的实现的案例
mWebview = findViewById(R.id.wb);
// 校验网络
if (!NetworkUtil.getInstance(this).isNetworkAvailable()) {
return;
}
// 允许JS调用
mWebview.getSettings().setJavaScriptEnabled(true);
// 解决白边问题
mWebview.setScrollBarStyle(View.SCROLLBARS_INSIDE_OVERLAY);
mWebview.loadUrl(“url”);
mWebview.setWebViewClient(new WebViewClient(){
@Override
public void onPageStarted(WebView view, String url, Bitmap favicon) {
super.onPageStarted(view, url, favicon);
}
@Override
public void onLoadResource(WebView view, String url) {
super.onLoadResource(view, url);
}
@Override
public void onPageFinished(WebView view, String url) {
super.onPageFinished(view, url);
}
@Override
public void onReceivedError(WebView view, WebResourceRequest request, WebResourceError error) {
super.onReceivedError(view, request, error);
}
});
注意webview内存泄露,及时释放资源
protected void onDestroy() {
if (mWebview != null) {
mWebview.loadDataWithBaseURL(null, "", "text/html", "utf-8", null);
mWebview.clearHistory();
((ViewGroup) mWebview.getParent()).removeView(mWebview);
mWebview.destroy();
mWebview = null;
}
super.onDestroy();
Log.d(TAG, "onDestroy ...");
}
二、基础属性
以下是webview中相关设置的常用方法介绍
webView的常用方法
// 恢复pauseTimers状态
1.web_view.resumeTimers();
// 它会暂停所有webview的布局显示、解析、延时,从而降低CPU功耗
2.web_view.pauseTimers();
// 激活WebView为活跃状态,能正常执行网页的响应
3.web_view.onResume();
// 当页面被失去焦点被切换到后台不可见状态,需要执行onPause()
// 通过onPause()动作通知内核暂停所有的动作,比如DOM的解析、JavaScript执行等
4.web_view.onPause();
// webview调用destory时,webview仍绑定在Activity上
// 这是由于自定义webview构建时传入了该Activity的context对象
// 因此需要先从父容器中移除webview,然后再销毁webview
rootLayout.removeView(web_view);
5.web_view.destroy();
// 是否可以后退
6.web_view.canGoBack()
// 后退网页
7.web_view.goBack()
// 是否可以前进
8.web_view.canGoForward()
// 前进网页
9.web_view.goForward()
// 清除网页访问留下的缓存
// 由于内核缓存是全局的因此这个方法不仅仅针对webview而是针对整个应用程序.
10.web_view.clearCache(true);
// 清除当前webview访问的历史记录
// 只会webview访问历史记录里的所有记录除了当前访问记录
11.web_view.clearHistory();
// 这个api仅仅清除自动完成填充的表单数据,并不会清除WebView存储到本地的数据
12.web_view.clearFormData();
WebViewClient的常用方法
WebViewClient用于处理各种通知和请求事件的一些方法。
onPageStarted():页面开始加载时调用,这时候可以显示加载进度条,让用户耐心等待页面的加载。
onPageFinished():页面完成加载时调用,这时候可以隐藏加载进度条,提醒用户页面已经完成加载。
onLoadResource():页面每次加载资源时调用。
shouldOverrideUrlLoading():WebView加载url默认会调用系统的浏览器,通过重写该方法,实现在当前应用内完成页面加载。
onReceivedError():页面加载发生错误时调用,这时候可以跳转到自定义的错误提醒页面,总比系统默认的错误页面美观,优化用户体验。
onReceivedHttpError():页面加载请求时发生错误。
onReceivedSslError():页面加载资源时发生错误。
shouldOverrideKeyEvent():覆盖按键默认的响应事件,这时候可以根据自身的需求在点击某些按键时加入相应的逻辑。
onScaleChanged():页面的缩放比例发生变化时调用,这时候可以根据当前的缩放比例来重新调整WebView中显示的内容,如修改字体大小、图片大小等。
shouldInterceptRequest():可以根据请求携带的内容来判断是否需要拦截请求。
WebChromeClient的常用方法
此类用于处理网站图标,网站标题,网站弹窗等,以下是相关方法
onProgressChanged():页面加载进度发生变化时调用,可以通过该方法实时向用户反馈加载情况,如显示进度条等。
onReceivedIcon():接收Web页面的图标,可以通过该方法把图标设置在原生的控件上,如Toolbar等。
onReceivedTitle():接收Web页面的标题,可以通过该方法把图标设置在原生的控件上,如Toolbar等。
onJsAlert():处理JS的Alert对话框。
onJsPrompt():处理JS的Prompt对话框。
onJsConfirm():处理JS的Confirm对话框。
onPermissionRequest():Web页面请求Android权限时调用。
onPermissionRequestCanceled():Web页面请求Android权限被取消时调用。
onShowFileChooser():Web页面上传文件时调用。
getVideoLoadingProgressView():自定义媒体文件播放加载时的进度条。
getDefaultVideoPoster():设置媒体文件默认的预览图。
onShowCustomView():媒体文件进入全屏时调用。
onHideCustomView():媒体文件退出全屏时调用。
WebSettings的相关方法
WebSettings webSettings = webView.getSettings();
webSettings.setJavaScriptEnabled(true); -> 是否开启JS支持
webSettings.setPluginsEnabled(true); -> 是否开启插件支持
webSettings.setJavaScriptCanOpenWindowsAutomatically(true); -> 是否允许JS打开新窗口
webSettings.setUseWideViewPort(true); -> 缩放至屏幕大小
webSettings.setLoadWithOverviewMode(true); -> 缩放至屏幕大小
webSettings.setSupportZoom(true); -> 是否支持缩放
webSettings.setBuiltInZoomControls(true); -> 是否支持缩放变焦,前提是支持缩放
webSettings.setDisplayZoomControls(false); -> 是否隐藏缩放控件
webSettings.setAllowFileAccess(true); -> 是否允许访问文件
webSettings.setDomStorageEnabled(true); -> 是否节点缓存
webSettings.setDatabaseEnabled(true); -> 是否数据缓存
webSettings.setAppCacheEnabled(true); -> 是否应用缓存
webSettings.setAppCachePath(uri); -> 设置缓存路径
webSettings.setMediaPlaybackRequiresUserGesture(false); -> 是否要手势触发媒体
webSettings.setStandardFontFamily("sans-serif"); -> 设置字体库格式
webSettings.setFixedFontFamily("monospace"); -> 设置字体库格式
webSettings.setSansSerifFontFamily("sans-serif"); -> 设置字体库格式
webSettings.setSerifFontFamily("sans-serif"); -> 设置字体库格式
webSettings.setCursiveFontFamily("cursive"); -> 设置字体库格式
webSettings.setFantasyFontFamily("fantasy"); -> 设置字体库格式
webSettings.setTextZoom(100); -> 设置文本缩放的百分比
webSettings.setMinimumFontSize(8); -> 设置文本字体的最小值(1~72)
webSettings.setDefaultFontSize(16); -> 设置文本字体默认的大小
webSettings.setLayoutAlgorithm(LayoutAlgorithm.SINGLE_COLUMN); -> 按规则重新布局
webSettings.setLoadsImagesAutomatically(false); -> 是否自动加载图片
webSettings.setDefaultTextEncodingName("UTF-8"); -> 设置编码格式
webSettings.setNeedInitialFocus(true); -> 是否需要获取焦点
webSettings.setGeolocationEnabled(false); -> 设置开启定位功能
webSettings.setBlockNetworkLoads(false); -> 是否从网络获取资源
三、加载流程和事件回调
webview从loadUrl加载开始到onPageFinished页面加载完成,其中的加载流程和事件回调,这篇文章讲得很详细,
深入理解Android WebView的加载流程与事件回调
四、webview和JS之间的互相调用
对于JS调用Android方式3种:
1.通过WebView的addJavascriptInterface()进行对象映射
2.通过 WebViewClient 的shouldOverrideUrlLoading ()方法回调拦截 url
(有问题,报了"ReferenceError: android is not defined")
3.通过 WebChromeClient 的onJsAlert()、onJsConfirm()、onJsPrompt()方法回调拦截JS对话框alert()、confirm()、prompt() 消息
对于Android调用JS方式2种:
1.通过WebView的loadUrl()
2.通过WebView的evaluateJavascript()
常用方法
Android调用JS
mWebview.evaluateJavascript("javascript:confim()", new ValueCallback<String>() {
@Override
public void onReceiveValue(String value) {
Logger.d(TAG, "webView result: ..." + value);
}
});
JS调用Android
mWebview.getSettings().setJavaScriptEnabled(true);
mWebview.addJavascriptInterface(this, "android");
@JavascriptInterface
public void closeWebview() {
Logger.d(TAG, "webView onBack ...");
finish();
}
总结
基本的webview一些用法和相关属性介绍大致就是上面这些,webview在应用中一般用于加载免责协议,使用说明,电子手册等一些需要经常动态的多文字或多数据需要经常更新或维护的场景。
五、参考链接
- Android 原生WebView的使用
- Carson带你学Android:这是一份全面&详细的WebView学习攻略