一、简介
- WebView是Android系统中的原生控件,其主要功能与前端页面进行响应交互,快捷省时地实现如期的功能,相当于增强版的内置浏览器。
- 使用时需要在配置文件里设置网络权限,定义布局大小和样式,绑定和操作控件。
manifest.xml
<uses-permission android:name="android.permission.INTERNET" />
activity_main.xml
<WebView
android:id="@+id/web_view"
android:layout_width="match_parent"
android:layout_height="match_parent">
</WebView>
MainActivity.java
String url = "https://www.baidu.com";
WebView webView = (WebView) findViewById(R.id.web_view);
webView.loadUrl(url);
boolean back = webview.canGoBack(); -> 判断网页是否可以回退
webview.goBack(); -> 回退一页
boolean forward = webview.canGoForward(); -> 判断网页是否可以前进
webview.goForward(); -> 前进一页
webview.goBackOrForward(1); -> 正数为前进
webview.goBackOrForward(-1); -> 负数为后退
二、生命周期
- onResume():活跃状态,可以正常执行网页的响应。
- onPause():暂停状态,页面被失去焦点,暂停所有进行中的动作,如:DOM解析、CSS和JavaScript执行等。
- pauseTimers():全局WebView暂停状态,如:layout、parsing、javascripttimer等。
- resumeTimers():恢复到pauseTimers()执行前的状态。
- destroy():销毁状态,释放资源。
- 注意:使用WebView不当容易引起内存泄漏,所以WebView的生命周期方法应跟随Activity的生命周期的方法来调用。
三、 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); -> 是否从网络获取资源
四、WebViewClient
- 控件客户端,用于处理各种通知和请求事件。
- onPageStarted():页面开始加载时调用,这时候可以显示加载进度条,让用户耐心等待页面的加载。
- onPageFinished():页面完成加载时调用,这时候可以隐藏加载进度条,提醒用户页面已经完成加载。
- onLoadResource():页面每次加载资源时调用。
- shouldOverrideUrlLoading():WebView加载url默认会调用系统的浏览器,通过重写该方法,实现在当前应用内完成页面加载。
- onReceivedError():页面加载发生错误时调用,这时候可以跳转到自定义的错误提醒页面,总比系统默认的错误页面美观,优化用户体验。
- onReceivedHttpError():页面加载请求时发生错误。
- onReceivedSslError():页面加载资源时发生错误。
- shouldOverrideKeyEvent():覆盖按键默认的响应事件,这时候可以根据自身的需求在点击某些按键时加入相应的逻辑。
- onScaleChanged():页面的缩放比例发生变化时调用,这时候可以根据当前的缩放比例来重新调整WebView中显示的内容,如修改字体大小、图片大小等。
- shouldInterceptRequest():可以根据请求携带的内容来判断是否需要拦截请求。
WebViewClient webViewClient = new WebViewClient(){
@Override
public void onPageStarted(WebView view, String url, Bitmap favicon) {
}
@Override
public void onPageFinished(WebView view, String url) {
}
@Override
public boolean onLoadResource(WebView view, String url) {
}
@Override
public boolean shouldOverrideUrlLoading(WebView view, String url) {
view.loadUrl(url);
return true; -> 消费事件终止传递
}
@Override
public void onReceivedError(WebView view, int errorCode,
String description, String failingUrl){
view.loadUrl("file:///android_assets/error.html"); -> assets目录下放置文件
}
webView.setWebViewClient(webViewClient);
五、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():媒体文件退出全屏时调用。
WebChromeClient webChromeClient = new WebChromeClient();
六、Android调用JS
- 语法:webView.loadUrl("javascript:method()");
- 在Web页面中定义两个Js方法,分别是有返回值和无返回值。
let name = '';
function setter(name){
this.name = name;
}
function getter(){
return this.name;
}
String setter = "javascript:setter('"+"wjx"+"');";
webView.loadUrl(setter); -> 调用有参无返回值的函数
webView.evaluateJavascript("getter()", new ValueCallback<String>() {
@Override
public void onReceiveValue(String s) { -> 调用无参有返回值的函数
System.out.println("my name is "+s);
}
});
七、Js调用Android
webView.addJavascriptInterface(this, "bridge"); -> 建立通讯桥梁
webView.removeJavascriptInterface("bridge"); -> 移除通讯桥梁
@JavascriptInterface
public void toast(String toast){
Toast.makeText(MainActivity.this, toast, Toast.LENGTH_SHORT).show();
}
function toast(toast){
javascript:bridge.toast(toast); -> 通过桥梁调用方法
window.bridge.toast(toast); -> 通过桥梁调用方法
}