导航器:vibrate() 方法

**vibrate()** 是 Navigator 接口的方法,它会使设备的振动硬件脉动(如果设备有这样的硬件)。如果设备不支持振动,此方法不会有任何效果。如果在调用此方法时已经存在振动模式,则之前的模式将被停止,新模式将开始。

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

语法

js
vibrate(pattern)

参数

pattern

提供振动和暂停间隔的模式。每个值表示振动或暂停的毫秒数,交替进行。您可以提供一个值(振动一次,持续指定毫秒数)或一个值数组,以交替振动、暂停,然后再振动。有关详细信息,请参阅 振动 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.

规范

规范
振动 API(第二版)
# dom-navigator-vibrate

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