DIV CSS 佈局教程網

JavaScript 與 Flex 雙向通訊:呼叫方法與傳遞參數的完整示例
編輯:關於JavaScript     

讓 JS 呼叫 Flex 裡的方法、同時把參數送進去,靠的是 Flash Player 提供的 ExternalInterface 這座橋。反过来,Flex 也能主動回呼 JS。這篇文章把整個環節從零串起來。

場景設定

假設手上有一支編譯好的 test.swf,配套一個自動產生的 test.html 用來掛載它。現在另有一個 test.jsp,透過名為 rightframe 的 iframe 把 test.html(也就是 swf)嵌進來。目標是:從 jsp 出發,把兩個參數傳給 Flex 並觸發它內部的顯示方法。

第一步:在 JS 側取得 swf 物件並呼叫

function initSWF() {
    // 取得 swf 對應的 object。
    // rightframe 是 iframe 的名稱,ReverseQuery 是 test.html 中 object 標籤的 id
    var obj = window.frames["rightframe"].ReverseQuery;

    // 準備要傳入的參數
    var start = "<%=startPoint%>";
    var end = "<%=endPoint%>";

    // 呼叫 Flex 中對外暴露的方法
    obj.showParams(start, end);
}

第二步:在承載頁中轉發呼叫

這裡有個關鍵限制:Flex 只能呼叫「承載 swf 的那個頁面」上的 JS 方法。由於 swf 是被 test.html 載入的,Flex 能看到的是 html 的函數,而不是外層 jsp 的。所以 html 裡需要一個轉發用的包裝:

/* Flex 只能呼叫本頁面的 JS 方法,因此由這裡往父頁面轉發 */
function initSWF() {
    parent.initSWF();
}

第三步:在 Flex 側註冊與實作

Flex 端先定義好方法:

public function showParams(start:String, end:String):void {
    Alert.show(start);
    Alert.show(end);
}

然後在初始化階段把它註冊給 JS,這一步是整座橋的關鍵:

// 前者是暴露給 JS 的方法名,後者是 Flex 內部的方法參考
ExternalInterface.addCallback("showParams", showParams);

做完這些,把 initSWF() 放進頁面的 onload 裡,理論上呼叫鏈就通了。

第四步:解決「物件找不到」的時序問題

實測會遇到一個麻煩:如果 Flex 還沒載入完成就執行 initSWF(),window.frames["rightframe"].ReverseQuery 會是 undefined,直接丟出找不到物件的錯誤。

監聽載入完成當然可行,但更省事的做法是反過來——讓 Flex 準備好之後主動呼叫 JS,這樣時序問題自然消失:

// 放在 Flex 初始化中,且必須在 addCallback 註冊之後
// 由 Flex 主動呼叫承載頁面的 initSWF 方法
ExternalInterface.call("initSWF");

於是流程變成:Flex 初始化完成 → 註冊好對外方法 → 回呼 JS 的 initSWF → JS 取得已就位的 swf 物件 → 呼叫 showParams 並帶入參數。環節全部打通,也不必再猜「到底載入完了沒」。

需要特別留意的兩點

呼叫方向決定方法位置。Flex 呼叫 JS 時,該 JS 方法只能寫在直接承載 swf 的檔案裡;如果中間隔了一層 iframe,就必須用 parent. 往上一層轉發,正如本文的 html → jsp。

跨 iframe 取物件要靠 frames 集合。jsp 端要用 window.frames["rightframe"] 定位到 iframe 的視窗,再往下取 object 的 id,兩者缺一不可。

最後提醒一下:Flash Player 早已停止支援,這套 ExternalInterface 方案今天只能視為歷史技術參考。若要在現代瀏覽器中達到同等效果,WebAssembly 或 iframe 搭配 postMessage 才是對應的替代思路。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved