Navigator: vibrate() 方法

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

vibrate()Navigator 介面的一個方法,用於觸發裝置的振動硬體,前提是裝置存在此硬體。如果裝置不支援振動,則此方法無效。如果呼叫此方法時已有振動模式正在進行,則會停止之前的模式並開始新的模式。

如果由於引數無效而無法振動,該方法將返回 false,否則返回 true。如果振動模式過長,則會被截斷:最大長度取決於具體實現。

某些裝置在處於靜音模式或勿擾(DND)模式時可能不會振動。要確保振動正常工作,請確保已關閉這些模式,並在系統設定中啟用了振動。

語法

js
vibrate(pattern)

引數

pattern

提供振動和暫停間隔的模式。每個值表示交替振動或暫停的毫秒數。您可以提供單個值(以該毫秒數振動一次)或一個值陣列,以交替振動、暫停、再振動。有關詳細資訊,請參閱 Vibration API

傳遞 0、空陣列或包含全零的陣列將取消任何當前正在進行的振動模式。

返回值

布林值。

安全

需要 粘性使用者啟用。使用者必須與頁面或 UI 元素進行互動,此功能才能正常工作。

示例

js
navigator.vibrate(200); // vibrate for 200ms
navigator.vibrate([
  100, 30, 100, 30, 100, 30, 200, 30, 200, 30, 200, 30, 100, 30, 100, 30, 100,
]); // Vibrate 'SOS' in Morse.

規範

規範
Vibration API
# dom-navigator-vibrate

瀏覽器相容性

另見