- From: poot <cvsmail@w3.org>
- Date: Fri, 09 Sep 2011 21:26:37 -0400
- To: public-html-diffs@w3.org
webstorage; hixie: Update Event interfaces to use constructors instead of init*Event methods; remove some typedefs. (whatwg r6551) http://dev.w3.org/cvsweb/html5/webstorage/Overview.html?r1=1.181&r2=1.182&f=h http://html5.org/tools/web-apps-tracker?from=6550&to=6551 =================================================================== RCS file: /sources/public/html5/webstorage/Overview.html,v retrieving revision 1.181 retrieving revision 1.182 diff -u -d -r1.181 -r1.182 --- Overview.html 17 Aug 2011 23:33:34 -0000 1.181 +++ Overview.html 10 Sep 2011 01:26:22 -0000 1.182 @@ -213,7 +213,7 @@ <p><a href="http://www.w3.org/"><img alt="W3C" height="48" src="http://www.w3.org/Icons/w3c_home" width="72"></a></p> <h1>Web Storage</h1> - <h2 class="no-num no-toc" id="editor-s-draft-17-august-2011">Editor's Draft 17 August 2011</h2> + <h2 class="no-num no-toc" id="editor-s-draft-10-september-2011">Editor's Draft 10 September 2011</h2> <dl><dt>Latest Published Version:</dt> <dd><a href="http://www.w3.org/TR/webstorage/">http://www.w3.org/TR/webstorage/</a></dd> <dt>Latest Editor's Draft:</dt> @@ -318,7 +318,7 @@ </dl><p>The W3C <a href="http://www.w3.org/2008/webapps/">Web Applications Working Group</a> is the W3C working group responsible for this specification's progress along the W3C Recommendation track. - This specification is the 17 August 2011 Editor's Draft. + This specification is the 10 September 2011 Editor's Draft. </p><p>This document was produced by a group operating under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5 February 2004 W3C Patent Policy</a>. W3C maintains a <a href="http://www.w3.org/2004/01/pp-impl/42538/status" rel="disclosure">public list of any patent disclosures</a> made in connection with the deliverables @@ -651,35 +651,52 @@ becomes <span>fully active</span> again.<p>The <span>task source</span> for this task is the <span>DOM manipulation task source</span>.<p>If the event is being fired due to an invocation of the <code title="dom-Storage-setItem"><a href="#dom-storage-setitem">setItem()</a></code> or <code title="dom-Storage-removeItem"><a href="#dom-storage-removeitem">removeItem()</a></code> methods, the event must have its <code title="dom-StorageEvent-key"><a href="#dom-storageevent-key">key</a></code> - attribute set to the name of the key in question, its <code title="dom-StorageEvent-oldValue"><a href="#dom-storageevent-oldvalue">oldValue</a></code> attribute set to + attribute initialized to the name of the key in question, its <code title="dom-StorageEvent-oldValue"><a href="#dom-storageevent-oldvalue">oldValue</a></code> attribute initialized to the old value of the key in question, or null if the key is newly - added, and its <code title="dom-StorageEvent-newValue"><a href="#dom-storageevent-newvalue">newValue</a></code> attribute set to + added, and its <code title="dom-StorageEvent-newValue"><a href="#dom-storageevent-newvalue">newValue</a></code> attribute initialized to the new value of the key in question, or null if the key was removed.<p>Otherwise, if the event is being fired due to an invocation of the <code title="dom-Storage-clear"><a href="#dom-storage-clear">clear()</a></code> method, the event - must have its <code title="dom-StorageEvent-key"><a href="#dom-storageevent-key">key</a></code>, <code title="dom-StorageEvent-oldValue"><a href="#dom-storageevent-oldvalue">oldValue</a></code>, and <code title="dom-StorageEvent-newValue"><a href="#dom-storageevent-newvalue">newValue</a></code> attributes set to - null.<p>In addition, the event must have its <code title="dom-StorageEvent-url"><a href="#dom-storageevent-url">url</a></code> attribute set to <span title="the document's address">the address of the document</span> - whose <code><a href="#storage-0">Storage</a></code> object was affected; and its <code title="dom-StorageEvent-storageArea"><a href="#dom-storageevent-storagearea">storageArea</a></code> attribute - set to the <code><a href="#storage-0">Storage</a></code> object from the <code>Window</code> - object of the target <code>Document</code> that represents the same - kind of <code><a href="#storage-0">Storage</a></code> area as was affected (i.e. session or - local).<h4 id="event-definition"><span class="secno">4.4.1 </span>Event definition</h4><pre class="idl">interface <dfn id="storageevent">StorageEvent</dfn> : <span>Event</span> { + must have its <code title="dom-StorageEvent-key"><a href="#dom-storageevent-key">key</a></code>, <code title="dom-StorageEvent-oldValue"><a href="#dom-storageevent-oldvalue">oldValue</a></code>, and <code title="dom-StorageEvent-newValue"><a href="#dom-storageevent-newvalue">newValue</a></code> attributes + initialized to null.<p>In addition, the event must have its <code title="dom-StorageEvent-url"><a href="#dom-storageevent-url">url</a></code> attribute initialized to + <span title="the document's address">the address of the + document</span> whose <code><a href="#storage-0">Storage</a></code> object was affected; and + its <code title="dom-StorageEvent-storageArea"><a href="#dom-storageevent-storagearea">storageArea</a></code> + attribute initialized to the <code><a href="#storage-0">Storage</a></code> object from the + <code>Window</code> object of the target <code>Document</code> that + represents the same kind of <code><a href="#storage-0">Storage</a></code> area as was + affected (i.e. session or local).<h4 id="event-definition"><span class="secno">4.4.1 </span>Event definition</h4><pre class="idl">[Constructor(DOMString type, optional <a href="#storageeventinit">StorageEventInit</a> eventInitDict)] +interface <dfn id="storageevent">StorageEvent</dfn> : <span>Event</span> { readonly attribute DOMString <a href="#dom-storageevent-key" title="dom-StorageEvent-key">key</a>; readonly attribute DOMString? <a href="#dom-storageevent-oldvalue" title="dom-StorageEvent-oldValue">oldValue</a>; readonly attribute DOMString? <a href="#dom-storageevent-newvalue" title="dom-StorageEvent-newValue">newValue</a>; readonly attribute DOMString <a href="#dom-storageevent-url" title="dom-StorageEvent-url">url</a>; readonly attribute <a href="#storage-0">Storage</a>? <a href="#dom-storageevent-storagearea" title="dom-StorageEvent-storageArea">storageArea</a>; - void <a href="#dom-storageevent-initstorageevent" title="dom-StorageEvent-initStorageEvent">initStorageEvent</a>(DOMString typeArg, boolean canBubbleArg, boolean cancelableArg, DOMString keyArg, DOMString? oldValueArg, DOMString? newValueArg, DOMString urlArg, <a href="#storage-0">Storage</a>? storageAreaArg); -};</pre><p>The <dfn id="dom-storageevent-initstorageevent" title="dom-StorageEvent-initStorageEvent"><code>initStorageEvent()</code></dfn> - method must initialize the event in a manner analogous to the - similarly-named method in the DOM Events interfaces. <a href="#refsDOMEVENTS">[DOMEVENTS]</a><p>The <dfn id="dom-storageevent-key" title="dom-StorageEvent-key"><code>key</code></dfn> - attribute represents the key being changed.<p>The <dfn id="dom-storageevent-oldvalue" title="dom-StorageEvent-oldValue"><code>oldValue</code></dfn> - attribute represents the old value of the key being changed.<p>The <dfn id="dom-storageevent-newvalue" title="dom-StorageEvent-newValue"><code>newValue</code></dfn> - attribute represents the new value of the key being changed.<p>The <dfn id="dom-storageevent-url" title="dom-StorageEvent-url"><code>url</code></dfn> - attribute represents the address of the document whose key +}; + +dictionary <dfn id="storageeventinit">StorageEventInit</dfn> : <span>EventInit</span> { + DOMString key; + DOMString? oldValue; + DOMString? newValue; + DOMString url; + <a href="#storage-0">Storage</a>? storageArea; +};</pre><p>The <dfn id="dom-storageevent-key" title="dom-StorageEvent-key"><code>key</code></dfn> + attribute must return the value it was initialized to. When the + object is created, this attribute must be initialized to the empty + string. It represents the key being changed.<p>The <dfn id="dom-storageevent-oldvalue" title="dom-StorageEvent-oldValue"><code>oldValue</code></dfn> + attribute must return the value it was initialized to. When the + object is created, this attribute must be initialized to null. It + represents the old value of the key being changed.<p>The <dfn id="dom-storageevent-newvalue" title="dom-StorageEvent-newValue"><code>newValue</code></dfn> + attribute must return the value it was initialized to. When the + object is created, this attribute must be initialized to null. It + represents the new value of the key being changed.<p>The <dfn id="dom-storageevent-url" title="dom-StorageEvent-url"><code>url</code></dfn> + attribute must return the value it was initialized to. When the + object is created, this attribute must be initialized to the empty + string. It represents the address of the document whose key changed.<p>The <dfn id="dom-storageevent-storagearea" title="dom-StorageEvent-storageArea"><code>storageArea</code></dfn> - attribute represents the <code><a href="#storage-0">Storage</a></code> object that was - affected.<h3 id="threads"><span class="secno">4.5 </span>Threads</h3><p>Because of <a href="#localStorageMutex">the use</a> of the + attribute must return the value it was initialized to. When the + object is created, this attribute must be initialized to null. It + represents the <code><a href="#storage-0">Storage</a></code> object that was affected.<h3 id="threads"><span class="secno">4.5 </span>Threads</h3><p>Because of <a href="#localStorageMutex">the use</a> of the <span>storage mutex</span>, multiple browsing contexts will be able to access the local storage areas simultaneously in such a manner that scripts cannot detect any concurrent script execution.<p>Thus, the <code title="dom-Storage-length"><a href="#dom-storage-length">length</a></code> @@ -843,11 +860,6 @@ <dt id="refsDOMCORE">[DOMCORE]</dt> <dd><cite><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html">Web DOM Core</a></cite>, A. van Kesteren. W3C.</dd> - <dt id="refsDOMEVENTS">[DOMEVENTS]</dt> - <dd><cite><a href="http://dev.w3.org/2006/webapi/DOM-Level-3-Events/html/DOM3-Events.html">Document - Object Model (DOM) Level 3 Events Specification</a></cite>, - D. Schepers. W3C.</dd> - <dt id="refsECMA262">[ECMA262]</dt> <dd><cite><a href="http://www.ecma-international.org/publications/standards/Ecma-262.htm">ECMAScript Language Specification</a></cite>. ECMA.</dd>
Received on Saturday, 10 September 2011 01:26:44 UTC