讓 JS 呼叫 Flex 裡的方法、同時把參數送進去,靠的是 Flash Player 提供的 ExternalInterface 這座橋。反过来,Flex 也能主動回呼 JS。這篇文章把整個環節從零串起來。
假設手上有一支編譯好的 test.swf,配套一個自動產生的 test.html 用來掛載它。現在另有一個 test.jsp,透過名為 rightframe 的 iframe 把 test.html(也就是 swf)嵌進來。目標是:從 jsp 出發,把兩個參數傳給 Flex 並觸發它內部的顯示方法。
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 端先定義好方法:
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 才是對應的替代思路。