DIV CSS 佈局教程網

JS 與 Flex 雙向呼叫:ExternalInterface 的橋梁怎麼搭
編輯:JavaScript綜合知識     

網站裡嵌了 Flash/Flex 做的圖表或查詢介面,外層頁面需要把參數傳進去、也要接收它回報的結果——這件事靠 ExternalInterface 完成。以下用一個 SWF 接收起訖點座標的例子說明整個串接過程。

場景設定

有三個檔案:test.swf(Flex 編譯產物)、test.html(Flex 自動產生的包裹頁),以及自己的 test.jsp。JSP 透過名為 rightframe 的 iframe 引入 test.html,也就間接引入了 SWF。

步驟一:在 Flex 端註冊要暴露的方法

Flex 的初始化階段,用 addCallback 把 ActionScript 函式登記成可被 JS 呼叫的名稱:

// 第一個參數是 JS 端要用的名稱,第二個是 AS 端的實作
ExternalInterface.addCallback("showParams", showParams);

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

步驟二:在 JS 端取得 SWF 物件並呼叫

因為 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);
}

步驟三:Flex 反向呼叫 JS

反方向用 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 承擔的圖表與互動介面。

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