一个显示网页的视图。这个类是你可以滚动自己的Web浏览器或在你的Activity中简单地显示一些在线内容的基础。它使用了WebKit渲染引擎来显示网页,包括向前和向后导航的方法(通过历史记录),放大和缩小,执行文本搜索等。
需要注意的是:为了让你的应用能够使用WebView访问互联网和加载网页,你必须添加Internet的权限在Android Manifest文件中:
<uses-permission android:name="android.permission.INTERNET" />
java.lang.Object ? android.view.View ? android.view.ViewGroup ? android.widget.AbsoluteLayout ? android.webkit.WebView
Public Methods |
|
WebSettings |
getSettings() 获取设置WebView的WebSettings对象。 |
void |
setWebViewClient(WebViewClient client) 设置将接收各种通知和请求的WebViewClient。 |
void |
setWebChromeClient(WebChromeClient client) 设置chrome处理。 |
说明:
WebSettings getSettings()获取设置WebView的WebSettings对象。
方法 |
说明 |
setAllowFileAccess |
启用或禁用WebView访问文件数据 |
setBlockNetworkImage |
是否显示网络图像 |
setBuiltInZoomControls |
设置是否支持缩放 |
setCacheMode |
设置缓冲的模式 |
setDefaultFontSize |
设置默认的字体大小 |
setDefaultTextEncodingName |
设置在解码时时候用的默认编码 |
setFixedFontFamily |
设置固定使用的字体 |
setJavaScriptEnabled |
设置是否支持Javascript |
setLayoutAlgorithm |
设置布局方式 |
setLightTouchEnabled |
设置用鼠标激活被选项 |
setSupportZoom |
设置是否支持变焦 |
void setWebViewClient(WebViewClient client)
设置将接收各种通知和请求的WebViewClient。
方法 |
说明 |
doUpdateVisitedHistory |
更新历史记录 |
onFormResubmission |
应用程序重新请求网页数据 |
onLoadResource |
加载指定地址提供的资源 |
onPageFinished |
网页加载完毕 |
onPageStarted |
网页开始加载 |
onReceivedError |
报告错误信息 |
onScaleChanged |
WebView发生改变 |
shouldOverrideUrlLoading |
控制新的连接在当前WebView中打开 |
void setWebChromeClient(WebChromeClient client) 设置chrome处理。
方法 |
说明 |
onCloseWindow |
关闭WebView |
onCreateWindow |
创建WebView |
onJsAlert |
处理Javascript中的Alert对话框 |
onJsConfirm |
处理Javascript中的Confirm对话框 |
onJsPrompt |
处理Javascript中的Prompt对话框 |
onProgressChanged |
加载进度条改变 |
onReceivedlcon |
网页图标更改 |
onReceivedTitle |
网页Title更改 |
onRequestFocus WebView |
显示焦点 |
下面是一个更加复杂的例子,显示错误处理, 设置和进展通知:
// Let's display the progress in the activity title bar, like the // browser appdoes. getWindow().requestFeature(Window.FEATURE_PROGRESS); webview.getSettings().setJavaScriptEnabled(true); final Activity activity = this; webview.setWebChromeClient(new WebChromeClient() { public void onProgressChanged(WebView view, int progress) { //Activities and WebViews measure progress with different scales. //The progress meter will automatically disappear when we reach 100% activity.setProgress(progress * 1000); } }); webview.setWebViewClient(new WebViewClient() { public void onReceivedError(WebView view, int errorCode, String description, String failingUrl) { Toast.makeText(activity, "Oh no! " + description, Toast.LENGTH_SHORT).show(); } }); webview.loadUrl("http://developer.android.com/");
可以通过 设置 WebSettings.setBuiltInZoomControls(boolean) ,启用内置缩放。
注意:使用缩放,如果不是高度或宽度设置为WRAP_CONTENT可能会导致不确定的行为,应该避免。
出于显而易见的安全原因,您的应用程序都有自己的缓存,cookie存储等,它不共享浏览器应用程序的数据。
默认情况下,通过HTML请求打开新的窗口将被忽略。这是确切的它们是被JavaScript打开还是被目标链接打开。您可以自定义您的WebChromeClient提供自己的行为打开多个窗口,并使用你想要的任何方式渲染它们。
如果你想提供一个Web应用程序(或只是一个网页)作为客户端应用程序的一部分,你可以使用WebView做到这一点。WebView类是Android的View类的一个扩展,它可以让你显示网页作为你的活动布局的一部分。它不包括一个完全开发的Web浏览器的任何功能,如导航控件或一个地址栏。所有的WebView默认情况下是显示一个Web页面。
一个使用WebView的常见的场景:是当你想要在你的应用程序中提供可能需要更新的信息,如一个终端用户协议或用户指南,那么使用WebView是很有帮助的。 在你的Android应用程序中你可以创建一个包含WebView的Activity然后用它来显示的在线托管的文档。
另一个使用WebView的常见的场景:是如果你的应用程序提供的数据总是需要从Internet上获取,如电子邮件。在这种情况下,你可能会发现它更容易在你的Android应用程序,显示所有的用户数据的网页,而不是执行一个网络请求,然后解析??数据,并渲染它在Android的布局,以建立一个WebView。相反,你可以设计的专为Android设备的网页,然后实施的WebView在你的Android应用程序加载的网页。
下面将向你展示如何开始使用WebView,以及如何做一些额外的事情,比如在你的Android应用程序中处理页面导航和从网页上绑定JavaScript到客户端的代码。
默认情况下,WebView不提供类似浏览器的窗口小部件,不启用JavaScript和网页错误被忽略。如果你的目的只是显示一些HTML作为用户界面的一部分,这也许还不错;用户将不再需要与网页进行交互阅读,并且该网页将不需要与用户进行交互。如果你需要一个全面的Web浏览器,那么你可能要调用浏览器应用程序来加载URL,而不是用WebView中显示它。例如:
1) 在你的APP中添加一个WebView:
<?xml version="1.0" encoding="utf-8"?> <WebView xmlns:android="http://schemas.android.com/apk/res/android" android:id="@+id/webview" android:layout_width="fill_parent" android:layout_height="fill_parent" />2) 使用loadUrl()方法加载一个web页面:
WebView myWebView = (WebView) findViewById(R.id.webview); myWebView.loadUrl("http://www.example.com");
<manifest ... > <uses-permission android:name="android.permission.INTERNET" /> </manifest>以上就是显示一个最基本的web页面所有的步骤。
如果你计划在你的WebView加载网页时使用JavaScript,你必须为你的WebView启用JavaScript。一旦启用JavaScript,你还可以创建你的应用程序代码和JavaScript代码之间的接口。
JavaScript在WebView中默认情况下是被禁用的。你可以通过附加在WebView上的WebSettings启用它。即使用getSettings()获取WebSettings ,然后启用使用setJavaScriptEnabled()方法启用JavaScript。
WebView myWebView = (WebView) findViewById(R.id.webview); WebSettings webSettings = myWebView.getSettings(); webSettings.setJavaScriptEnabled(true);
在开发一个web应用程序,专门设计的WebView在你的Android应用程序中,您可以创建您的JavaScript代码和客户端Android代码之间的接口。例如,您的JavaScript代码可以在你的Android代码中调用一个方法来显示Dialog,而不是使用JavaScriptalert()方法。
调用addJavascriptInterface()方法绑定一个新的JavaScript和Android代码之间的接口。通过它 一个类实例绑定到你的JavaScrip,JavaScript可以调用一个接口名称访问类。
public class WebAppInterface { Context mContext; /** Instantiatethe interface and set the context */ WebAppInterface(Context c) { mContext = c; } /** Show a toastfrom the web page */ @JavascriptInterface public void showToast(String toast) { Toast.makeText(mContext, toast, Toast.LENGTH_SHORT).show(); } }
在上面这个例子中,WebAppInterface 类允许网页调用showToast()方法创建一个Toast 消息。
你可以通过addJavascriptInterface()方法和Android接口名,绑定这个类到运行在你的WebView中的JavaScript上。
WebView webView = (WebView) findViewById(R.id.webview); webView.addJavascriptInterface(new WebAppInterface(this), "Android");
<input type="button" value="Sayhello" onClick="showAndroidToast('Hello Android!')" /> <script type="text/javascript"> function showAndroidToast(toast) { Android.showToast(toast); } </script>
注:绑定到你的JavaScript对象运行在另一个线程,而不是在它构建的线程。
警告:使用addJavascriptInterface()将允许 JavaScript来控制你的Android应用程序。 这是一个非常有用的特性或危险的安全问题。 当WebView的HTML是不值得信任的(例如,部分或全部的HTML是由一个不知名的人或进程提供的),那么攻击将者执行包括在HTML和选择的任何客户端代码。因此,不应该使用addJavascriptInterface()除非你写的所有HTML和JavaScript出现在你WebView。 你应该也不允许用户导航到其他不是自己的网页,,在你的WebView内(相反,允许用户的通过默认浏览器应用程序打开外部链接。应用的web浏览器打开所有的URL链接,所以要小心你只有在处理页面导航中描述以下部分)。
当用户单击在WebView上的链接时,默认行为是启动一个处理URL的Android应用。通常默认网页浏览器打开和装在目的URL。但是你可以为WebView覆盖这个行为,以便在你的WebView上打开链接。然后,您可以允许用户前后浏览通过的由您的WebView保留的网页历史记录。
要打开用户点击链接,只是提供一个WebViewClient为您的WebView,使用setWebViewClient()。
WebView myWebView = (WebView) findViewById(R.id.webview); myWebView.setWebViewClient(new WebViewClient());
如果你想更多的控制点击链接的加载,创建自己的WebViewClient的覆盖shouldOverrideUrlLoading()方法。
private class MyWebViewClient extends WebViewClient { @Override public boolean shouldOverrideUrlLoading(WebView view, String url) { if (Uri.parse(url).getHost().equals("www.example.com")) { // This is my web site, so do not override;let my WebView load the page return false; } // Otherwise, the link is not for a page on my site, so launch anotherActivity that handles URLs Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url)); startActivity(intent); return true; } }
WebView myWebView = (WebView) findViewById(R.id.webview); myWebView.setWebViewClient(new MyWebViewClient());
当你的WebView重载URL加载的时,WebView会自动累加访问过的网页的历史记录。您可以通过goBack()和 goForward()方法向后、向前浏览。
@Override public boolean onKeyDown(int keyCode, KeyEvent event) { // Check if thekey event was the Back button and if there's history if ((keyCode == KeyEvent.KEYCODE_BACK) && myWebView.canGoBack()) { myWebView.goBack(); return true; } // If it wasn'tthe Back key or there's no web page history, bubble up to the default // systembehavior (probably exit the activity) return super.onKeyDown(keyCode, event); }
如果有一个实际的网页历史记录用户访问的canGoBack()方法返回true。同样地,你可以使用canGoForward()来检查是否有历史前进。如果不执行此检查,那么一旦用户到达历史的终结,GoBack()或goForward()什么也不做。
Android开发之WebView详解,布布扣,bubuko.com
原文:http://blog.csdn.net/fengyuzhengfan/article/details/38326861