API Demos 2.3学习笔记(10)-- Views->WebView
-
WebView是一个专门用来显示网页的View子类。它使用WebKit渲染引擎来显示网页，并且支持包括前进，后退，放大，缩小，文本搜索等多种功能。
WebView有一个辅助类叫WebSettings，它管理WebView的设置状态。该类的对象可以通过WebView.getSettings()方法获得。下面我们介绍几个常用的WebSettings设置：
view plainprint?
//得到WebView对象
WebView mWebView = (WebView) findViewById(R.id.wv1);
//通过WebView得到WebSettings对象
WebSettings mWebSettings = mWebView.getSettings();
//设置支持Javascript的参数
mWebSettings.setJavaScriptEnabled(true);
//设置可以支持缩放
mWebSettings.setSupportZoom(true);
//设置出现缩放工具
mWebSettings.setBuiltInZoomControls(true);
//设置默认缩放方式尺寸是far
mWebSettings.setDefaultZoom(WebSettings.ZoomDensity.FAR);
//设置允许访问文件数据
mWebSettings.setAllowFileAccess(true);
//设置是否保存密码
mWebSettings.setSavePassword(true);
//设置网页默认编码
Settings.setDefaultTextEncodingName(encoding);
有关WebSettings更多的设置选项，请参考Android SDK的帮助文档。
下面我们结合实例，简单介绍下通过WebView访问网页的三种常用方法：loadUrl、loadData以及loadDataWithBaseURL。
1、public void loadUrl(String url)
loadUrl方法很简单，只需要提供一个参数，即url地址，就可以进行自动加载。
该方法适用于加载网页、网页图片、本地网页以及本地图片。具体参考如下：
view plainprint?
WebView wv = (WebView) findViewById(R.id.wv1);
wv.requestFocus(); //请求焦点
wv.getSettings().setJavaScriptEnabled(true); //设置是否支持JavaScript
wv.getSettings().setSupportZoom(true); //设置是否支持缩放
wv.getSettings().setBuiltInZoomControls(true); //设置是否显示内建缩放工具
wv.getSettings().setSavePassword(true); //设置是否保存密码
wv.loadUrl("http://www.baidu.com/"); //加载在线网页
wv.loadUrl("http://www.2cto.com/uploadfile/2011/0930/20110930020727775.jpg"); //加载在线图片
wv.loadUrl("file:///mnt/sdcard/Google.html"); //加载本地网页(SD卡根目录下)
wv.loadUrl("http://www.2cto.com/uploadfile/2011/0930/20110930021037759.jpg"); //加载本地图片(SD卡根目录下)
注：1、后面四句包含“loadUrl”的语句分别对应加载在线网页/在线图片/本地网页/本地图片四中情况，每种情况下只取其一。
2、对于sdcard中的本地网页和图片等资源，一般url地址以 “file:///mnt/sdcard/”开头；
3、对于android项目中assets目录下的本地网页和图片等资源， 一般url地址以 “ file:///android_asset/ "开头；2、public void loadData(String data, String mimeType, String encoding)
loadData将指定的data加载到WebView中。由于本身机制的原因，该方法不能加载来自网络的内容。其中，data内的html代码中若含有以下四种字符'#', '%', '\', '?'，则应该依次替换为%23, %25, %27, %3f 。 参数mimeType，即MIME Type，也就是该资源的媒体类型，可以取值text/html, image/jpeg等。参数 encoding为网页编码，可以取值utf-8, base64等。具体参考如下：
view plainprint?
final String mimeType = "text/html"; // image/jpeg etc
final String encoding = "utf-8"; //base64 etc
String data = null;
WebView wv = (WebView) findViewById(R.id.wv7);
data = "百度"; //加载本地网页Html代码
data = "loadData方法加载本地图片
"; //加载本地图片(SD卡根目录下)
wv.requestFocus();
wv.getSettings().setDefaultTextEncodingName(encoding); //对于data中含有中文字符的，必须加上这个设置，否则会乱码。
wv.loadData(data, mimeType, encoding);
注：1、中间两个data字段分别对应加载本地网页代码和本地图片的情况；
2、经过实际操作，发现前面文本超级链接的html代码可以正常显示。点击超级链接，调用外部web浏览器打开链接。
3、经过实际操作，发现后面的本地图片其实加载不上来，无法显示。
4、loadData方法中，如果data含有中文字符，则需要调用 setDefaultTextEncodingName方法来设置WebView的text指定编码。详情请点击阅读：《关于WebView的loadData方法》3、public void loadDataWithBaseURL(String baseUrl, String data, String mimeType, String encoding, String historyUrl)
loadDataWithBaseURL方法也是将指定的data加载到WebView中。由于本身机制的原因，该方法不能加载来自网络的内容。参数mimeType，即MIME Type，也就是该资源的媒体类型，可以取值text/html, image/jpeg等。参数 encoding为网页编码，可以取值utf-8, base64等。参数baseUrl为基础目录，data中的文件路径可以是相对于基础目录的相对目录。例如：文件http://www.2cto.com/uploadfile/2011/0930/20110930021037759.jpg，baseUrl为file:///mnt/sdcard/，那么data中就可以直接引用图片 Googles_13th_Birthday-2011-hp.jpg了。参数historyUrl用作历史记录的字段，可以设置为null。具体参考如下：
view plainprint?
final String mimeType = "text/html"; // image/jpeg etc
final String encoding = "utf-8"; //base64 etc
String baseUrl = null;
String data = null;
WebView wv = (WebView) findViewById(R.id.wv9);
baseUrl = "file:///mnt/sdcard/"; //网页基础目录
data = "谷歌"; //加载本地网页Html代码(SD卡根目录下)
data = "
"; //：加载本地图片(SD卡根目录下)
wv.requestFocus();
wv.loadDataWithBaseURL(baseUrl, data, mimeType, encoding, null);
注：中间两个data字段分别对应加载本地网页和本地图片的情况。经过测试，网页和本地图片都能正常加载。
下面我们进行实例代码解析：
res-layout-webview_1.xml
view plainprint?
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="vertical">
android:layout_width="match_parent"
android:layout_height="wrap_content">
android:layout_height="wrap_content"
android:layout_width="match_parent"
/>
android:layout_height="wrap_content"
android:layout_width="match_parent"
/>
android:layout_height="wrap_content"
android:layout_width="match_parent"
/>
android:layout_height="wrap_content"
android:layout_width="match_parent"
/>
android:layout_height="wrap_content"
android:layout_width="match_parent"
/>
android:layout_height="wrap_content"
android:layout_width="match_parent"
/>
android:layout_height="wrap_content"
android:layout_width="match_parent"
/>
android:layout_height="wrap_content"
android:layout_width="match_parent"
/>
android:layout_height="wrap_content"
android:layout_width="match_parent"
/>
android:layout_height="wrap_content"
android:layout_width="match_parent"
/>
src-com.example.android.apis.view-WebView1.java
view plainprint?
package com.example.android.apis.view;
import android.app.Activity;
import android.os.Bundle;
import android.webkit.WebView;
import com.example.android.apis.R;
/**
*WebView组件(mWebView)有一个辅助类叫WebSettings，它管理WebView的设置状态。
*该对象可以通过WebView.getSettings()方法获得。
*得到WebSettings对象，设置支持Javascript的参数
*mWebView.getSettings().setJavaScriptEnabled(true);
*设置可以支持缩放
*mWebView.getSettings().setSupportZoom(true);
*设置默认缩放方式尺寸是far
*mWebView.getSettings().setDefaultZoom(WebSettings.ZoomDensity.FAR);
*设置允许访问文件数据
*mWebView.getSettings().setAllowFileAccess(true);
*设置是否保存密码
*mWebView.getSettings().setSavePassword(true);
*设置网页默认编码
*mWebView.getSettings().setDefaultTextEncodingName(encoding);
*设置出现缩放工具
*mWebView.getSettings().setBuiltInZoomControls(true);
*
*/
public class WebView1 extends Activity {
@Override
public void onCreate(Bundle icicle) {
super.onCreate(icicle);
setContentView(R.layout.webview_1);
final String mimeType = "text/html"; // image/jpeg etc
final String encoding = "utf-8"; //base64 etc
WebView wv = null;
String baseUrl = null;
String data = null;
//加载在线网页
wv = (WebView) findViewById(R.id.wv1);
wv.requestFocus(); //请求焦点
wv.getSettings().setJavaScriptEnabled(true); //设置是否支持JavaScript
wv.getSettings().setSupportZoom(true); //设置是否支持缩放
wv.getSettings().setBuiltInZoomControls(true); //设置是否显示内建缩放工具
wv.getSettings().setSavePassword(true); //设置是否保存密码
wv.loadUrl("http://www.baidu.com/");
//加载在线图片
wv = (WebView) findViewById(R.id.wv2);
wv.requestFocus();
wv.loadUrl("http://www.2cto.com/uploadfile/2011/0930/20110930020727775.jpg");
//加载本地网页(SD卡根目录下)
wv = (WebView) findViewById(R.id.wv3);
wv.requestFocus();
wv.loadUrl("file:///mnt/sdcard/Google.html");
//加载本地图片(SD卡根目录下)
wv = (WebView) findViewById(R.id.wv4);
wv.requestFocus();
wv.loadUrl("http://www.2cto.com/uploadfile/2011/0930/20110930021037759.jpg");
//加载在线网页失败，把网页地址当作字符串处理
wv = (WebView) findViewById(R.id.wv5);
data = "http://www.baidu.com/";
wv.requestFocus();
wv.loadData(data, mimeType, encoding);
//加载在线图片失败，只显示一个默认图片进行替换
wv = (WebView) findViewById(R.id.wv6);
data = "http://www.2cto.com/uploadfile/2011/0930/20110930020727775.jpg";
wv.requestFocus();
wv.loadData(data, mimeType, encoding);
//加载本地网页Html代码，可以显示超级链接。点击，调用外部浏览器打开该链接。
wv = (WebView) findViewById(R.id.wv7);
data = "百度";
wv.requestFocus();
wv.getSettings().setDefaultTextEncodingName(encoding); //对于data中含有中文字符的，必须加上这个设置，否则会乱码。
wv.loadData(data, mimeType, encoding);
//加载本地图片(SD卡根目录下)
wv = (WebView) findViewById(R.id.wv8);
data = "loadData方法加载本地图片";
wv.requestFocus();
wv.getSettings().setDefaultTextEncodingName(encoding); //对于data中含有中文字符的，必须加上这个设置，否则会乱码。
wv.loadData(data, mimeType, encoding);
//loadDataWithBaseURL方法：加载本地网页Html代码(SD卡根目录下)，可以显示超级链接。点击直接显示本地网页内容。
wv = (WebView) findViewById(R.id.wv9);
baseUrl = "file:///mnt/sdcard/"; //网页基础目录
data = "谷歌"; //相对路径，相对基础目录而言
wv.requestFocus();
wv.loadDataWithBaseURL(baseUrl, data, mimeType, encoding, null);
//loadDataWithBaseURL方法：加载本地图片(SD卡根目录下)，默认直接显示该图片
wv = (WebView) findViewById(R.id.wv10);
baseUrl = "file:///mnt/sdcard/"; //网页基础目录
data = ""; //相对路径，相对基础目录而言
wv.requestFocus();
wv.loadDataWithBaseURL(baseUrl, data, mimeType, encoding, null);
}
}关于WebView更详细的用法介绍，请点击阅读：《超好的webview学习资料》
预览效果：
