diff options
Diffstat (limited to 'files/ko/web/api/notifications_api/index.html')
-rw-r--r-- | files/ko/web/api/notifications_api/index.html | 83 |
1 files changed, 83 insertions, 0 deletions
diff --git a/files/ko/web/api/notifications_api/index.html b/files/ko/web/api/notifications_api/index.html new file mode 100644 index 0000000000..4ab5d961dc --- /dev/null +++ b/files/ko/web/api/notifications_api/index.html @@ -0,0 +1,83 @@ +--- +title: Notifications API +slug: Web/API/Notifications_API +tags: + - 권한 + - 시스템 + - 알림 +translation_of: Web/API/Notifications_API +--- +<p>{{DefaultAPISidebar("Web Notifications")}}</p> + +<p class="summary">Notifications API 는 웹 페이지가 일반 사용자에게 시스템 알림 표시를 제어할 수 있게 해줍니다. 이러한 알람은 최상단 브라우징 컨텍스트 뷰포트의 바깥에 위치하므로 사용자가 탭을 변경하거나 다른 앱으로 이동했을때에도 표시할 수 있습니다. 이 API 는 다양한 플랫폼에 존재하는 알림 시스템과 호환되도록 디자인되었습니다.</p> + +<h2 id="개념과_사용">개념과 사용</h2> + +<p>지원되는 플랫폼에서, 시스템 알림 표시는 일반적으로 두 가지를 포함합니다. 첫째로, 사용자가 시스템 알림 표시에 대한 현재 origin 권한을 허용해야합니다. 이는 {{domxref("Notification.requestPermission()")}} 메소드를 사용해 앱이나 사이트가 초기화될 때 일반적으로 완료됩니다. 다음과 같이 요청 대화상자가 나타납니다.</p> + +<p><img alt="" src="https://mdn.mozillademos.org/files/10819/notification-bubble.png" style="display: block; height: 205px; margin: 0 auto; width: 453px;"></p> + +<p>여기에서 사용자는 이 origin 으로부터의 알림을 허용할지, 차단할지, 이 시점에는 선택하지 않을지를 선택할 수 있습니다. 하나가 선택된후에는, 그 설정이 현재 세션에대해서 일반적으로 유지됩니다.</p> + +<div class="note"> +<p><strong>노트</strong>: Firefox 44 부터 Notifications 와 <a href="/en-US/docs/Web/API/Push_API">Push</a> 권한이 통합되었습니다. notifications 에대한 권한이 허용되면, push 또한 활성화됩니다.</p> +</div> + +<p>그 다음, {{domxref("Notification.Notification","Notification()")}} 생성자를 사용해 새로운 알림이 생성됩니다. title 인자를 반드시 포함해야하며, 텍스트 방향, 바디 텍스트, 표시할 아이콘, 재생할 알림 사운드 등과 같은 옵션을 지정하는 옵션 객체를 선택적으로 전달할 수 있습니다.</p> + +<p>{{AvailableInWorkers}}</p> + +<p>부가적으로, Notifications API 명세는 <a href="https://developer.mozilla.org/ko/docs/Web/API/Service_Worker_API">ServiceWorker API</a> 에 여러가지 추가 기능을 지정하여 service worker 가 알림을 발생시킬 수 있도록 허용합니다.</p> + +<div class="note"> +<p><strong>노트</strong>: 여러분의 앱에서 알림을 사용하는것에 대한 자세한 내용은 <a href="https://developer.mozilla.org/ko/docs/WebAPI/Using_Web_Notifications">Notifications API 사용하기</a> 글에서 찾아보시기 바랍니다.</p> +</div> + +<h2 id="Notifications_인터페이스">Notifications 인터페이스</h2> + +<dl> + <dt>{{domxref("Notification")}}</dt> + <dd>notification 객체를 정의합니다.</dd> +</dl> + +<h3 id="Service_worker_추가_기능">Service worker 추가 기능</h3> + +<dl> + <dt>{{domxref("ServiceWorkerRegistration")}}</dt> + <dd>알림 표시 제어를 위한 {{domxref("ServiceWorkerRegistration.showNotification()")}} 와 {{domxref("ServiceWorkerRegistration.getNotifications()")}} 메소드를 포함합니다.</dd> + <dt>{{domxref("ServiceWorkerGlobalScope")}}</dt> + <dd>알림이 클릭됐을 때 커스텀 함수를 실행하기 위한 {{domxref("ServiceWorkerGlobalScope.onnotificationclick")}} 핸들러를 포함합니다.</dd> + <dt>{{domxref("NotificationEvent")}}</dt> + <dd>{{domxref("ExtendableEvent")}} 를 기반으로한 이벤트 객체의 특정 타입입니다. 발생한 알림을 나타냅니다.</dd> +</dl> + +<h2 id="명세">명세</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">명세</th> + <th scope="col">상태</th> + <th scope="col">코멘트</th> + </tr> + <tr> + <td>{{SpecName('Web Notifications')}}</td> + <td>{{Spec2('Web Notifications')}}</td> + <td>Living standard</td> + </tr> + </tbody> +</table> + +<h2 id="브라우저_호환성">브라우저 호환성</h2> + +<h3 id="Notification"><code>Notification</code></h3> + + + +<p>{{Compat("api.Notification")}}</p> + +<h2 id="함께_보기">함께 보기</h2> + +<ul> + <li><a href="https://developer.mozilla.org/ko/docs/WebAPI/Using_Web_Notifications">Notifications API 사용하기</a></li> +</ul> |