查看原文
其他

WebView的基本使用及相关特性

jzman 躬行之 2022-08-26

WebView 是一个显示网页内容的组件,可以显示网络上的一些在线内容并且可以作为 Web 浏览器滚动显示的内容,它使用 WebKit作为渲染引擎来显示网页,里面包括放大、缩小、执行文本搜索等进行前后导航的方法。

注意 :如果要在 WebView 中显示在线网页等内容时,需要在 AndroidManifest.xml 文件中添加网络权限,参考如下:

1<uses-permission android:name="android.permission.INTERNET" />

基本用法

默认情况下 WebView 不启用 JavaScript ,网页错误也将被忽略,如果仅仅是在 UI 上显示一段 HTML,这就会非常好, 用户在不需要再阅读之前与用户交互,网页不需要与用户交互 ,如果你需要一个完整的浏览器,你需要调用相应的 Intent 去启动浏览器去执行某些操作,而不是使用 WebView 来显示,调用系统浏览器使用如下代码:

1Uri uri = Uri.parse("https://www.example.com");
2Intent intent = new Intent(Intent.ACTION_VIEW, uri);
3startActivity(intent);

使用 WebView 主要有两种使用方式,在 Activity 等 onCreate() 方法直接创建使用或者在布局文件中引入,参考如下:

1. 在代码中直接创建 WebView

1WebView webview = new WebView(this);
2//这里将整个 Activity 窗口作为 WebView 的显示界面,也可单独放在某个布局中
3setContentView(webview);

2. 在布局文件中使用 WebView

1<WebView
2    android:id="@+id/webView"
3    android:layout_width="match_parent"
4    android:layout_height="match_parent">

5</WebView>

那么,我们如何加载一个网页呢,如果网页是本地的又如何加载呢,还有如何加载一段 HTML 的片段呢,常用的加载方法主要有两个,如下:

1. 加载一个完整的网页

这里测试使用百度首页、CSDN首页、腾讯首页进行测试,测试百度首页时,需要设置如下属性网页内容才能正确显示,如果不设置将显示为白屏:

1webSettings.setJavaScriptEnabled(true);
2webSettings.setDomStorageEnabled(true);
3webView.loadUrl("https://www.baidu.com");

测试 CSDN 首页时,会提示打开系统带浏览器的应用去打开该页面,设置如下属性才能直接加载网页内容:

1webView.setWebViewClient(new WebViewClient());
2webView.loadUrl("http://blog.csdn.net");

测试腾讯首页时可以直接加载首页内容:

1webView.loadUrl("http://www.qq.com");

测试环境可能不同,结果也不相同。

2. 加载本地的 HTML 文件

其中加载 SD 卡上的 HTML 文件时要申请访问 SD 卡上的权限 Manifest.permission.WRITE_EXTERNAL_STORAGE,参考如下:

1//加载 assets 目录下的 HTML 文件
2webView.loadUrl("file:///android_asset/mine.html");
3//加载 SD 卡上的 HTML 文件
4webView.loadUrl("file:///"+Environment.getExternalStorageDirectory().getAbsolutePath()+ File.separator+"mine.html");

3. 加载 HTML 片段

加载 HTML 片段时,要设置字符集,否则会出现乱码,参考如下:

1//加载 HTML 片段,设置字符集防止乱码出现
2webView.loadData(Util.getHtmlData(),"text/html; charset=UTF-8",null);

WebView 的设置与界面处理主要有以下几个方面:

  1. 创建并设置 WebChromeClient,主要是辅助 WebView 来处理 JavaScript 的对话框、网站标题、加载进度等;

  2. 创建并设置 WebViewClient, 主要是提供各种事件的回调等;

  3. 通过 WebSetting 对象可以设置 WebView 的各种相关属性,如支持 JavaScript 、设置 WebView 缓存、字体大小等;

  4. JS 与 Java 的互相调用,如使用addJavascriptInterface(Object,String)方法将Java对象注入WebView。此方法允许您将Java对象注入到页面的JavaScript上下文中,以便可以通过页面中的JavaScript访问它们。

缩放

Android 1.5 之后支持调用如下方法启用内置缩放:

1WebSettings.setBuiltInZoomControls(boolean)

注意:设置了内置缩放,WebView 的宽高又是 wrap_content,将会导致未定义的行为,使用时应该避免这种情况。

支持不同的屏幕密度

屏幕密度是基于屏幕分辨率的,低密度的屏幕每英寸可用像素更少,高密度的屏幕每英寸可用像素更多,屏幕密度是比较重要的,因为其他因素相同的情况下,根据像素定义的 UI 元素,在低密度屏幕上显示较大,在较高屏幕密度的屏幕上显示较小;为了方便 Android 将实际中的屏幕密度换算成比较广泛的屏幕密度:高、中和低。

