WebView与JavaScript交互的四种形式


声明:本文转载自https://my.oschina.net/ouysh1981/blog/1608923,转载目的在于传递更多信息,仅供学习交流之用。如有侵权行为,请联系我,我会及时删除。

WebView如果作为简单的网页浏览器,对于一般的浏览行为来说,已经足够了。可做为企业开发者,你的App通常要嵌入自家公司的网页,如此一来,还得考虑App与Web之间的消息传递,这就涉及到App的原生代码与Web的JS代码之间的通信了。
App与Web做为消息通信的双方,具体的交互行为分为四类,包括:App通知Web执行某项动作、App主动从Web获取信息、Web通知App执行某项动作,Web主动从App获取信息,这四种行为详细说明如下:

1. App通知Web执行某项动作

Web提供一个JavaScript方法,然后App由WebView调用loadUrl加载该JS方法,具体的App代码如下所示:

        wv_js.loadUrl("javascript:showMsgFromWeb()");

该行为的执行效果如下图所示,App通知JS调用showMsgFromWeb方法,该方法弹出了一个alert消息框。

2. App主动从Web获取信息

WebView对象调用evaluateJavascript方法,该方法通过回调接口ValueCallback获得JS的返回串,具体的App代码如下所示:

        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {             // evaluateJavascript该方法为4.4以后引入             wv_js.evaluateJavascript("getMsgFromWeb()", new ValueCallback<String>() {                 @Override                 public void onReceiveValue(String value) {                     AlertDialog.Builder builder = new AlertDialog.Builder(WebScriptActivity.this);                     builder.setTitle("来自安卓的对话框").setMessage(UnicodeToString(value));                     builder.create().show();                 }             });         } else {             Toast.makeText(this, " Android4.4之后才支持该功能", Toast.LENGTH_SHORT).show();         }

该行为的执行效果如下图所示,App通知JS调用getMsgFromWeb方法,获得返回消息后再由App自行弹窗。

3. Web通知App执行某项动作

App需要定义一个专门给JS使用的类,并在该类中实现JS要调用的方法,具体的类代码如下所示:

    private final class Client {         @JavascriptInterface         public void showMsgFromAndroid(String msg) {  //如要返回值可把void改为String等等类型             AlertDialog.Builder builder = new AlertDialog.Builder(WebScriptActivity.this);             builder.setTitle("来自安卓的对话框").setMessage(msg);             builder.create().show();         }          @JavascriptInterface         public String getMsgFromAndroid(String msg) {             return "这是Android返回的字符串:"+msg;         }     }

接着还要调用WebView对象的addJavascriptInterface方法,给这个新类注册一个实例名,然后JS才能通过该实例名调用App的方法。注册实例名的代码如下所示:

        wv_js.addJavascriptInterface(new Client(), "client");

该行为的执行效果如下图所示,Web调用App的showMsgFromAndroid方法,该方法弹出了一个AlertDialog。

4. Web主动从App获取信息

该行为的主要流程同行为三,区别在于App方法的返回值类型由void改为String,然后JS即可从App获得返回信息。
该行为的执行效果如下图所示,Web调用App的getMsgFromAndroid方法获得字符串,然后Web把该消息以alert方式弹窗。

下面是演示WebView与JavaScript交互用到的html文件源码:

<html> <head> <meta name="viewport" content="width=device-width, target-densitydpi=device-dpi" /> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <script type="text/javascript">    function showMsgFromWeb(){       alert("这是网页弹出的对话框");    }    function getMsgFromWeb(){       return "这是网页返回的字符串";    }    function showMsgInAndroid(){       var result = client.getMsgFromAndroid("这是网页给的参数");       alert(result);    }    function showAndroidDialog(){        client.showMsgFromAndroid("网页要求安卓弹窗");    } </script> </head> <body> <font size='5'>测试js使用</font><br> <button onclick="javascript:showAndroidDialog()"><font size='5'>让android弹窗</font></button><br> <button onclick="javascript:showMsgInAndroid()"><font size='5'>调用Android方法获得字符串</font></button><br> </body> </html>


为了区分对话框是App来源的弹窗还是Web来源的弹窗,这里重写了WebChromeClient的onJsAlert方法,通过setTitle方法区分本次弹窗的来源途径。重写后的方法代码如下所示:

        public boolean onJsAlert(WebView view, String url, String message, final JsResult result) {             String title = mTitle;             if (title==null || title.length()<=0) {                 title = "来自网页的对话框";             }             AlertDialog.Builder builder = new AlertDialog.Builder(WebScriptActivity.this)                     .setTitle(title).setMessage(message)                     .setPositiveButton("确定",                             new DialogInterface.OnClickListener() {                                 @Override                                 public void onClick(DialogInterface dialog, int which) {                                     result.confirm();                                 }                             });             //setCancelable要设置为false,点击对话框外部时不让关闭对话框             //不然JsResult的confirm方法没有得到执行,网页上的其它控件就不可使用             builder.setCancelable(false).create().show();             return true;         }


另外还需注意WebView与JavaScript相互调用的几个要点:
1. WebView要调用setWebChromeClient方法设置JS的解释客户端,从而避免JS中alert方法不弹窗的问题,因为JS页面的渲染需要WebChromeClient去实现。
2. 如果JS调用App代码时报错“Uncaught TypeError: Object [object Object] has no method”,那是因为Android4.2以上版本默认不开放JS调用本地方法的权限,得给开放JS调用的方法加上“@JavascriptInterface”注释,该注释允许JS代码访问APP的指定方法。
3. evaluateJavascript是Android在4.4.2之后才引入的新方法,如果是4.4.2之前的Android版本,需要注意做兼容处理。
4. JS调用App方法,返回值中的中文是正常;但App获取JS方法,返回值的中文却是“\u”打头的字符串,所以要先将JS返回的字符串做转义处理,转义后的字符串才是App能够处理的正常汉字。
5. 如果App与JS存在嵌套调用(即A调用B,B内部又去调用A),那么Android4.4.2之后务必要保证两个调用在同一个线程中,不然运行时会报错“java.lang.Throwable: A WebView method was called on thread 'JavaBridge'. All WebView methods must be called on the same thread.”。具体的解决方法是:调用WebView对象的post方法,然后在post的Runnable任务中再去调用JS方法,例子代码如下所示:

    private final class Contact {         //网页的JS调用App的showcontacts方法,然后showcontacts内部又去调用JS的show方法         @JavascriptInterface         public void showcontacts() {             wv_local.post(new Runnable() {                 @Override                 public void run() {                     wv_local.loadUrl("javascript:show()");                 }             });         }     }

 

本文发表于2018年01月18日 12:32
(c)注:本文转载自https://my.oschina.net/ouysh1981/blog/1608923,转载目的在于传递更多信息,并不代表本网赞同其观点和对其真实性负责。如有侵权行为,请联系我们,我们会及时删除.

阅读 2005 讨论 0 喜欢 0

抢先体验

扫码体验
趣味小程序
文字表情生成器

闪念胶囊

你要过得好哇,这样我才能恨你啊,你要是过得不好,我都不知道该恨你还是拥抱你啊。

直抵黄龙府,与诸君痛饮尔。

那时陪伴我的人啊,你们如今在何方。

不出意外的话,我们再也不会见了,祝你前程似锦。

这世界真好,吃野东西也要留出这条命来看看

快捷链接
网站地图
提交友链
Copyright © 2016 - 2021 Cion.
All Rights Reserved.
京ICP备2021004668号-1