DIV CSS 佈局教程網

用 JavaScript 向 SWF 傳遞參數的注意細節
編輯:JavaScript基礎知識     

本文記錄如何用 JavaScript 把參數傳進 SWF 檔,並反向接收 SWF 送出的資料。以下內容属于 Flash 時代的技術,Adobe 已於 2020 年底停止支援 Flash Player,現代瀏覽器全面移除執行環境,因此這份整理僅供維護舊專案或理解歷史脈絡之用。

第一步:配置 SWFObject

SWFObject 2 是當年檢測使用者是否安裝 Flash 的標準方案,Adobe 自家產品(Flex 4、Flash CS5)也用它來偵測 Flash Player。使用前先下載並解壓,把 swfobject.js 放到網站的 js 目錄下(例如 https://myserver.com/js/swfobject.js)。若要啟用 ExpressInstall(引導使用者升級的功能),還需把 expressInstall.swf 放在同一個資料夾。

第二步:在 HTML 中抓取網址參數

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>

第三步:用 SWFObject 嵌入 SWF

第二段 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。

第四步:在 Flash 中接收

在舞台上放一個動態文字欄位,實例名為 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 送出參數

想讓 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 時代費勁才做到的事,現在幾行就能完成。

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