默认情况下,WebView 缩放的网页,使其绘制的尺寸与中密度屏幕上的默认外观相匹配,所以在高密度屏幕上适用于 1.5 倍的缩放(像素较小),在低密度屏幕上适用于 0.75 倍的缩放(像素较大);从 Android 2.0 开始 WebView 支持 DOM、CSS 及 meta 标签,帮助 Web 开发人员根据不同的屏幕密度来适配目标屏幕。

下面是处理不同屏幕密度的一些说明:

  1. 使用 window.devicePixelRatio 属性指定当前设备的默认缩放因子,也指设备上物理像素和设备独立像素(device-independent pixels (dips))的比例,如果 window.devicePixelRatio 的值为 1 ,则该设备被认为是中密度(mdpi)设备,并且默认缩放不应用于网页,如果 window.devicePixelRatio 值为原来的 1.5 倍 ,则该设备被认为是高密度设备(hdpi),页面内容缩放为 1.5 倍;如果 window.devicePixelRatio 值为 0.75,则该设备被认为是低密度设备(ldpi),内容缩放为原来的 0.75 倍,用公式表示如下:

  2. 使用 -webkit-device-pixel-ratio CSS 媒体查询来指定使用此样式表的屏幕密度,其值应该为 0.75 、1 、1.5,分别指明这些样式表适用于低密度、中密度、高密度的屏幕设备,如下面的声明表明 hdpi.css 只适用于屏幕像素密度比例为 1.5 的屏幕设备,也就是适用于高密度屏幕设备。

1 <link rel="stylesheet" media="screen and (-webkit-device-pixel-ratio:1.5)" href="hdpi.css" />

HTML5 视频支持

如果在应用程序中支持 HTML 视频,需要启用硬件加速。关于硬件加速请参考:http://blog.csdn.net/eclipsexys/article/details/44228403这篇文章。

全屏支持

为了支持全屏幕,如视频或其他 HTML 内容,需要设置一个 WebChromeClient 并实现 onShowCustomView(View,WebChromeClient.CustomViewCallback) 和 onHideCustomView() 两个方法:

1. onShowCustomView

通知应用程序当前页面进入全屏模式,应用程序将以全屏模式包含 Web 内容、视频以及其他 HTML 的内容。

1/**
2 * @param view 显示的View.
3 * @param callback 调用当前页退出当前页
4 * full screen mode.
5 */

6public void onShowCustomView(View view, WebChromeClient.CustomViewCallback callback) {};

2. onHideCustomView

通知应用程序当前页面退出全屏模式,应用程序必须隐藏自定义的 View。

1public void onHideCustomView() {}

如果这两个方法中的任何一个没有实现,则对应的页面的 Web 页面不能进入全屏模式,也可以实现 getVideoLoadingProgressView() 来自定义视频缓冲时要显示的视图。

1 public View getVideoLoadingProgressView() {
2        return null;
3}

HTML5 地理位置 API

针对 Android N 以及 API level > M 的设备,地理位置 API 仅仅支持以 HTTPs 的方式,如果应用以非 HTTPS 的方式请求地理位置 API onGeolocationPermissionsShowPrompt(String, GeolocationPermissions.Callback) 方法将会被拒绝调用。

布局尺寸

建议将 WebView 的高度设置成固定值或者是 MATCH_PARENT 而不建议使用 WRAP_CONTENT ,如果 WebView 的高度使用了 MATCH_PARENT ,它的父布局高度实用 WRAP_CONTENT 会导致石梯大小不一致。

将 WebView 的高度设置成 WRAP_CONTENT 将会出现如下行为:

  1. HTML 的高度被设置成了固定值,这意味着相对于 HTML BODY 高度的元素大小可能不正确;

  2. 对于应用程序所在设备是 Android 4.4 及更早的 SDk, meta 标签将会被忽略以保证向后的兼容性;

不支持使用 WRAP_CONTENT 的布局宽度。如果使用这样的宽度,WebView 会尝试使用其父布局的宽度。

错误数据的收集

如果用户同意,WebView 的一些诊断数据将会以匿名的方式上传到 Google ,这些数据会帮助 Google 改善 WebView ,每个已初始化 WebView 的应用程序都会收集这些数据,如果想停用该功能需要在清单文件中进行如下设置:

1 <meta-data 
2    android:name="android.webkit.WebView.MetricsOptOut"
3    android:value="true" />

关于 WebView 的学习和认识就到这里,更多信息可以参考官网介绍:https://developer.android.google.cn/reference/android/webkit/WebView.html,可以添加我的微信 jzmanu 互相交流学习。

推荐阅读:

您可能也对以下帖子感兴趣

文章有问题?点此查看未经处理的缓存