本文記錄如何用 JavaScript 把參數傳進 SWF 檔,並反向接收 SWF 送出的資料。以下內容属于 Flash 時代的技術,Adobe 已於 2020 年底停止支援 Flash Player,現代瀏覽器全面移除執行環境,因此這份整理僅供維護舊專案或理解歷史脈絡之用。
SWFObject 2 是當年檢測使用者是否安裝 Flash 的標準方案,Adobe 自家產品(Flex 4、Flash CS5)也用它來偵測 Flash Player。使用前先下載並解壓,把 swfobject.js 放到網站的 js 目錄下(例如 https://myserver.com/js/swfobject.js)。若要啟用 ExpressInstall(引導使用者升級的功能),還需把 expressInstall.swf 放在同一個資料夾。
HTML 檔需要兩段 JavaScript。第一段負責從網址中取出參數,是 Matt White 寫的,簡單但有效:
<script type="text/javascript">
function getURLParam(strParamName) {
var strReturn = "";
var strHref = window.location.href;
if (strHref.indexOf("?") > -1) {
var strQueryString = strHref.substr(strHref.indexOf("?"));
var aQueryString = strQueryString.split("&");
for (var iParam = 0; iParam < aQueryString.length; iParam++) {
if (aQueryString[iParam].indexOf(strParamName.toLowerCase() + "=") > -1) {
var aParam = aQueryString[iParam].split("=");
strReturn = aParam[1];
break;
}
}
}
return unescape(strReturn);
}
</script>
這段放在 HTML 的 HEAD 中,同時要引入 SWFObject:
<script type="text/javascript" src="/js/swfobject.js"></script>
第二段 JS 負責替換頁面中的佔位內容。先準備一個 DIV,內容是給未安裝 Flash Player 的使用者看的提示:
<div id="flashcontent"> <strong>This content requires Flash Player 9 (or a more recent version). <noscript>Make sure JavaScript is turned on.</noscript> You need to <a href="https://www.adobe.com/shockwave/download/index.cgi?p1_prod_version=shockwaveflash" target="_blank">upgrade your Flash Player</a></strong> </div>
DIV 裡可以放任何內容,因為嵌入成功後這些都會被 SWF 取代。接著是替換的 JS:
<script type="text/javascript">
var flashvars = { test: getURLParam("test") };
var params = {};
var attributes = {};
swfobject.embedSWF(
"/articlefiles/jsvars/jsvars.swf", "flashcontent",
"550", "400", "9.0.0", "",
flashvars, params, attributes
);
</script>
關鍵在第二行:呼叫前面寫好的 getURLParam,傳入我們想從網址擷取的參數名,結果放進 flashvars 物件交給 SWF。
在舞台上放一個動態文字欄位,實例名為 mytextField,然後用 try/catch 取出傳入的參數:
try {
var key: String;
var val: String;
var flashvars: Object = LoaderInfo(this.root.loaderInfo).parameters;
for (key in flashvars) {
val = String(flashvars[key]);
mytextField.text = key + ": " + val;
}
} catch (error: Error) {
// 發生錯誤時的處理
}
把 fla 與 HTML 一起上傳。執行後若看到「升級 Flash Player」字樣,代表 SWF 沒被載入,請確認 swfobject.js 的路徑與 SWF 路徑都正確。正常情況下,網址加上 ?test=something 之後,文字欄位會顯示 test: something。
想讓 SWF 回傳資料給頁面,可以改寫網址並重新載入。這裡有個小技巧:用 ExternalInterface.call 取得插入 SWF 的那份 HTML 的網址,突破 Flash 只知道自身路徑的限制。
function sendVariables(e: MouseEvent): void {
// 取得 HTML 文件的網址
var htmlUrl: String = ExternalInterface.call("window.location.href.toString");
// 以問號切開,丟掉既有參數
var splitUrl: Array = htmlUrl.split("?");
var trimmedUrl: String = splitUrl[0];
// 取得要送出的參數
var parameters: String = variablesToSend.text;
var requester: URLRequest = new URLRequest(trimmedUrl + "?" + parameters);
navigateToURL(requester, '_self');
}
ExternalInterface 在 SWFObject 預設是開啟的,也可以手動關閉。要注意的是,這段程式無法在 Flash 開發環境中測試,因為 FlashVars 與 ExternalInterface 都需要 SWF 被嵌入瀏覽器後才有效,必須上傳到伺服器上驗證。最後別忘了綁定事件:
sendButton.addEventListener(MouseEvent.CLICK, sendVariables);
把上面的技巧組合起來,可以做出「highlight 當前頁籤」的選單。先停止時間軸並為五個按鈕掛上同一個事件:
stop(); item1.addEventListener(MouseEvent.CLICK, gotoURL); item2.addEventListener(MouseEvent.CLICK, gotoURL); item3.addEventListener(MouseEvent.CLICK, gotoURL); item4.addEventListener(MouseEvent.CLICK, gotoURL); item5.addEventListener(MouseEvent.CLICK, gotoURL);
然後抓取網址中的 item 參數,用它的值決定要跳到哪一幀:
try {
var key: String;
var val: String;
var flashvars: Object = LoaderInfo(this.root.loaderInfo).parameters;
for (key in flashvars) {
val = String(flashvars[key]);
if (key == "item") {
if (val.substr(0, 4) == "item") {
var frameToGoTo: Number = Number(val.substr(4, 1));
gotoAndStop(frameToGoTo + 1);
}
}
}
} catch (error: Error) {
// 錯誤處理
}
點擊時則把被點的按鈕名稱寫回網址:
function gotoURL(e: MouseEvent): void {
var htmlUrl: String = ExternalInterface.call("window.location.href.toString");
var splitUrl: Array = htmlUrl.split("?");
var trimmedUrl: String = splitUrl[0];
var parameters: String = "item=" + e.currentTarget.name;
var requester: URLRequest = new URLRequest(trimmedUrl + "?" + parameters);
navigateToURL(requester, '_self');
}
這裡的事件機制值得一看:用 addEventListener 監聽點擊,事件物件會帶著被點擊元素的參考,因此 e.currentTarget.name 就能取得按鈕名稱。
如果今天要做「網頁與嵌入內容互相傳遞參數」,Flash 的位置已由 HTML5 影音、canvas、iframe 或 Web Component 取代。跨文件通訊用 postMessage,讀取網址參數用 URLSearchParams:
var params = new URLSearchParams(location.search);
var test = params.get('test');
比本篇的 getURLParam 簡短許多,也自動處理了編碼問題。至于 iframe 之間的溝通,則是:
// 父頁面傳給 iframe
iframe.contentWindow.postMessage({ type: 'update', value: 42 }, '*');
// iframe 中接收
window.addEventListener('message', function (e) {
if (e.data.type === 'update') { /* 處理 */ }
});
掌握這些標準 API,原本 Flash 時代費勁才做到的事,現在幾行就能完成。