在 Flex 開發中,難免有需要與瀏覽器互動的時刻,例如關閉視窗、彈出提示框,或與 HTML 頁面交換資料。本文說明 Flex 如何透過 ExternalInterface 類別呼叫 JavaScript,並示範一個實用的應用案例。
最直接的方式是使用 ExternalInterface.call(),它的參數就是一段字串形式的 JavaScript 代碼。透過與 JavaScript 互動,我們能改變樣式、呼叫遠端方法,也能把資料傳給 HTML 頁面處理後再回傳給 Flex。
其語法如下:
flash.external.ExternalInterface.call(function_name:String[, arg1, ...]):Object;
其中 function_name 是要呼叫的 JavaScript 函數名,後面的參數則是傳給該函數的引數。若呼叫失敗,Flex 會拋出異常;而 ExternalInterface 已封裝了對瀏覽器支援的檢查,可用 available 屬性查詢。
以下示範如何動態注入一段 JavaScript,監聽 onbeforeunload,在使用者即將離開時跳出確認提示;同時用 addCallback 讓 JavaScript 能回頭呼叫 Flex 端的方法取得提示文字。
ExternalInterface.call(FUNCTION_USEREXIT);
ExternalInterface.addCallback("checkExit", checkExit);
private static var FUNCTION_USEREXIT:String = "document.insertScript=function()" +
"{" + "window.onbeforeunload=function()" + "{" +
"var flexObj=MarineDataEdit.checkExit();" +
"if(flexObj!="")" + "{" + "return flexObj;" + "}else{" + "return;" + "}" +
"}" + "}";
public function checkExit():String {
var userExitStr:String = "你現在離開的話,所有填寫的資料將會失效!";
return userExitStr;
}
這裡有兩個重點:一是 ExternalInterface.call() 負責「Flex 呼叫 JavaScript」,二是 addCallback 函數負責「讓 JavaScript 回呼 Flex」,兩者搭配即可完成雙向溝通。藉由這個機制,Flex 應用能與其所在的 HTML 環境緊密整合,打造更貼近原生瀏覽器體驗的互動效果。