diff options
author | Yeji Choi <61399588+yechoi42@users.noreply.github.com> | 2021-05-27 12:05:36 +0900 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-05-27 12:05:36 +0900 |
commit | 61a2d8571d1160c43201b2b51360de6977795c94 (patch) | |
tree | 76a350a130eb5576c0c931e27835b6ce07c13f21 /files | |
parent | 217f4d887069de4fe4426b4778a49f85f7986360 (diff) | |
download | translated-content-61a2d8571d1160c43201b2b51360de6977795c94.tar.gz translated-content-61a2d8571d1160c43201b2b51360de6977795c94.tar.bz2 translated-content-61a2d8571d1160c43201b2b51360de6977795c94.zip |
update proximity_events ko-doc (#971)
* Add {{Deprecated_Header}}, Delete compat-table and some translation
* [FIX] conflicts
Co-authored-by: yechoi <yechoi@yechoiui-MacBookAir.local>
Diffstat (limited to 'files')
-rw-r--r-- | files/ko/web/api/proximity_events/index.html | 87 |
1 files changed, 41 insertions, 46 deletions
diff --git a/files/ko/web/api/proximity_events/index.html b/files/ko/web/api/proximity_events/index.html index b618054ce8..c0a58ec4c6 100644 --- a/files/ko/web/api/proximity_events/index.html +++ b/files/ko/web/api/proximity_events/index.html @@ -1,56 +1,51 @@ --- -title: Proximity +title: Proximity Events slug: Web/API/Proximity_Events translation_of: Web/API/Proximity_Events original_slug: WebAPI/Proximity +tags: + - API + - Experimental + - Proximity Events + - Reference + - Deprecated --- -<p>{{ SeeCompatTable }}</p> -<h2 id="Summary">Summary</h2> -<p>근접 이벤트는 사용자가 디바이스에 가까이 갔을때를 알 수 있는 간단한 벙법이다.</p> -<p>예를 들어, 사용자가 전화가 걸려왔을 때 디바이스에 귀를 가까이 하면, 근접 이벤트들은 스마트폰의 화면이 꺼지게 하여 이러한 변화에 대응할 수 있게 해준다.</p> -<div class="note"> - <p><strong>Note:</strong> 당연히 이 API는 근접 센서를 가진 장치를 필요로 하며, 이 근접 센서는 대게 모바일 다비이스들에서만 이용 가능하다. 근접 센서가 없는 장치들에서는 근접 이벤트들을 지원할 수는 있을 지 몰라도 해당 이벤트들은 절대 발생하지 않을 것이다.</p> +<div>{{DefaultAPISidebar("Proximity Events")}}{{Deprecated_Header}}</div> +<div class="notecard warning"> + <h4>Warning</h4> + <p>The Proximity Events APIs are not supported by any current major browser, and should not be used. This page is provided for historical interest.</p> </div> -<h2 id="Proximity_Events">Proximity Events</h2> -<p>다비이스 근접 센서가 장치와 대상 사이의 변화를 감지했을 때, 센서는 그 변화를 브라우저에게 알린다. 브라우저는 그 알림을 받으면 그 변화에 대해 {{domxref("DeviceProximityEvent")}} 이벤트를 발생시킨다. 그리고 더 대략적인 변화(more rough change)를 알리기 위해 {{domxref("UserProximityEvent")}} 이벤트를 발생시킨다.</p> -<p>window object 레벨에서 {{domxref("EventTarget.addEventListener","addEventListener")}} 메소드 ({{event("deviceproximity")}} 또는 {{event("userproximity")}} 이벤트명) 를 이용하여 근접 이벤트를 전달받을 수 있다. 또한 {{domxref("window.ondeviceproximity")}} 또는 {{domxref("window.onuserproximity")}} 프로퍼티에 이벤트 핸들러를 붙이는 방법으로도 이벤트를 전달받을 수 있다.</p> -<p>일단 이벤트가 전달되면, 그 이벤트 오브젝트는 다음과 같은 여러 종류의 정보에 접근할 수 있게 해준다:</p> + +<p>근접 이벤트는 사용자가 디바이스에 가까이 갔을 때를 알 수 있는 간단한 방법이다. 예를 들어, 사용자에게 전화가 걸려왔을 때 디바이스에 귀를 가까이하면, 근접 이벤트들은 스마트폰의 화면이 꺼지게 하여 이러한 변화에 대응할 수 있게 해준다.</p> + +<p></p>근접 링크는 두 가지가 있다. (문서를 확인하려먼 링크를 참고하시오.):</p> <ul> - <li> {{domxref("DeviceProximityEvent")}} 이벤트는 {{domxref("DeviceProximityEvent.value","value")}} 프로퍼티를 통해 디바이스와 대상 사이의 거리에 정확히 매치되는 값을 제공한다. 또한 이 이벤트는 장치가 감지할 수 있는 가장 가까운 거리, 가장 먼거리에 대한 정보를 {{domxref("DeviceProximityEvent.min","min")}} 와 {{domxref("DeviceProximityEvent.max","max")}} 프로퍼티 값을 통해 제공한다.</li> - <li>{{domxref("UserProximityEvent")}} 이벤트는 거리에 대한 대략적인 추정치를 boolean 형태로 제공한다. 대상과 디바이스가 가까운면 {{domxref("UserProximityEvent.near")}} 프로퍼티 값은 true 가 되고, 대상과의 거리가 멀다면 그 값은 false가 된다.</li> + <li>{{domxref("UserProximityEvent")}}, handled by <code>window.onuserproximity</code></li> + <li>{{domxref("DeviceProximityEvent")}}, handled by <code>window.ondeviceproximity</code></li> </ul> -<h2 id="Example">Example</h2> -<pre class="brush: js">window.addEventListener('userproximity', function(event) { - if (event.near) { - // let's power off the screen - navigator.mozPower.screenEnabled = false; - } else { - // Otherwise, let's power on the screen - navigator.mozPower.screenEnabled = true; - } -});</pre> -<h2 id="Specifications" name="Specifications">Specifications</h2> + + <p>두 가지의 차이점은 {{domxref("UserProximityEvent")}} 은 유저가 "가깝다"고 여겨질 때 단순히 <code>true</code>라고 알려주는 반면에, {{domxref("DeviceProximityEvent")}}는 근처 객체의 실제 거리 추정치를 제공한다.</p> + +<div class="note"> + <p><strong>Note:</strong> 당연히 이 API는 근접 센서를 가진 장치를 필요로 하며, 이 근접 센서는 대게 모바일 다비이스들에서만 이용 가능하다. 근접 센서가 없는 장치들에서는 근접 이벤트들을 지원할 수는 있을 지 몰라도 해당 이벤트들은 절대 발생하지 않을 것이다.</p> +</div> + + +<h2 id="Specifications">Specifications</h2> + <table class="standard-table"> - <thead> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{ SpecName('Proximity Events', '', 'Proximity Events') }}</td> - <td>{{ Spec2('Proximity Events') }}</td> - <td>Initial specification</td> - </tr> - </tbody> + <thead> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{ SpecName('Proximity Events', '', 'Proximity Events') }}</td> + <td>{{ Spec2('Proximity Events') }}</td> + <td>Initial specification</td> + </tr> + </tbody> </table> - -<h2 id="See_also">See also</h2> -<ul> - <li>{{domxref("DeviceProximityEvent")}}</li> - <li>{{domxref("UserProximityEvent")}}</li> - <li>{{event("deviceproximity")}}</li> - <li>{{event("userproximity")}}</li> -</ul> |