萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Flex 呼叫 JavaScript:ExternalInterface.call 與 addCallback 完整教學

核心 API

  • ExternalInterface.call(jsFunctionName, ...args):Flex 呼叫 JS 函式,可傳參、可取得回傳值。
  • ExternalInterface.addCallback(flexFunctionName, flexFunction):註冊 Flex 函式供 JS 呼叫。
  • ExternalInterface.available:檢查瀏覽器是否支援(含 Flash Player 版本)。

Flex 端代碼

import flash.external.ExternalInterface;

public function init():void {
    if (ExternalInterface.available) {
        // 1. 註冊供 JS 呼叫的 Flex 方法
        ExternalInterface.addCallback('checkExit', checkExitHandler);

        // 2. 呼叫 JS 函式(注入 onbeforeunload 處理)
        var jsCode:String = 
            "document.insertScript = function() {" +
            "  window.onbeforeunload = function() {" +
            "    var flexObj = MarineDataEdit.checkExit();" +
            "    if (flexObj != '') return flexObj;" +
            "  }" +
            "}";
        ExternalInterface.call(jsCode);
    }
}

private function checkExitHandler():String {
    return "你如果現在離開,則您的所有信息將失效!";
}

HTML/JS 端配合

<script>
// 1. 定義 Flex 物件參考(需在 object/embed 標籤 id="MarineDataEdit")
var flexApp = document.getElementById('MarineDataEdit') || 
              window['MarineDataEdit'] || 
              document['MarineDataEdit'];

// 2. 呼叫 Flex 註冊的方法
function checkExit() {
    if (flexApp && flexApp.checkExit) {
        return flexApp.checkExit();
    }
    return '';
}

// 3. 頁面卸載前確認
window.onbeforeunload = function() {
    var msg = checkExit();
    if (msg) return msg;
};
</script>

傳遞複雜資料

// Flex -> JS:傳遞 Object/Array(自動序列化為 JSON)
ExternalInterface.call('jsReceiveData', { id: 1, tags: ['a','b'] });

// JS -> Flex:接收 JSON 字串,Flex 端用 JSON.parse
ExternalInterface.addCallback('flexReceive', function(jsonStr:String):void {
    var data:Object = JSON.parse(jsonStr);
});

常見坑點與解決

問題原因解決
ExternalInterface.call 無回應Flash 尚未初始化完成在 creationComplete 或 applicationComplete 後呼叫
JS 找不到 Flex 方法object/embed 缺少 id 或 name 屬性確保 <object id="app" ...> 且 <embed name="app" ...>
IE 安全性錯誤本地檔案跨域限制部署至 HTTP 伺服器,或設定 Flash Player 信任目錄
中文亂碼編碼不一致頁面 <meta charset="utf-8">,Flex 專案編碼 UTF-8

替代方案:navigateToURL

// 簡單開啟新視窗/跳轉,無法取得回傳值
navigateToURL(new URLRequest('javascript:alert("hello")'), '_self');

僅適用單向通知,雙向通訊請用 ExternalInterface。

copyright © 萬盛學電腦網 all rights reserved