jquery.zSlide.js 是我近期實作的一個 jQuery 外掛,借助 CSS3 與 HTML5 的新特性,在瀏覽器中做出類似 PowerPoint 的幻燈片播放效果。

不論在內部會議或技術研討會,分享時最常用的大概就是 PowerPoint。但 PowerPoint 天生缺乏「自由」與「分享」的精神——它無法線上共享。想複習某場技術會議的內容,往往得找資源、下載、解壓、整理,遇到檔案格式有問題還要再折騰一輪。
此時不免感慨:要是能直接在瀏覽器裡檢視該有多好。
其實已有專門的網站在做這件事,例如国内的豆丁、百度文庫,國外的 Slideshare。但考量產品相容性,這些平台的簡報媒介都是 Flash——不是不行,就是有點多一層隔閡的感覺。
如果能用 HTML + JS 實現類似 PowerPoint 的演示頁面,既方便資源共享與技術傳播,又具備簡潔高效的特性,這就是 zSlide 誕生的意義。
製作 zSlide 簡報頁面雖然簡單,仍需具備一定的 CSS 與 HTML 基礎,因此主要使用對象是 web 開發者,尤其是前端工程師。
demo:可點此處體驗 zSlide 的簡報效果。
下載:可點此處取得範例的源檔打包。
外掛本身依賴的資源:
完全沒有使用任何圖片素材。
兩種換頁方式:一是快捷鍵 PageUp / PageDown 分別往前後翻;二是右下角工具列的按鈕,包含回到首頁、前進、後退與快速索引。

試圖越界時會顯示提示,例如「前面沒有了」或「已經播放結束」。

另外內建滑鼠自動隱藏:游標在頁面主體區靜止超過 3 秒就會消失,移動時重新出現,體驗上更接近影片播放器的感受。
由於使用了不少 CSS3、HTML5 以及 ES5 的特性,支援範圍為 IE9+、近版的 Firefox、Opera 與 Chrome。綜合來看,Chrome 下的互動效果最佳。本外掛的部分做法借鑑了 jQuery Mobile。
頂部:進度條。最右側的數字是總頁數,會變動的數字是目前頁碼。

主體:內容區。
底部:左側為版權資訊(請保留),右側為工具列。
提示:雙擊頁面空白處可切換頂部進度條與底部工具列的顯示與隱藏。
1. 定時提醒
右下角時鐘圖示即為定時提醒。簡報通常有時間限制,例如 45 分鐘演講加 15 分鐘提問;講得太投入忘記時間就尷尬了,有個提醒機制會貼心很多。

點擊後會彈出設定視窗:

總時間為必填,須小於 720 分鐘(12 小時),到點一定會提醒;「結束前多少分鐘提醒」可輸入多個以非數字分隔的時間值,外掛會自動篩選出小於總時間的合適值。
這個功能用了 HTML5 的 localStorage 儲存設定。若你不小心關掉頁面,再次開啟時只要偵測到未過期的提醒時間,就會詢問是否沿用。

zSlide 走的是賣萌路線,所有提示都以「主人,~」開頭。以時間提醒為例,依剩餘時間不同,提示文案也會有變化:

2. 自訂背景
預設背景是深色基色 #34538b 加上徑向漸層高亮,可依喜好調整。

