Skip to content

juliomrqz/nativescript-vibrate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Codacy Badge Travis version License FOSSA Status

NativeScript Vibrate apple android

A vibrate NativeScript plugin for Android and iOS

Read this in other languages: English, EspaΓ±ol

Installation

Run the following command from the root of your project:

$ ns plugin add nativescript-vibrate

This command automatically installs the necessary files, as well as stores nativescript-vibrate as a dependency in your project's package.json file.

Permissions

Android

To use the vibrate functionality on Android your app must request permission access the vibrator. The plugin automatically adds the required permission shown below for you so you don't need to worry about editing the Android Manifest.

<uses-permission android:name="android.permission.VIBRATE" />

Example of use

To use the vibrate module you must first require() it:

var Vibrate = require("nativescript-vibrate").Vibrate;
var vibrator = new Vibrate();

If you use Typescript, you can import it this way:

import { Vibrate } from 'nativescript-vibrate';
let vibrator = new Vibrate();

After you have a reference to the module you can then call its vibrate(milliseconds) method.

// my-page.js
vibrator.vibrate(2000);

If you prefer to use a vibration pattern, you could try:

// my-page.js
vibrator.vibrate([1000, 300, 500, 2000]);

Notes

iOS

There is no API to vibrate for a specific amount of time or vibration pattern, so it will vibrate for the default period of time no matter what.

API

Only one method is available: vibrate(). Below are all the supported properties you can play around.

Property Default Description Android iOS
time 300 The number of milliseconds to vibrate. It can be also an array of longs of times for which to turn the vibrator on or off. βœ”οΈŽ ✘
repeat -1 The index into pattern at which to repeat, or -1 if you don't want to repeat. βœ”οΈŽ ✘

Documentation & Support

Professional Support

This project is sponsored by me, a Full Stack Developer. If you require assistance on your project(s), please contact me at https://marquez.co.

Contributing

Please make sure to read the Contributing Guide before making a pull request.

Code of Conduct

Everyone participating in this project is expected to agree to abide by the Code of Conduct.

License

Code released under the MIT License.

FOSSA Status