Skip to content

Commit

Permalink
2024/04/12 時点の英語版に基づき更新
Browse files Browse the repository at this point in the history
  • Loading branch information
mfuji09 committed Aug 30, 2024
1 parent 15e9895 commit 4b262ae
Showing 1 changed file with 22 additions and 9 deletions.
31 changes: 22 additions & 9 deletions files/ja/web/api/navigator/vibrate/index.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,43 @@
---
title: Navigator.vibrate()
title: "Navigator: vibrate() メソッド"
short-title: vibrate()
slug: Web/API/Navigator/vibrate
l10n:
sourceCommit: 77915a2ad318fb78b1d02a35d6b1de61ea1b1f5f
---

{{APIRef("Vibration API")}}

**`Navigator.vibrate()`** メソッドは、端末のバイブレーションハードウェアがあればパルスを送ります。端末がバイブレーションに対応していない場合は、このメソッドは効果はありません。このメソッドが呼び出されたときに、すでにバイブレーションパターンが進行中であった場合は、前のパターンが停止され、代わりに新しいパターンが始まります。
**`vibrate()`** は {{domxref("Navigator")}} インターフェイスのメソッドで、端末のバイブレーションハードウェアがあればパルスを送ります。端末がバイブレーションに対応していない場合は、このメソッドは効果はありません。このメソッドが呼び出されたときに、すでにバイブレーションパターンが進行中であった場合は、前のパターンが停止され、代わりに新しいパターンが始まります。

引数が無効であるためこのメソッドがバイブレーションを実行できなかった場合は `false` を返し、それ以外の場合は `true` を返します。パターンによってとても長いバイブレーションが指定された場合は、短縮されます。最大長は実装に依存します。
このメソッドが、引数が無効であるためにバイブレーションを実行できなかった場合は `false` を返し、それ以外の場合は `true` を返します。パターンによってとても長いバイブレーションが指定された場合は、短縮されます。最大長は実装に依存します。

## 構文

```js-nolint
vibrate(pattern)
```
var successBool = window.navigator.vibrate(pattern);
```

### 引数

- `pattern`
- : バイブレーションと停止の間隔のパターンを提供します。それぞれの値はミリ秒単位の数値でバイブレーションと停止の長さを交互に表します。単一の値 (そのミリ秒だけ一度バイブレーションを行う) か、値の配列でバイブレーション、停止、再度バイブレーションと交互の値の配列で指定することができます。詳しくは [Vibration API](/ja/docs/WebAPI/Vibration) を参照してください。
- : バイブレーションと停止の間隔のパターンを提供します。それぞれの値はミリ秒単位の数値でバイブレーションと停止の長さを交互に表します。単一の値 (そのミリ秒だけ一度バイブレーションを行う) か、値の配列でバイブレーション、停止、再度バイブレーションと交互の値の配列で指定することができます。詳しくは[バイブレーション API](/ja/docs/Web/API/Vibration_API) を参照してください。

`0` の値、空の配列、すべての値がゼロである配列を渡すと、現在進行中のバイブレーションパターンをすべて中止します。

### 返値

論理値です。

## セキュリティ

[ユーザーによる粘着的な有効化](/ja/docs/Web/Security/User_activation)が必要です。ユーザーがページまたはUIの要素を操作しなければ、この機能は動作しません。

##

```js
window.navigator.vibrate(200); // vibrate for 200ms
window.navigator.vibrate([
navigator.vibrate(200); // 200ms のバイブレーション
navigator.vibrate([
100, 30, 100, 30, 100, 30, 200, 30, 200, 30, 200, 30, 100, 30, 100, 30, 100,
]); // モールス信号で 'SOS' とバイブレーションします。
```
Expand All @@ -39,4 +52,4 @@ window.navigator.vibrate([

## 関連情報

- [Vibration API](/ja/docs/WebAPI/Vibration)
- [バイブレーション API](/ja/docs/Web/API/Vibration_API)

0 comments on commit 4b262ae

Please sign in to comment.