開啟的設定視窗中,可以指定背景色(建議用深色,例如 #123456)、線上圖片網址,或直接用 HTML5 File API 從本機選一張圖上傳預覽。
所有修改都是即時預覽,且完全自適應視窗大小;按取消則還原。

若按下確定時「記住我的選擇」處於勾選狀態,下次開啟仍會套用該背景;否則瀏覽器一關就恢復預設。

3. 使用說明
最右側的圖示,點下去會連回本文。此功能不可自訂。

工具列可自訂
完整的工具列選項如下:
$.zSlide.arrayTool = ["Home", "Time", "Background", "Prev", "Index", "Next"];
在初始化之前改動這個陣列,就能決定要顯示哪些項目。例如拿掉「回到初始頁」:
$(function() {
$.zSlide.arrayTool = ["Time", "Background", "Prev", "Index", "Next"];
$.zSlide.init();
});
CSS 部分
<link rel="stylesheet" href="css/jquery.zSlide-min.css" type="text/css" /> <link rel="stylesheet" href="css/yourSlide.css" type="text/css" />
因為幻燈片內容千差萬別,通常每份簡報都會配一個對應的 CSS 檔(即 yourSlide.css),用來處理該簡報特有的樣式。例如 demo 裡就對動態載入的圖片做了額外設定。
提示:jquery.zSlide.css 只 reset 了 body 的 margin 與微軟雅黑字型、a 標籤的顏色與點擊樣式、pre 標籤的樣式,其他標籤都沒有動過,你可以自由發揮。
JS 部分
<script src="js/jquery-min.js"></script>
<script src="js/jquery.zSlide-min.js"></script>
<script src="js/yourSlide.js"></script>
<script>
$(function() {
/* 可在初始化之前調整設定 */
$.zSlide.init();
});
</script>
與 CSS 類似,簡報中若有特殊互動需求,寫在 yourSlide.js 裡即可。例如 demo 為了效能而對圖片做的動態延時載入。
提示:zSlide 採用字面量寫法,所有參數與方法都可全域存取。但除了 arrayTool 之外,其他屬性並不建議修改。外掛內還內建了一個專為無捲動頁面設計的彈出框外掛 zDialog,後面會介紹。
HTML 部分
頭尾是固定的,請勿修改:
<div id="header" class="zsl_header" data-role="header"></div> <div id="footer" class="zsl_footer" data-role="footer"> <!-- 請保留版權資訊 --> © <a href="https://www.zhangxinxu.com/">zhangxinxu</a> </div>
主體是一份有特定格式的清單。本外掛借鑑了 jQuery Mobile 的做法,例如並未採用 HTML5 新標籤,而是用 data- 自訂屬性標示角色,而這些標示與互動行為直接相關,不可省略。
以 demo 中第一頁為例:
<div id="slide1" class="zsl_slide slide" data-role="slide">
<h1 class="zsl_title">Fade 列表測試</h1>
<div class="zsl_section">
<p class="zsl_fade fade" data-role="fade">這是 data-role 為 fade 的第 1 行元素</p>
<p class="zsl_fade fade" data-role="fade">這是 data-role 為 fade 的第 2 行元素</p>
</div>
</div>
規則說明:
data-role="slide" 的 div 中zsl_slide 用於間距美化,slide 是 webkit 核心瀏覽器切換動畫的必要條件,id 必須存在且唯一(有序編號便於辨識)data-role="fade" 以及 zsl_fade、fade 兩個 classzsl_title 與 zsl_section 的結構一般固定不變使用時真正要改的只有 <div class="zsl_section"> 裡面的內容,建議採用語意化標籤(避免使用 div 堆疊)。
事件
可以在 data-role="slide" 的元素上綁定 slideload 事件,該頁載入時就會觸發:
$("#slide3").bind("slideload", function() {
var that = $(this);
// 為了清楚看到延時載入的效果,這裡設置了一個 1 秒的定時器
// ...
});
頁面間跳轉
可用 a 標籤做自訂跳轉:
<a href="#slide3">跳跳跳</a>
點擊後會無刷新跳到 id 為 slide3 的頁面。若該 id 不存在、或對應元素不是 data-role="slide",則會跳回第一頁,這點要留意。
概述:zDialog 是專為無捲動頁面設計的彈出框外掛,UI 大量使用 CSS3 屬性,定位主要靠 CSS 完成。一次只能開啟一個彈框,關閉時內部元素會被全部 remove,因此不能直接 load 頁面上已存在的元素,否則元素會一起消失。
參數
| 參數 | 說明 | 預設 |
|---|---|---|
| url | ajax 頁面位址,或文字/HTML 字串 | "" |
| ajax | 布林值。為 true 時 url 視為請求位址 | true |
| ajaxData | ajax 附帶參數物件 | {} |
| overlay | 是否顯示半透明遮罩層 | true |
| closable | 是否顯示關閉按鈕 | false |
| title | 彈框標題,有值才顯示 | "" |
| pageContainer | 載入彈框 HTML 的容器 | $("body") |
| onShow | 彈框顯示時呼叫 | $.noop |
| onClose | 彈框完全關閉時呼叫 | $.noop |
基本用法
$.zDialog.open({
url: 'ajax.php',
title: '測試',
closable: true,
onShow: function() { alert('加載成功'); }
});
內建 API
1. $.zDialog.alert(message, callback, options);

$.zDialog.alert("主人,時間到了,喵~~");
callback 為按下確定時的回呼。
2. $.zDialog.confirm(message, sureCall, cancelCall, options);

3. $.zDialog.remind(message, options); 直接提示框,沒有關閉按鈕:
$.zDialog.remind("頁面跳轉中...");
4. $.zDialog.loading(options); 「載入中」提示框,ajax 載入時會自動呼叫。
5. $.zDialog.position(); 彈框的 JS 重新定位,用於內容寬高明顯超出最小值的情況:
$.zDialog.open({ url: 'some HTML', ajax: false }).position();
6. $.zDialog.close(); 關閉彈框,會觸發 onClose,Chrome 等瀏覽器下另有 pop 動畫。
7. $.zDialog.remove(); 直接移除元素,不觸發 onClose、也沒有動畫。
為什麼叫 zSlide?因為幻燈片的英文是 slide,而 HTML5 剛好有個 slide 元素。單叫 slide.js 容易與其他命名衝突,於是加上字首。一開始用的是 zsl(CSS class 前綴可見),也就是 zslSlide,但 sl 與 Slide 重複了,索性把 sl 去掉,就成了 zSlide。至於為何用 z,就和佐羅用劍在對手身上畫 z 一樣——因為他姓「佐」。早期我寫的外掛曾用 zxx 當字首,後來覺得自己不夠低調,就把 xx 拿掉了。
有了 zSlide,自然也就有了 zDialog。
雖然寫的時候很用心,各個細節都盡力琢磨,但水平有限,肯定還有不少問題,歡迎提出 bug 或改進建議。另外尚未做過壓力測試,目前只驗證過三頁的情況;若動輒上百頁的效能表現如何,還有待實測回饋。