在 Flash 仍活躍於網路的年代,如何跨瀏覽器、跨平台地穩定嵌入 Flash 內容,一直是前端開發者關注的焦點。SWFObject 正是為了解決這一問題而生的輕量級 JavaScript 庫。它的使用非常簡單——只需引入 swfobject.js,再透過幾行 JS 代碼插入到 DOM 中,就能完成 Flash 媒體資源的嵌入。
1. 靈活性極佳。你可以先寫好 HTML 的其他部分,最後再回頭添加 Flash 內容。這樣既能確保在客戶端沒有安裝 Flash 時,用戶不會一無所獲,也能針對搜索引擎做好關鍵詞優化,完全不必像以前那樣擔心客戶端的各種狀況。
2. 廣泛的瀏覽器相容性。SWFObject 相容於當前主流瀏覽器,包括 PC 上的 IE5/5.5/6、Netscape 7/8、Firefox、Mozilla、Opera,以及 Mac 上的 IE5.2、Safari、Firefox、Netscape 6/7、Mozilla、Opera 7.5+ 等,後續版本也會持續支援。
3. 完善的版本檢測。SWFObject 能檢測從 Flash Player 3 到最新版本的播放情況,並消除了 IE 中「點擊激活」的困擾。
4. 精細的版本判斷。如果需要 v.6.0 r65(即 6,0,65,0)來運行 SWF 資源,可以這樣指定:
var so = new SWFObject("movie.swf", "mymovie", "200", "100", "6.0.65", "#336699");
5. 可手動忽略版本檢測。在特定環境下若不希望 SWFObject 檢測版本,只需在 URL 中傳入一個參數即可。用於忽略檢測的變數名為 "detectflash":
<a href="mypage.html?detectflash=false">Bypass link</a>
<script type="text/javascript" src="swfobject.js"></script>
<div id="flashcontent">
This text is replaced by the Flash movie.
</div>
<script type="text/javascript">
var so = new SWFObject("movie.swf", "mymovie", "200", "100", "7", "#336699");
so.write("flashcontent");
</script>
詳細說明:
(1) <div id="flashcontent">[...]</div>:為 SWF 資源預留一個 HTML 節點。這個節點內的所有內容都會在客戶端被 Flash 資源替換;當客戶端沒有安裝 Flash 播放器時,這些內容會顯示出來。這一特色在 SEO 與用戶體驗方面都極有必要。
(2) var so = new SWFObject(swf, id, width, height, version, background-color [, quality, xiRedirectUrl, redirectUrl, detectKey]):建立一個新的 SWFObject 實例,並傳入以下參數:
此外還有以下可選參數:
(3) so.write("flashcontent"):將 Flash 資源應用到 DOM 中並在瀏覽器顯示出來。
<script type="text/javascript">
var so = new SWFObject("movie.swf", "mymovie", "200", "100%", "7", "#336699");
so.addParam("quality", "low");
so.addParam("wmode", "transparent");
so.addParam("salign", "t");
so.write("flashcontent");
</script>
用 Flashvars 是在預加載 Flash 時傳入數據的最佳做法,語法類似 GET 變數串。SWFObject 讓這項工作變得更加明確:
<script type="text/javascript">
var so = new SWFObject("movie.swf", "mymovie", "200", "100", "7", "#336699");
so.addVariable("variable1", "value1");
so.addVariable("variable2", "value2");
so.addVariable("variable3", "value3");
so.write("flashcontent");
</script>
這些變數會保存在 root 這個 MovieClip 物件中。此外,SWFObject 還能直接從 URL 中接受參數傳入 Flash。例如對於 https://www.example.com/page.html?variable1=value1&variable2=value2,可用 getQueryParamValue() 方法輕鬆獲取:
<script type="text/javascript">
var so = new SWFObject("movie.swf", "mymovie", "200", "100", "7", "#336699");
so.addVariable("variable1", getQueryParamValue("variable1"));
so.addVariable("variable2", getQueryParamValue("variable2"));
so.write("flashcontent");
</script>
SWFObject 全面支援 Adobe Flash 播放器的自動升級功能(自 6.0.65 起支援在 SWF 內部自動升級),這樣用戶完全無需離開網頁就能完成播放器升級。首先上傳官方的 expressinstall.swf 到伺服器,然後使用 useExpressInstall 方法指定其地址即可:
<script type="text/javascript">
var so = new SWFObject("movie.swf", "mymovie", "200", "100", "8", "#336699");
so.useExpressInstall('expressinstall.swf');
so.write("flashcontent");
</script>
如果希望用戶在完成 ExpressInstall 後重定向到其他地址,可以採用 xiRedirectUrl 屬性來自動完成這一步驟:
<script type="text/javascript">
var so = new SWFObject("movie.swf", "mymovie", "200", "100", "8", "#336699");
so.useExpressInstall('expressinstall.swf');
so.setAttribute('xiRedirectUrl', 'https://www.example.com/upgradefinished.html'); // 必須是資源的絕對 URL
so.write("flashcontent");
</script>
總的來說,SWFObject 以簡潔的 API 封裝了 Flash 嵌入過程中繁瑣的跨瀏覽器處理、版本檢測與自動升級邏輯,讓開發者能夠專注於內容本身,是那個 Flash 時代不可或缺的一大利器。