From 6ef1fa4618e08426b874529619a66adbd3d1fcf0 Mon Sep 17 00:00:00 2001 From: Florian Merz Date: Thu, 11 Feb 2021 12:07:59 +0100 Subject: unslug ja: move --- files/ja/web/api/proximity_events/index.html | 84 ++++++++++++++++++++++++++++ 1 file changed, 84 insertions(+) create mode 100644 files/ja/web/api/proximity_events/index.html (limited to 'files/ja/web/api/proximity_events') diff --git a/files/ja/web/api/proximity_events/index.html b/files/ja/web/api/proximity_events/index.html new file mode 100644 index 0000000000..633d2a7cfb --- /dev/null +++ b/files/ja/web/api/proximity_events/index.html @@ -0,0 +1,84 @@ +--- +title: Proximity Events +slug: WebAPI/Proximity +tags: + - API + - Experimental + - Proximity Events + - Reference +translation_of: Web/API/Proximity_Events +--- +

{{DefaultAPISidebar("Proximity Events")}}{{ SeeCompatTable }}

+ +

proximity events は、ユーザーが端末の近くにいるときを知るのに便利な手段です。これらのイベントは近接度の変化への対応、例えばユーザーがスマートフォンを耳の近くに持ってきて電話をしているときにスクリーンを休止することを可能にします。

+ +
+

メモ: この API は端末に近接センサーを必要とすることが明らかです。近接センサーは、たいていモバイル端末のみで使用できます。センサーを搭載していない端末もイベントをサポートするかもしれませんが、イベントは発生しません。

+
+ +

Proximity Event

+ +

端末の近接センサーが端末と物体との距離の変化を検出すると、それをブラウザーに通知します。ブラウザーが通知を受けると、あらゆる変化について {{domxref("DeviceProximityEvent")}} イベントが、またよりおおざっぱな変化の場合に {{domxref("UserProximityEvent")}} イベントが発生します。

+ +

このイベントは {{domxref("EventTarget.addEventListener","addEventListener")}} メソッド (イベント名 {{event("deviceproximity")}} または {{event("userproximity")}} を使用) を使用するか、イベントハンドラーを {{domxref("window.ondeviceproximity")}} プロパティまたは {{domxref("window.onuserproximity")}} プロパティに接続することにより、window オブジェクトレベルで取得できます。

+ +

イベントを取得すると、イベントオブジェクトでさまざまな種類の情報にアクセスできます。

+ + + +

例

+ +
window.addEventListener('userproximity', function(event) {
+  if (event.near) {
+    // スクリーンの電源を切る
+    navigator.mozPower.screenEnabled = false;
+  } else {
+    // スクリーンの電源を入れる
+    navigator.mozPower.screenEnabled = true;
+  }
+});
+ +

仕様書

+ + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName('Proximity Events', '', 'Proximity Events')}}{{Spec2('Proximity Events')}}初回定義
+ +

ブラウザーの対応

+ +

DeviceProximityEvent

+ + + +

{{Compat("api.DeviceProximityEvent")}}

+ +

UserProximityEvent

+ + + +

{{Compat("api.UserProximityEvent")}}

+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf