--- a/Overview.html Wed Apr 30 14:41:03 2014 -0700
+++ b/Overview.html Fri May 09 15:31:52 2014 -0700
@@ -47,7 +47,7 @@
<!--end-logo-->
<h1>Web Notifications</h1>
-<h2 class="no-num no-toc" id="editor's-draft-15-august-2013">Editor's Draft 15 August 2013</h2>
+<h2 class="no-num no-toc" id="editor's-draft-9-may-2014">Editor's Draft 9 May 2014</h2>
<dl>
<dt>This Version:
@@ -64,7 +64,7 @@
<dd><a href="http://www.w3.org/TR/2012/WD-notifications-20120614/">http://www.w3.org/TR/2012/WD-notifications-20120614/</a>
<dd><a href="http://www.w3.org/TR/2011/WD-notifications-20110301/">http://www.w3.org/TR/2011/WD-notifications-20110301/</a>
- <dt>W3C Editor:
+ <dt>Former W3C Editor:
<dd>John Gregg (<a href="http://www.google.com/">Google</a>)
<<a href="mailto:johnnyg@google.com">johnnyg@google.com</a>></dd>
<dt>WHATWG Editor:
@@ -75,7 +75,7 @@
<!--begin-copyright-->
-<p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 2013 <a href="http://www.w3.org/"><abbr title="World Wide Web Consortium">W3C</abbr></a><sup>®</sup> (<a href="http://www.csail.mit.edu/"><abbr title="Massachusetts Institute of Technology">MIT</abbr></a>, <a href="http://www.ercim.eu/"><abbr title="European Research Consortium for Informatics and Mathematics">ERCIM</abbr></a>, <a href="http://www.keio.ac.jp/">Keio</a>), All Rights Reserved. W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>, <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a> and <a href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a> rules apply.</p>
+<p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 2014 <a href="http://www.w3.org/"><abbr title="World Wide Web Consortium">W3C</abbr></a><sup>®</sup> (<a href="http://www.csail.mit.edu/"><abbr title="Massachusetts Institute of Technology">MIT</abbr></a>, <a href="http://www.ercim.eu/"><abbr title="European Research Consortium for Informatics and Mathematics">ERCIM</abbr></a>, <a href="http://www.keio.ac.jp/">Keio</a>), All Rights Reserved. W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>, <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a> and <a href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a> rules apply.</p>
<!--end-copyright-->
</div>
@@ -96,17 +96,11 @@
found in the <a href="http://www.w3.org/TR/">W3C technical reports index</a>
at http://www.w3.org/TR/.</em>
-<p>This is the 15 August 2013 Editor's Draft of Web Notifications.
+<p>This is the 9 May 2014 Editor's Draft of Web Notifications.
Please send comments to
<a href="mailto:public-web-notification@w3.org">public-web-notification@w3.org</a>
(<a href="http://lists.w3.org/Archives/Public/public-web-notification/">archived</a>).
-<p class="alt">The bulk of the text of this specification is also
-available in the
-WHATWG <a href="http://notifications.spec.whatwg.org/">Notifications API
-Standard</a>, under a license that permits reuse of the specification
-text.</p>
-
<p>The W3C
<a href="http://www.w3.org/2010/web-notifications/">Web Notification
Working Group</a> is the W3C working group responsible for this
@@ -114,6 +108,21 @@
Group expects to advance this Working Draft to Recommendation
Status.</p>
+<p class="alt">This feature is also being worked on by
+the <a href="http://www.whatwg.org/">WHATWG</a>. The bulk of the
+text of this specification is available in the
+WHATWG <a href="http://notifications.spec.whatwg.org/">Notifications
+API Standard</a>, under a license that permits reuse of the
+specification text.</p>
+
+<p>The two specifications are normatively identical up to WHATWG
+revision <a href="https://github.com/whatwg/notifications/commit/998421f">998421f</a>
+(W3C
+revision <a href="https://dvcs.w3.org/hg/notifications/raw-file/498b5397ed3f/Overview.html">498b5397ed3f</a>).
+Since that revision, the WHATWG is exploring new features which may be
+incorporated into future levels of this specification. Bugfixes and
+editorial changes have been merged to minimize divergence.</p>
+
<p>Publication as a Working Draft does not imply endorsement by the W3C
Membership. This is a draft document and may be updated, replaced or
obsoleted by other documents at any time. It is inappropriate to cite this
@@ -148,10 +157,11 @@
<li><a href="#permission"><span class="secno">4.3 </span>Permission</a></li>
<li><a href="#notification-lists"><span class="secno">4.4 </span>Notification lists</a></li>
<li><a href="#showing-a-notification"><span class="secno">4.5 </span>Showing a notification</a></li>
- <li><a href="#closing-a-notification"><span class="secno">4.6 </span>Closing a notification</a></li>
- <li><a href="#pending-notifications"><span class="secno">4.7 </span>Pending notifications</a></li>
- <li><a href="#displaying-notifications"><span class="secno">4.8 </span>Displaying notifications</a></li>
- <li><a href="#replacing-a-notification"><span class="secno">4.9 </span>Replacing a notification</a></ol></li>
+ <li><a href="#activating-a-notification"><span class="secno">4.6 </span>Activating a notification</a></li>
+ <li><a href="#closing-a-notification"><span class="secno">4.7 </span>Closing a notification</a></li>
+ <li><a href="#pending-notifications"><span class="secno">4.8 </span>Pending notifications</a></li>
+ <li><a href="#displaying-notifications"><span class="secno">4.9 </span>Displaying notifications</a></li>
+ <li><a href="#replacing-a-notification"><span class="secno">4.10 </span>Replacing a notification</a></ol></li>
<li><a href="#api"><span class="secno">5 </span>API</a></li>
<li><a href="#examples"><span class="secno">6 </span>Examples</a>
<ol class="toc">
@@ -243,7 +253,7 @@
<p>Each <a href="#concept-notification" title="concept-notification">notification</a> <em>can</em>
have an associated <dfn id="body">body</dfn>, <dfn id="tag">tag</dfn>, <dfn id="icon-url">icon URL</dfn>, and
-<dfn id="icon">icon</dfn>.
+<dfn id="icon-image">icon image</dfn>.
<h3 id="direction-0"><span class="secno">4.1 </span>Direction</h3>
@@ -342,15 +352,32 @@
the <a href="#display-steps">display steps</a> and terminate these steps.
<li><p>If the device has limitations on the number of concurrent
- notifications, either immediately call to a notifications platform which
+ notifications, either immediately call to a notification platform which
natively supports queueing, or append <var title="">notification</var> to the
<a href="#list-of-pending-notifications">list of pending notifications</a>.
</ol>
-<h3 id="closing-a-notification"><span class="secno">4.6 </span>Closing a notification</h3>
+<h3 id="activating-a-notification"><span class="secno">4.6 </span>Activating a notification</h3>
+
+<p>When a <a href="#concept-notification" title="concept-notification">notification</a>
+<var title="">notification</var> is activated by the user, assuming the underlying
+notification platform supports activation, the user agent must, for each
+<code><a href="#notification">Notification</a></code> object representing <var title="">notification</var>,
+<a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#queue-a-task">queue a task</a> to
+<a class="external" href="http://dom.spec.whatwg.org/#concept-event-fire" title="concept-event-fire">fire an event</a>
+named <code title="">click</code> on the <code><a href="#notification">Notification</a></code> object.
+
+<p class="note">Throughout the web platform "activate" is intentionally misnamed as "click".
+
+<p class="note">User agents are strongly encouraged to make
+<code class="external" title="dom-window-focus"><a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/editing.html#dom-window-focus">window.focus()</a></code> work from within
+the event listener for the event named <code title="">click</code> as a means of focusing the
+browsing context related to the notification.
+
+<h3 id="closing-a-notification"><span class="secno">4.7 </span>Closing a notification</h3>
<p>When a <a href="#concept-notification" title="concept-notification">notification</a> is closed,
-either by the underlying notifications platform or by the user, the
+either by the underlying notification platform or by the user, the
<a href="#close-steps">close steps</a> for it must be run.
<p>The <dfn id="close-steps">close steps</dfn> for a given <var title="">notification</var> are:
@@ -368,7 +395,7 @@
named <code title="">close</code> on <var title="">notification</var>.
</ol>
-<h3 id="pending-notifications"><span class="secno">4.7 </span>Pending notifications</h3>
+<h3 id="pending-notifications"><span class="secno">4.8 </span>Pending notifications</h3>
<p>Whenever the <a href="#list-of-pending-notifications">list of pending notifications</a> is not empty, the
user agent must wait and monitor changes in the available notification space
@@ -381,7 +408,7 @@
<a href="#list-of-pending-notifications">list of pending notifications</a> and then remove it from the
<a href="#list-of-pending-notifications">list of pending notifications</a>.
-<h3 id="displaying-notifications"><span class="secno">4.8 </span>Displaying notifications</h3>
+<h3 id="displaying-notifications"><span class="secno">4.9 </span>Displaying notifications</h3>
<p>The <dfn id="display-steps">display steps</dfn> for a given <var title="">notification</var>
are:
@@ -396,8 +423,8 @@
<p>Once <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/fetching-resources.html#fetch" title="fetch">fetching</a> has
finished and the image format is supported, set
- <var title="">notification</var>'s <a href="#icon">icon</a> to the decoded resource.
- (Otherwise <var title="">notification</var> has no <a href="#icon">icon</a>.)
+ <var title="">notification</var>'s <a href="#icon-image">icon image</a> to the decoded resource.
+ (Otherwise <var title="">notification</var> has no <a href="#icon-image">icon image</a>.)
<li>
<p><a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#queue-a-task">Queue a task</a> to run these substeps:
@@ -421,7 +448,7 @@
</ol>
-<h3 id="replacing-a-notification"><span class="secno">4.9 </span>Replacing a notification</h3>
+<h3 id="replacing-a-notification"><span class="secno">4.10 </span>Replacing a notification</h3>
<p>The <dfn id="replace-steps">replace steps</dfn> for replacing an <var title="">old</var>
<a href="#concept-notification" title="concept-notification">notification</a> with a
@@ -437,8 +464,8 @@
<p>Once <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/fetching-resources.html#fetch" title="fetch">fetching</a> has
finished and the image format is supported, set
- <var title="">new</var>'s <a href="#icon">icon</a> to the decoded resource.
- (Otherwise <var title="">new</var> has no <a href="#icon">icon</a>.)
+ <var title="">new</var>'s <a href="#icon-image">icon image</a> to the decoded resource.
+ (Otherwise <var title="">new</var> has no <a href="#icon-image">icon image</a>.)
<li><p>If <var title="">old</var> is in the
<a href="#list-of-pending-notifications">list of pending notifications</a>,
@@ -485,6 +512,7 @@
attribute <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#eventhandler">EventHandler</a> <a href="#handler-onerror" title="handler-onerror">onerror</a>;
attribute <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#eventhandler">EventHandler</a> <a href="#handler-onclose" title="handler-onclose">onclose</a>;
+ readonly attribute DOMString <a href="#dom-notification-title" title="dom-Notification-title">title</a>;
readonly attribute <a href="#notificationdirection">NotificationDirection</a> <a href="#dom-notification-dir" title="dom-Notification-dir">dir</a>;
readonly attribute DOMString <a href="#dom-notification-dir" title="dom-Notification-dir">lang</a>;
readonly attribute DOMString <a href="#dom-notification-dir" title="dom-Notification-dir">body</a>;
@@ -549,12 +577,10 @@
<li><p>If <var title="">options</var>'s <code title="">icon</code> is present,
<a class="external" href="http://url.spec.whatwg.org/#concept-url-parser" title="concept-url-parser">parse</a>
- <code title="">icon</code> using the
- <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#entry-script">entry script</a>'s
- <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#script's-base-url" title="script's base URL">base URL</a>, and
- if that does not return failure, set
- <var title="">notification</var>'s <a href="#icon-url">icon URL</a> to the return value. (Otherwise
- <a href="#icon-url">icon URL</a> is not set.)
+ <code title="">icon</code> using the <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#api-base-url">API base URL</a>
+ specified by the <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#entry-settings-object">entry settings object</a>, and if that
+ does not return failure, set <var title="">notification</var>'s <a href="#icon-url">icon URL</a> to the
+ return value. (Otherwise <a href="#icon-url">icon URL</a> is not set.)
<li><p>Return <var title="">notification</var>, but continue running these
steps asynchronouusly.
@@ -626,6 +652,9 @@
must run the <a href="#close-steps">close steps</a> for the
<a href="#concept-notification" title="concept-notification">notification</a>.
+<p>The <dfn id="dom-notification-title" title="dom-Notification-title"><code>title</code></dfn> attribute must return the
+<a href="#concept-notification" title="concept-notification">notification</a>'s <a href="#title">title</a>.
+
<p>The <dfn id="dom-notification-dir" title="dom-Notification-dir"><code>dir</code></dfn> attribute must return the
<a href="#concept-notification" title="concept-notification">notification</a>'s <a href="#direction">direction</a>.
@@ -743,10 +772,10 @@
<dd><cite><a href="http://tools.ietf.org/html/rfc2119">Key words for use in RFCs to Indicate Requirement Levels</a></cite>, Scott Bradner. IETF.
<dt id="refsURL">[URL]
-<dd><cite><a href="http://url.spec.whatwg.org/">URL Standard</a></cite>, Anne van Kesteren. WHATWG.
+<dd><cite><a href="http://url.spec.whatwg.org/">URL</a></cite>, Anne van Kesteren. WHATWG.
<dt id="refsWEBIDL">[WEBIDL]
-<dd><cite><a href="http://dev.w3.org/2006/webapi/WebIDL/">Web IDL</a></cite>, Cameron McCormack. W3C.
+<dd><cite><a href="http://heycam.github.io/webidl/">Web IDL</a></cite>, Cameron McCormack. W3C.
</dl></div>
@@ -762,10 +791,12 @@
Drew Wilson,
Jake Archibald,
Edward O'Connor,
+Frederick Hirsch,
Ian Hickson,
James Graham,
Jon Lee,
Jonas Sicking,
+Michael Henretty,
Olli Pettay, and
Simon Pieters
for being awesome.
--- a/Overview.src.html Wed Apr 30 14:41:03 2014 -0700
+++ b/Overview.src.html Fri May 09 15:31:52 2014 -0700
@@ -71,7 +71,7 @@
<dd><a href="http://www.w3.org/TR/2012/WD-notifications-20120614/">http://www.w3.org/TR/2012/WD-notifications-20120614/</a>
<dd><a href="http://www.w3.org/TR/2011/WD-notifications-20110301/">http://www.w3.org/TR/2011/WD-notifications-20110301/</a>
- <dt>W3C Editor:
+ <dt>Former W3C Editor:
<dd>John Gregg (<a href="http://www.google.com/">Google</a>)
<<a href="mailto:johnnyg@google.com">johnnyg@google.com</a>></dd>
<dt>WHATWG Editor:
@@ -105,12 +105,6 @@
<a href="mailto:public-web-notification@w3.org">public-web-notification@w3.org</a>
(<a href="http://lists.w3.org/Archives/Public/public-web-notification/">archived</a>).
-<p class="alt">The bulk of the text of this specification is also
-available in the
-WHATWG <a href="http://notifications.spec.whatwg.org/">Notifications API
-Standard</a>, under a license that permits reuse of the specification
-text.</p>
-
<p>The W3C
<a href="http://www.w3.org/2010/web-notifications/">Web Notification
Working Group</a> is the W3C working group responsible for this
@@ -118,6 +112,21 @@
Group expects to advance this Working Draft to Recommendation
Status.</p>
+<p class="alt">This feature is also being worked on by
+the <a href="http://www.whatwg.org/">WHATWG</a>. The bulk of the
+text of this specification is available in the
+WHATWG <a href="http://notifications.spec.whatwg.org/">Notifications
+API Standard</a>, under a license that permits reuse of the
+specification text.</p>
+
+<p>The two specifications are normatively identical up to WHATWG
+revision <a href="https://github.com/whatwg/notifications/commit/998421f">998421f</a>
+(W3C
+revision <a href="https://dvcs.w3.org/hg/notifications/raw-file/498b5397ed3f/Overview.html">498b5397ed3f</a>).
+Since that revision, the WHATWG is exploring new features which may be
+incorporated into future levels of this specification. Bugfixes and
+editorial changes have been merged to minimize divergence.</p>
+
<p>Publication as a Working Draft does not imply endorsement by the W3C
Membership. This is a draft document and may be updated, replaced or
obsoleted by other documents at any time. It is inappropriate to cite this