HTML Standard Tracker

Diff (omit for latest revision)
Filter

Short URL: http://html5.org/r/2597

File a bug

SVNBugCommentTime (UTC)
2597Remove the showNotification() API due to lack of interest from implementors.2008-12-28 06:20
Index: source
===================================================================
--- source	(revision 2596)
+++ source	(revision 2597)
@@ -17123,7 +17123,7 @@
 
    </dd>
 
-
+<!-- XXX-NOTIFY
    <dt>The <dfn>sandboxed annoyances browsing context flag</dfn></dt>
 
    <dd>
@@ -17133,6 +17133,7 @@
     the <span>nested browsing context</span>.</p>
 
    </dd>
+-->
 
 
    <dt>The <dfn>sandboxed origin browsing context flag</dfn>, unless
@@ -37750,9 +37751,9 @@
   void <span title="dom-print">print</span>();
   any <span title="dom-showModalDialog">showModalDialog</span>(in DOMString url);
   any <span title="dom-showModalDialog">showModalDialog</span>(in DOMString url, in any arguments);<!--
-  any <span title="dom-showModalDialog">showModalDialog</span>(in DOMString url, in any arguments, in DOMString features);-->
+  any <span title="dom-showModalDialog">showModalDialog</span>(in DOMString url, in any arguments, in DOMString features);--><!-- XXX-NOTIFY
   void <span title="dom-showNotification">showNotification</span>(in DOMString title, in DOMString subtitle, in DOMString description);
-  void <span title="dom-showNotification">showNotification</span>(in DOMString title, in DOMString subtitle, in DOMString description, in VoidCallback onclick);
+  void <span title="dom-showNotification">showNotification</span>(in DOMString title, in DOMString subtitle, in DOMString description, in VoidCallback onclick);-->
 
   // <span>cross-document messaging</span>
   void <span title="dom-window-postMessage-2">postMessage</span>(in any message, in DOMString targetOrigin);
@@ -40032,9 +40033,10 @@
   close the browsing context.</p>
 
 
+<!-- XXX-NOTIFY
   <h4>Notifications</h4>
 
-<!-- v2 feature requests:
+<!- - v2 feature requests:
 
    - ability to snooze a notification so it comes again later
       - shouldn't be on all messages, only those for which it makes
@@ -40042,8 +40044,9 @@
       - possibly just provide a new argument that takes an array of
         (label, callback) tuples so that sites can implement this
         themselves
+      - full HTML notifications
 
-  -->
+  - ->
 
   <p>Notifications are short, transient messages that bring the user's
   attention to new information, or remind the user of scheduled
@@ -40074,24 +40077,24 @@
   title="">onclick</var>)</code></dfn> method, when invoked, must
   cause the user agent to show a notification.</p>
 
-  <p id="sandboxNotifications">If the method was invoked from a <span title="concept-script">script</span>
-  whose <span title="script's browsing context">browsing
-  context</span> has the <span>sandboxed annoyances browsing context
-  flag</span> set, then the notification must be shown within that
-  <span>browsing context</span>. The notification is said to be a
-  <dfn>sandboxed notification</dfn>.</p>
+  <p id="sandboxNotifications">If the method was invoked from a <span
+  title="concept-script">script</span> whose <span title="script's
+  browsing context">browsing context</span> has the <span>sandboxed
+  annoyances browsing context flag</span> set, then the notification
+  must be shown within that <span>browsing context</span>. The
+  notification is said to be a <dfn>sandboxed notification</dfn>.</p>
 
   <p>Otherwise, if the <span>origin</span> of the <span
   title="script's browsing context">browsing context</span> of the
-  <span title="concept-script">script</span> that invoked the method is <em>not</em> flagged as being a
-  <span>trusted notification source</span>, then the notification
-  should be rendered within the <span>top-level browsing
-  context</span> of the <span>script's browsing context</span>. The
-  notification is said to be a <dfn>normal notification</dfn>. User
-  agents should provide a way to set the origin's <span>trusted
-  notification source</span> flag from the notification, so that the
-  user can benefit from notifications even when the user agent is not
-  the active application.</p>
+  <span title="concept-script">script</span> that invoked the method
+  is <em>not</em> flagged as being a <span>trusted notification
+  source</span>, then the notification should be rendered within the
+  <span>top-level browsing context</span> of the <span>script's
+  browsing context</span>. The notification is said to be a
+  <dfn>normal notification</dfn>. User agents should provide a way to
+  set the origin's <span>trusted notification source</span> flag from
+  the notification, so that the user can benefit from notifications
+  even when the user agent is not the active application.</p>
 
   <p>Otherwise, the <span>origin</span> is flagged as a <span>trusted
   notification source</span>, and the notification should be shown
@@ -40136,15 +40139,17 @@
   <span>sandboxed notification</span>) is shown, the user agent may
   bring the user's attention to the <span>top-level browsing
   context</span> of the <span title="script's browsing
-  context">browsing context</span> of the <span title="concept-script">script</span> that invoked the
-  method, if that would be useful; but user agents should not use
-  system-wide notification mechanisms to do so.</p>
+  context">browsing context</span> of the <span
+  title="concept-script">script</span> that invoked the method, if
+  that would be useful; but user agents should not use system-wide
+  notification mechanisms to do so.</p>
 
   <p>When a <span>trusted notification</span> is shown, the user agent
   should bring the user's attention to the notification and the <span
   title="script's browsing context">browsing context</span> of the
-  <span title="concept-script">script</span> that invoked the method, as per the platform conventions for
-  attracting the user's attention to applications.</p>
+  <span title="concept-script">script</span> that invoked the method,
+  as per the platform conventions for attracting the user's attention
+  to applications.</p>
 
   <div class="example">
 
@@ -40172,8 +40177,8 @@
    name</span>, if available, or else the <span
    title="dom-document-title">document title</span>, of the
    <span>active document</span> of the <span title="script's browsing
-   context">browsing context</span> of the <span title="concept-script">script</span> that invoked the
-   method.</li>
+   context">browsing context</span> of the <span
+   title="concept-script">script</span> that invoked the method.</li>
 
    <li>An icon chosen from the <span title="external resource
    link">external resource links</span> of type <code
@@ -40223,6 +40228,7 @@
   attention, and the <var title="">onclick</var> callback should then
   be invoked.</p>
 
+-->
 
 
   <h3>System state and capabilities</h3>

|