cordova-plugin-vibration - GitLite

KO | EN

gitlite — search

#hacktoberfest #llm #go #golang #machine-learning #rust #deep-learning #macos #nodejs #java #cli #awesome-list #security #mcp

cordova-plugin-vibration

(★ 129)

Apache Cordova Vibration Plugin

파일 탐색기

최종 버전 다운로드 (.zip)

- - BUG_REPORT.md
  - FEATURE_REQUEST.md
  - SUPPORT_QUESTION.md
- - android.yml
  - chrome.yml
  - ci.yml
  - ios.yml
  - lint.yml
  - release-audit.yml
- ISSUE_TEMPLATE.md
- PULL_REQUEST_TEMPLATE.md
- - Vibration.js
- - CDVVibration.h
  - CDVVibration.m
- package.json
- plugin.xml
- tests.js
- index.d.ts
- vibration.js
.asf.yaml
.eslintrc.yml
.gitignore
.npmignore
.npmrc
.rat-excludes
CONTRIBUTING.md
licence_checker.yml
LICENSE
NOTICE
package-lock.json
package.json
plugin.xml
README.md
RELEASENOTES.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/apache/cordova-plugin-vibration

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd cordova-plugin-vibration

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Node.js

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

npm install

package.json에 명시된 라이브러리들을 내려받아 설치합니다.

npm start

개발/실행 서버를 켭니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

---
title: Vibration
description: Vibrate the device.
---

# cordova-plugin-vibration

[![Android Testsuite](https://github.com/apache/cordova-plugin-vibration/actions/workflows/android.yml/badge.svg)](https://github.com/apache/cordova-plugin-vibration/actions/workflows/android.yml) [![Chrome Testsuite](https://github.com/apache/cordova-plugin-vibration/actions/workflows/chrome.yml/badge.svg)](https://github.com/apache/cordova-plugin-vibration/actions/workflows/chrome.yml) [![iOS Testsuite](https://github.com/apache/cordova-plugin-vibration/actions/workflows/ios.yml/badge.svg)](https://github.com/apache/cordova-plugin-vibration/actions/workflows/ios.yml) [![Lint Test](https://github.com/apache/cordova-plugin-vibration/actions/workflows/lint.yml/badge.svg)](https://github.com/apache/cordova-plugin-vibration/actions/workflows/lint.yml)

This plugin provides a way to vibrate the device. Its API aligns with the W3C vibration specification at http://www.w3.org/TR/vibration/

The plugin defines a global object/method `navigator.vibrate`. Although in the global scope, it is not available until after the `deviceready` event.

```javascript
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
    console.log(navigator.vibrate);
}
```

## Installation

```console
cordova plugin add cordova-plugin-vibration
```

## Supported Platforms

- iOS
- Android  
  The Android webview (API level 19 and up) supports the [W3C Vibration API](https://www.w3.org/TR/vibration/) natively, so no Android specific implementation in this plugin is necessary.

## navigator.vibrate

This function has three different functionalities based on parameters passed to it:

### Standard vibrate

Vibrates the device for a given amount of time.

```javascript
navigator.vibrate(time)
```
or
```javascript
navigator.vibrate([time])
```

- __time__: Milliseconds to vibrate the device. _(Number)_

#### Example

```javascript
// Vibrate for 3 seconds
navigator.vibrate(3000);

// Vibrate for 3 seconds
navigator.vibrate([3000]);
```

#### Quirks

##### iOS Quirks

- __time__: Ignores the specified time and vibrates for a pre-set amount of time.

```javascript
    navigator.vibrate(3000); // 3000 is ignored
    ```

##### Android Quirks

> Calls to `navigator.vibrate` will immediately return `false` if user hasn't tapped on the frame or any embedded frame yet.

See https://www.chromestatus.com/feature/5644273861001216

### Vibrate with a pattern

Vibrates the device with a given pattern

```javascript
navigator.vibrate(pattern);
```
- __pattern__: Sequence of durations (in milliseconds) for which to turn on or off the vibrator. _(Array of Numbers)_

#### Example

```javascript
// Vibrate for 1 second
// Wait for 1 second
// Vibrate for 3 seconds
// Wait for 1 second
// Vibrate for 5 seconds
navigator.vibrate([1000, 1000, 3000, 1000, 5000]);
```

#### Quirks

- Not supported on iOS

### Cancel vibration

Immediately cancels any currently running vibration.
```javascript
navigator.vibrate(0)
```
or
```javascript
navigator.vibrate([])
```
or
```javascript
navigator.vibrate([0])
```
Passing in a parameter of 0, an empty array, or an array with one element of value 0 will cancel any vibrations.

#### Quirks

- Not supported on iOS