Android WebView中的JavaScript代碼使用

　上一篇博文：Android WebView使用基礎已經說了一些Android中WebView的基本使用。

　　本篇文章主要介紹WebView中的JavaScript代碼的執行相關，已經JS代碼與Android代碼的互相調用。

　　（由於本人對Web開發並非很熟悉，因此若是有哪些地方說得不對，還請指正。）

 

在WebView中使用JavaScript

　　若是你想要載入的頁面中用了JavaScript，你必須爲你的WebView使能JavaScript。

　　一旦使能以後，你也能夠本身建立接口在你的應用和JavaScript代碼間進行交互。

 

前情提要：使能JavaScript

　　上一篇文章已經說過，能夠經過getSettings()得到WebSettings，而後用setJavaScriptEnabled()使能JavaScript：

WebView myWebView = (WebView) findViewById(R.id.webview);
WebSettings webSettings = myWebView.getSettings();
webSettings.setJavaScriptEnabled(true);

 

綁定JavaScript與Android代碼

　　當你爲你的Android應用中的WebView專門開發一個網頁應用時，你能夠建立你的JavaScript代碼和你的客戶端的Android代碼之間的接口。

　　好比，你能夠用JavaScript代碼調用Android代碼中的方法，來展示一個對話框之類，而不是使用alert()方法（JS中的對話框方法）。

　　在JS和Android代碼間綁定一個新的接口，須要調用 addJavascriptInterface()方法。

　　方法參數傳入一個Java對象實例和一個字符串，該字符串是一個名字（interface name，注意此接口不是一般所說的那個用來實現的接口，而是傳入的這個對象在JS中的別名），在JS代碼中用此名字調用該Java對象的方法。

　　

　　注意這個方法能夠讓JS代碼控制宿主程序，這是一個很是有力的特性，可是同時也存在一些安全問題，由於進一步JS代碼能夠經過反射訪問到注入對象的公有域。攻擊者可能會在HTML和JavaScript中包含了有威脅性的代碼。

　　因此Android 4.1，API 17，也就是JELLY_BEAN 開始，只有被JavascriptInterface 註解標識的公有方法能夠被JS代碼訪問。

　　另外，由於JS代碼和Java對象在這個WebView所私有的後臺線程交互，因此還須要注意線程安全性問題。

　　注意，與JS代碼綁定的的這個Java對象運行在另外一個線程中，與建立它的線程不是一個線程。

　　注意，這個Java對象的域是不可訪問的。

 

綁定JavaScript與Android代碼的例子

　　好比能夠定義這麼一個類：

/**
     * 自定義的Android代碼和JavaScript代碼之間的橋樑類
     * 
     * @author 1
     * 
     */
    public class WebAppInterface
    {
        Context mContext;

        /** Instantiate the interface and set the context */
        WebAppInterface(Context c)
        {
            mContext = c;
        }

        /** Show a toast from the web page */
        // 若是target 大於等於API 17，則須要加上以下註解
        // @JavascriptInterface
        public void showToast(String toast)
        {
            // Toast.makeText(mContext, toast, Toast.LENGTH_SHORT).show();
            Toast.makeText(mContext, toast, Toast.LENGTH_LONG).show();
        }
    }

 

　　而後將這個類和你的WebView中的JS代碼綁定：

WebView webView = (WebView) findViewById(R.id.webview);
webView.addJavascriptInterface(new WebAppInterface(this), "Android");

　　給這個對象起的別名叫「Android」。

　　這個就創立了一個接口名，叫「Android」，運行在WebView中的JS代碼能夠經過這個名字調用WebAppInterface類中的showToast()方法：

<input type="button" value="Say hello" onClick="showAndroidToast('Hello Android!')" />

<script type="text/javascript">
    function showAndroidToast(toast) 
    {
        Android.showToast(toast);
    }
</script>

 

特別注意：須要設置chrome handler

　　這個問題讓我納悶了很久，由於開始的時候我寫的程序，JS代碼中的按鈕會出如今WebView中，可是點擊下去後，不會彈出相應的對話框之類。

　　也就是說JS代碼調用本身也沒有執行？

　　一樣的代碼在別的地方執行能夠正常彈出啊。因此我還提問來着：http://q.cnblogs.com/q/47060/

　　後來找了半天緣由，才發現兩個問題：

　　1.網頁按鈕按下後不出現JS對話框是由於沒有設置chrome handler，須要設置以下：　

// 若是不設置這個，JS代碼中的按鈕會顯示，可是按下去卻不彈出對話框
        // Sets the chrome handler. This is an implementation of WebChromeClient
        // for use in handling JavaScript dialogs, favicons, titles, and the
        // progress. This will replace the current handler.
        myWebView.setWebChromeClient(new WebChromeClient()
        {

            @Override
            public boolean onJsAlert(WebView view, String url, String message,
                    JsResult result)
            {
                // TODO Auto-generated method stub
                return super.onJsAlert(view, url, message, result);
            }

        });

　　

　　2.調用Android代碼的那個按鈕也沒有出現Toast是由於我把別名寫錯了（大小寫沒有注意）。（這個錯誤能夠忽略，可是你們也要引覺得戒。。Orz。。。）

 

 

Android調用JavaScript代碼

 　　這個還比較簡單，須要調用的時候只須要一行代碼：　　

myWebView.loadUrl("javascript:myFunction()");

　　其中myFunction()是JS函數。

　　這裏要補充一下，若是JavaScript函數是帶參數的，那麼調用時要特別注意。

　　好比下面這個JS函數，在原來內容上加入一行：

function writeLine(string)
    {
        console.log("Write a new Line");//調試信息
        document.getElementById("content").innerHTML += string + "<br />";//在content標籤段落加入新行
    }

　　注：其中content是自定義的標籤，html中有一個段落是：

<p id="content"></p>

　　那麼在Android代碼中調用這個writeLine()函數時，須要傳入一個字符串參數，好比，想要傳入一個叫name的String：

myWebView.loadUrl("javascript:writeLine('"+name+"')");//JS代碼要是帶參數

　　還有就是要注意雙引號中的函數名必定不要寫錯。
 

程序實例

　　作了一個程序：

　　界面中包含一個TextView，旁邊一個Button，下面整個是一個WebView。

　　在WebView中載入了一個本地html文件，本地文件存放在assets文件夾中。

　　網頁中前四個按鈕調用的是JavaScript函數，顯示各類對話框。

　　SayHello按鈕調用Android代碼中的一個方法，顯示一個Toast，如圖中所示。

　　爲了證實Android也能夠調用JS代碼，最上方的Android Button按下後和「點擊這裏」那個按鈕的效果一致，都是出現JS的對話框。

　　Activity代碼：

WebJSActivity

　　HTML文件：

sample.html

　　Activity佈局文件：

activity_web_js.xml

 

 

參考資料

　　Web學習網站：

　　http://www.w3school.com.cn/

　　API Guides:  Building Web Apps in WebView

　　http://developer.android.com/guide/webapps/webview.html