【Android】webview常用方法和使用

文章目录

前言
一、常见用法
二、基础属性
- 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();
    }