Short URL: http://html5.org/r/2597
| SVN | Bug | Comment | Time (UTC) |
|---|---|---|---|
| 2597 | Remove 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>