Navigator:vibrate() 方法

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Navigator 接口的 vibrate() 方法会使得设备上的振动硬件发出振动(如果存在此类硬件)。如果设备不支持振动,则此方法无效。如果调用此方法时已经处于振动模式,则会停止前一个模式,并开始新的模式。

如果该方法由于参数无效而无法振动,它将返回 false,否则返回 true。如果振动模式导致振动时间太长,则振动模式会被截断:最大长度取决于浏览器实现。

语法

js
vibrate(pattern)

参数

pattern

提供振动和暂停间隔的模式。每个值表示交替振动或暂停的毫秒数。你可以提供单个值(在那么多毫秒内振动一次)或一组值来交替振动、暂停,然后再次振动。详情请参阅振动 API

传递一个 0、一个空数组或一个元素全部为零的数组将取消任何当前正在进行的振动模式。

返回值

一个布尔值。

安全

需要粘性用户激活。用户必须与页面或 UI 元素进行交互才能使此特性发挥作用。

示例

js
navigator.vibrate(200); // 振动 200ms
navigator.vibrate([
  100, 30, 100, 30, 100, 30, 200, 30, 200, 30, 200, 30, 100, 30, 100, 30, 100,
]); // 用摩斯密码振动“SOS”

规范

Specification
Vibration API (Second Edition)
# dom-navigator-vibrate

浏览器兼容性

BCD tables only load in the browser

参见