網站裡嵌了 Flash/Flex 做的圖表或查詢介面,外層頁面需要把參數傳進去、也要接收它回報的結果——這件事靠 ExternalInterface 完成。以下用一個 SWF 接收起訖點座標的例子說明整個串接過程。
有三個檔案:test.swf(Flex 編譯產物)、test.html(Flex 自動產生的包裹頁),以及自己的 test.jsp。JSP 透過名為 rightframe 的 iframe 引入 test.html,也就間接引入了 SWF。
Flex 的初始化階段,用 addCallback 把 ActionScript 函式登記成可被 JS 呼叫的名稱:
// 第一個參數是 JS 端要用的名稱,第二個是 AS 端的實作
ExternalInterface.addCallback("showParams", showParams);
public function showParams(start:String, end:String):void {
Alert.show(start);
Alert.show(end);
}
因為 SWF 在 iframe 裡,必須先跨過 frame 邊界:
function initSWF() {
// rightframe 是 iframe 的 name,ReverseQuery 是 object 標籤的 id
var obj = window.frames["rightframe"].ReverseQuery;
var start = "<%=startPoint%>";
var end = "<%=endPoint%>";
obj.showParams(start, end);
}
反方向用 ExternalInterface.call()。這裡有個限制要注意:Flex 只能呼叫「承載 SWF 的那個頁面」裡的 JS 函式。由於 SWF 是被 test.html 載入的,Flex 直接呼叫到的是 test.html 的函式,要再一層層往上轉發:
// Flex 端
ExternalInterface.call("initSWF");
// test.html 端(轉發給父頁面的 JSP)
function initSWF() {
parent.initSWF();
}
如果頁面 onload 就急著呼叫 SWF 的方法,很可能 SWF 還沒初始化完成,此時 obj 是 undefined,直接丟出找不到物件的錯誤。監聽 SWF 的載入完成事件既麻煩又不可靠,比較乾脆的做法是反過來——讓 Flex 在初始化完成後主動呼叫 JS:
// Flex 端,必須放在 addCallback 之後
ExternalInterface.addCallback("showParams", showParams);
ExternalInterface.call("initSWF");
這樣一來,JS 端的 initSWF 只在 Flex 確實準備好之後才被觸發,時序問題自然消失。這個「由被呼叫方通知準備完成」的模式,比在呼叫方猜時機要穩健得多。
一、ExternalInterface.available 在部分舊版播放器為 false,正式環境應該先檢查再呼叫。二、跨 frame 呼叫需要同 origin,否則會被瀏覽器阻擋。三、傳給 SWF 的字串要當成不可信輸入處理,ActionScript 端應做型別與範圍檢查。
Flash Player 已於 2020 年底停止支援,主流瀏覽器全面移除。這份內容對維護既有系統仍有參考價值,但新專案請改用 HTML5 Canvas、SVG 或 WebGL 相關方案(ECharts、Chart.js、D3.js 等)來取代原本由 Flex 承擔的圖表與互動介面。