Navigator.vibrate()

La méthode Navigator.vibrate() active le module matériel de vibration de l'appareil, si ce dernier est présent. Si l'appareil ne supporte pas les vibrations, cette méthode n'a aucun effet. Si une série de vibration est déjà en cours, la précédente série est stopée et la nouvelle série est lancée.

Si la méthode ne peut pas vibrer en raison d'arguments invalides, elle retournera false, sinon elle retournera true. Si la série contient de trop longue vibration, elle sera tronqué; la longueur maximale dépend de l'implémentation.

Syntaxe

var successBool = window.navigator.vibrate(motif);
motif
Fournit un motif de vibration et d'intervalle de pause. Chaque valeur indique un nombre de milisecondes de vibration ou de pause, en alternance. Vous pouvez fournir une valeur (pour vibrer une fois) ou un tableau de valeur (vibration, pause, vibration ...). Voir l'API Vibration pour plus de détails.

Passer la valeur 0, un tableau vide, ou un tableau de zéro arrêtera toutes les vibrations.

Exemple

window.navigator.vibrate(200); // vibre pendant 200ms
window.navigator.vibrate([100,30,100,30,100,30,200,30,200,30,200,30,100,30,100,30,100]); // Vibre 'SOS' en Morse.

Spécifications

Specification Status Comment
Vibration API Recommendation

Linked to spec is the latest editor's draft; W3C version is a REC.

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi