diff --git a/files/ja/web/api/navigator/vibrate/index.md b/files/ja/web/api/navigator/vibrate/index.md index eb9954e152c4b9..b81777401d9472 100644 --- a/files/ja/web/api/navigator/vibrate/index.md +++ b/files/ja/web/api/navigator/vibrate/index.md @@ -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' とバイブレーションします。 ``` @@ -39,4 +52,4 @@ window.navigator.vibrate([ ## 関連情報 -- [Vibration API](/ja/docs/WebAPI/Vibration) +- [バイブレーション API](/ja/docs/Web/API/Vibration_API)