太简单的基础就不罗嗦。。。
1:App内打开网页
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
String url = "https://www.google.com";
WebView webView = (WebView) findViewById(R.id.web_view);
webView.loadUrl(url);
webView.setWebViewClient(new WebViewClient() {
@Override
public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
view.loadUrl(request.toString());
return true;
}
});
}
2:方法简介
(1)、String webView.getUrl(); 获取当前页面URL
(2)、webView.reload();重新加载页面,即刷新当前页面
(3)、boolean canGoBack():用来确认WebView里是否还有可回退的历史记录。通常我们会在WebView里重写返回键的点击事件,通过该方法判断WebView里是否还有历史记录,若有则返回上一页。
(4)、boolean canGoForward():用来确认WebView是否还有可向前的历史记录。
(5)、boolean canGoBackOrForward(int steps):以当前的页面为起始点,用来确认WebView的历史记录是否足以后退或前进给定的步数,正数为前进,负数为后退。
注:有兴趣的可以自己捣鼓看下(3)(4)(5)的区别,这里就不多啰嗦了
(6)、goBack():在WebView历史记录后退到上一项。
(7)、goForward():在WebView历史记录里前进到下一项。
(8)、goBackOrForward(int steps):以当前页面为起始点,前进或后退历史记录中指定的步数,正数为前进,负数为后退。
(9)、clearCache(boolean includeDiskFiles):清空网页访问留下的缓存数据。需要注意的时,由于缓存是全局的,所以只要是WebView用到的缓存都会被清空,即便其他地方也会使用到。该方法接受一个参数,从命名即可看出作用。若设为false,则只清空内存里的资源缓存,而不清空磁盘里的。
(10)、clearHistory():清除当前webview访问的历史记录。
(11)、clearFormData():清除自动完成填充的表单数据。需要注意的是,该方法仅仅清除当前表单域自动完成填充的表单数据,并不会清除WebView存储到本地的数据。
(12)、
getScrollY():该方法返回的当前可见区域的顶端距整个页面顶端的距离,也就是当前内容滚动的距离。
•getHeight():方法都返回当前WebView这个容器的高度。其实以上两个方法都属于View。
•getContentHeight():该方法返回整个HTML页面的高度,但该高度值并不等同于当前整个页面的高度,因为WebView有缩放功能, 所以当前整个页面的高度实际上应该是原始HTML的高度再乘上缩放比例。因此,准确的判断方法应该是
if (webView.getContentHeight() * webView.getScale() == (webView.getHeight() + webView.getScrollY())) {
//已经处于底端
}
if(webView.getScrollY() == 0){
//处于顶端
}
pageUp(boolean top):将WebView展示的页面滑动至顶部。
pageDown(boolean bottom):将WebView展示的页面滑动至底部。
二、WebSettings
WebSettings是用来管理WebView配置的类。当WebView第一次创建时,内部会包含一个默认配置的集合。若我们想更改这些配置,便可以通过WebSettings里的方法来进行设置。
WebSettings对象可以通过WebView.getSettings()获得,它的生命周期是与它的WebView本身息息相关的,如果WebView被销毁了,那么任何由WebSettings调用的方法也同样不能使用。
获取WebSettings对象
WebSettings webSettings = webView.getSettings();
WebSettings常用方法
setJavaScriptEnabled(boolean flag):设置WebView是否可以运行JavaScript。
setJavaScriptCanOpenWindowsAutomatically(boolean flag):设置WebView是否可以由JavaScript自动打开窗口,默认为false,通常与JavaScript的window.open()配合使用。
setAllowFileAccess(boolean allow):启用或禁用WebView访问文件数据
setBlockNetworkImage(boolean flag):禁止或允许WebView从网络上加载图片。需要注意的是,如果设置是从禁止到允许的转变的话,图片数据并不会在设置改变后立刻去获取,而是在WebView调用reload()的时候才会生效。这个时候,需要确保这个app拥有访问Internet的权限,否则会抛出安全异常。通常没有禁止图片加载的需求的时候,完全不用管这个方法,因为当我们的app拥有访问Internet的权限时,这个flag的默认值就是false。
setSupportZoom(boolean support):设置是否支持缩放。
setBuiltInZoomControls(boolean enabled):显示或不显示缩放按钮(wap网页不支持)。
setSupportMultipleWindows(boolean support):设置WebView是否支持多窗口。
setAppCachePath(String appCachePath):设置应用缓存路径,这个路径必须是可以让app写入文件的。该方法应该只被调用一次,重复调用会被无视~
setCacheMode(int mode):用来设置WebView的缓存模式。当我们加载页面或从上一个页面返回的时候,会按照设置的缓存模式去检查并使用(或不使用)缓存。
缓存模式有四种:
1.LOAD_DEFAULT:默认的缓存使用模式。在进行页面前进或后退的操作时,如果缓存可用并未过期就优先加载缓存,否则从网络上加载数据。这样可以减少页面的网络请求次数。
2.LOAD_CACHE_ELSE_NETWORK:只要缓存可用就加载缓存,哪怕它们已经过期失效。如果缓存不可用就从网络上加载数据。
3.LOAD_NO_CACHE:不加载缓存,只从网络加载数据。
4.LOAD_CACHE_ONLY:不从网络加载数据,只从缓存加载数据。
setDatabaseEnabled(boolean flag):启用或禁用数据库缓存。
•setDomStorageEnabled(boolean flag):启用或禁用DOM缓存。
•setUserAgentString(String ua):设置WebView的UserAgent值。
•setDefaultEncodingName(String encoding):设置编码格式,通常都设为“UTF-8”。
•setStandardFontFamily(String font):设置标准的字体族,默认“sans-serif”。
三、WebViewClient
onLoadResource(WebView view, String url):该方法在加载页面资源时会回调,每一个资源(比如图片)的加载都会调用一次。
onPageStarted(WebView view, String url, Bitmap favicon):该方法在WebView开始加载页面且仅在Main frame loading(即整页加载)时回调,一次Main frame的加载只会回调该方法一次。我们可以在这个方法里设定开启一个加载的动画,告诉用户程序在等待网络的响应。
onPageFinished(WebView view, String url):该方法只在WebView完成一个页面加载时调用一次(同样也只在Main frame loading时调用),我们可以可以在此时关闭加载动画,进行其他操作。
onReceivedError(WebView view, WebResourceRequest request, WebResourceError error):该方法在web页面加载错误时回调,这些错误通常都是由无法与服务器正常连接引起的,最常见的就是网络问题。 这个方法有两个地方需要注意:
(1)1.这个方法只在与服务器无法正常连接时调用,类似于服务器返回错误码的那种错误(即HTTP ERROR)
(2)这个方法是新版本的onReceivedError()方法,从API23开始引进,与旧方法onReceivedError(WebView view,int errorCode,String description,String failingUrl)不同的是,新方法在页面局部加载发生错误时也会被调用(比如页面里两个子Tab或者一张图片)。这就意味着该方法的调用频率可能会更加频繁,所以我们应该在该方法里执行尽量少的操作。
boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request):哈~ 终于到了这个方法,在最开始的基础演示时我们用到了这个方法。从实践中我们知道,当我们没有给WebView提供WebViewClient时,WebView如果要加载一个url会向ActivityManager寻求一个适合的处理者来加载该url(比如系统自带的浏览器),这通常是我们不想看到的。
于是我们需要给WebView提供一个WebViewClient,并重写该方法返回true来告知WebView url的加载就在app中进行。这时便可以实现在app内访问网页。
•onScaleChanged(WebView view, float oldScale, float newScale):当WebView得页面Scale值发生改变时回调。
•boolean shouldOverrideKeyEvent(WebView view, KeyEvent event):默认值为false,重写此方法并return true可以让我们在WebView内处理按键事件。
四、WebChromeClient
WebChromeClient是辅助WebView处理Javascript的对话框,网站图标,网站title,加载进度等偏外部事件的
onProgressChanged(WebView view, int newProgress):当页面加载的进度发生改变时回调,用来告知主程序当前页面的加载进度。
•onReceivedIcon(WebView view, Bitmap icon):用来接收web页面的icon,我们可以在这里将该页面的icon设置到Toolbar。
•onReceivedTitle(WebView view, String title):用来接收web页面的title,我们可以在这里将页面的title设置到Toolbar。
以下两个方法是为了支持web页面进入全屏模式而存在的(比如播放视频),如果不实现这两个方法,该web上的内容便不能进入全屏模式。
•onShowCustomView(View view, WebChromeClient.CustomViewCallback callback):该方法在当前页面进入全屏模式时回调,主程序必须提供一个包含当前web内容(视频 or Something)的自定义的View。
•onHideCustomView():该方法在当前页面退出全屏模式时回调,主程序应在这时隐藏之前show出来的View。
•Bitmap getDefaultVideoPoster():当我们的Web页面包含视频时,我们可以在HTML里为它设置一个预览图,WebView会在绘制页面时根据它的宽高为它布局。而当我们处于弱网状态下时,我们没有比较快的获取该图片,那WebView绘制页面时的gitWidth()方法就会报出空指针异常~ 于是app就crash了。。
这时我们就需要重写该方法,在我们尚未获取web页面上的video预览图时,给予它一个本地的图片,避免空指针的发生。
•View getVideoLoadingProgressView():重写该方法可以在视频loading时给予一个自定义的View,可以是加载圆环 or something。
•boolean onJsAlert(WebView view, String url, String message, JsResult result):处理Javascript中的Alert对话框。
•boolean onJsPrompt(WebView view, String url, String message, String defaultValue, JsPromptResult result):处理Javascript中的Prompt对话框。
•boolean onJsConfirm(WebView view, String url, String message, JsResult result):处理Javascript中的Confirm对话框
•boolean onShowFileChooser(WebView webView, ValueCallback filePathCallback, WebChromeClient.FileChooserParams fileChooserParams):该方法在用户进行了web上某个需要上传文件的操作时回调。我们应该在这里打开一个文件选择器,如果要取消这个请求我们可以调用filePathCallback.onReceiveValue(null)并返回true。
•onPermissionRequest(PermissionRequest request):该方法在web页面请求某个尚未被允许或拒绝的权限时回调,主程序在此时调用grant(String [])或deny()方法。如果该方法没有被重写,则默认拒绝web页面请求的权限。
•onPermissionRequestCanceled(PermissionRequest request):该方法在web权限申请权限被取消时回调,这时应该隐藏任何与之相关的UI界面。
五、Js与WebView交互
利用WebView调用网页上的JavaScript代码
在WebView中调用Js的基本格式为webView.loadUrl("javascript:methodName(parameterValues)");
现有以下这段JavaScript代码
function readyToGo() {
alert("Hello")
}
function alertMessage(message) {
alert(message)
}
function getYourCar(){
return "Car";
}
1. WebView调用JavaScript无参无返回值函数
String call = "javascript:readyToGo()";
webView.loadUrl(call);
2. WebView调用JavScript有参无返回值函数
String call = "javascript:alertMessage(\"" + "content" + "\")";
webView.loadUrl(call);
3. WebView调用JavaScript有参数有返回值的函数
@TargetApi(Build.VERSION_CODES.KITKAT)
private void evaluateJavaScript(WebView webView){
webView.evaluateJavascript("getYourCar()", new ValueCallback<String>() {
@Override
public void onReceiveValue(String s) {
Log.d("findCar",s);
}
});
}
JavaScript通过WebView调用Java代码
从API19开始,Android提供了@JavascriptInterface对象注解的方式来建立起Javascript对象和Android原生对象的绑定,提供给JavScript调用的函数必须带有@JavascriptInterface。
演示一 JavaScript调用Android Toast方法
- 编写Java原生方法并用使用@JavascriptInterface注解
@JavascriptInterface
public void show(String s){
Toast.makeText(getApplication(), s, Toast.LENGTH_SHORT).show();
}
2.注册JavaScriptInterface
webView.addJavascriptInterface(this, "android");
addJavascriptInterface的作用是把this所代表的类映射为JavaScript中的android对象
3.编写JavaScript代码
function toastClick(){
window.android.show("JavaScript called~!");
}
演示二 JavaScript调用有返回值的Java方法
1.定义一个带返回值的Java方法,并使用@JavaInterface:
@JavaInterface
public String getMessage(){
return "Hello,boy~";
}
2.添加JavaScript的映射
webView.addJavaScriptInterface(this,"Android");
3.通过JavaScript调用Java方法
function showHello(){
var str=window.Android.getMessage();
console.log(str);
}