顧名思義,這個 API 讓行動網頁開發者可以用 JavaScript 觸發手機的振動,並且能控制節奏與時長。
好的習慣是在使用前先確認執行環境。檢測方式很簡單:
// 標準寫法 var supportsVibrate = "vibrate" in navigator;
在 window.navigator 上,與振動相關的 API 就只有 vibrate 這一個。
navigator.vibrate() 可以接受一個數字,也可以接受一個數字陣列。傳陣列時,奇數位(索引 0、2、4…)是震動時間,偶數位(索引 1、3、5…)是暫停時間,單位為毫秒。
// 震動 1 秒 navigator.vibrate(1000); // 震動 3 秒 → 停 2 秒 → 震動 1 秒 navigator.vibrate([3000, 2000, 1000]);
想停止震動,傳入 0 或空陣列即可:
navigator.vibrate(0); navigator.vibrate([]);
要留意的是,呼叫 vibrate 不會造成持續震動。傳數字時震一次就停;傳陣列時依設定的節奏跑完一遍就停,不會自己循環。
用 setInterval 反覆觸發即可:
var vibrateInterval;
// 開始震動
function startVibrate(duration) {
navigator.vibrate(duration);
}
// 停止震動
function stopVibrate() {
if (vibrateInterval) clearInterval(vibrateInterval);
navigator.vibrate(0);
}
// 以固定的間隔持續震動(duration 為數字)
function startPeristentVibrate(duration, interval) {
vibrateInterval = setInterval(function() {
startVibrate(duration);
}, interval);
}
上面的寫法只處理了 duration 是數字的情況。若傳入的是陣列,你得先算出它的總長度,再依這個長度決定循環間隔,否則節奏會被打亂。
這個 API 顯然是為行動裝置設計的。開發手機網頁應用時,它是很好的非視覺提示工具;做 Web 遊戲或多媒體應用時更是加分——玩家在遊戲中觸發爆炸,手機同時震一下,沉浸感完全不同。它也常被用來做鍵盤輸入的觸覺回饋。
必須有使用者互動。瀏覽器基於安全與體驗考量,通常要求頁面已經接收過使用者的點擊或觸控,後續的 vibrate 呼叫才會生效;頁面剛載入就自動震動會被忽略。
桌面裝置不支援。這個 API 在電腦瀏覽器上大多無效,呼叫時不會報錯,只是什麼都不發生。所以務必先做能力偵測,不要假設它一定存在。
使用者可以關掉。部分系統設定與瀏覽器允許使用者停用震動回饋,因此它只能當作「加分效果」,絕不能作為唯一的資訊傳遞管道——視覺與文字提示仍然必須具備。
Safari 的限制。iOS 上的 Safari 長期未支援此 API,若要涵蓋 iPhone 使用者,需另外評估方案。