- From: poot <cvsmail@w3.org>
- Date: Wed, 04 May 2011 20:04:41 -0400
- To: public-html-diffs@w3.org
hixie: add explicit dependency on File API spec (whatwg r6075)
http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.4878&r2=1.4879&f=h
http://html5.org/tools/web-apps-tracker?from=6074&to=6075
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4878
retrieving revision 1.4879
diff -u -d -r1.4878 -r1.4879
--- Overview.html 4 May 2011 23:54:43 -0000 1.4878
+++ Overview.html 5 May 2011 00:01:04 -0000 1.4879
@@ -340,7 +340,7 @@
<h1>HTML5</h1>
<h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2>
- <h2 class="no-num no-toc" id="editor-s-draft-4-may-2011">Editor's Draft 4 May 2011</h2>
+ <h2 class="no-num no-toc" id="editor-s-draft-5-may-2011">Editor's Draft 5 May 2011</h2>
<dl><dt>Latest Published Version:</dt>
<dd><a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a></dd>
<dt>Latest Editor's Draft:</dt>
@@ -483,7 +483,7 @@
Group</a> is the W3C working group responsible for this
specification's progress along the W3C Recommendation
track.
- This specification is the 4 May 2011 Editor's Draft.
+ This specification is the 5 May 2011 Editor's Draft.
</p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><p>Work on this specification is also done at the <a href="http://www.whatwg.org/">WHATWG</a>. The W3C HTML working group
actively pursues convergence with the WHATWG, as required by the <a href="http://www.w3.org/2007/03/HTML-WG-charter">W3C HTML working
group charter</a>.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><p>This document was produced by a group operating under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5
@@ -2925,6 +2925,19 @@
</ul></dd>
+ <dt>File API</dt>
+
+ <dd>
+
+ <p>This specification uses the following interfaces defined in the
+ File API specification: <a href="#refsFILEAPI">[FILEAPI]</a></p>
+
+ <ul class="brief"><li><dfn id="blob">Blob</dfn></li>
+ <li><dfn id="file">File</dfn></li>
+ <li><dfn id="filelist">FileList</dfn></li>
+
+ </ul></dd>
+
<dt>Web IDL</dt>
<dd>
@@ -7062,17 +7075,17 @@
<code title="dom-canvaspixelarray-length">length</code> and pixel
values as the <var title="">input</var>'s.</dd>
- <dt>If <var title="">input</var> is a <code>File</code> object</dt>
+ <dt>If <var title="">input</var> is a <code><a href="#file">File</a></code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed <code>File</code> object corresponding to the same underlying data.</dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed <code><a href="#file">File</a></code> object corresponding to the same underlying data.</dd>
- <dt>If <var title="">input</var> is a <code>Blob</code> object</dt>
+ <dt>If <var title="">input</var> is a <code><a href="#blob">Blob</a></code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed <code>Blob</code> object corresponding to the same underlying data.</dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed <code><a href="#blob">Blob</a></code> object corresponding to the same underlying data.</dd>
- <dt>If <var title="">input</var> is a <code>FileList</code> object</dt>
+ <dt>If <var title="">input</var> is a <code><a href="#filelist">FileList</a></code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed <code>FileList</code> object containing a list of newly constructed <code>File</code> objects corresponding to the same underlying data as those in <var title="">input</var>, maintaining their relative order.</dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed <code><a href="#filelist">FileList</a></code> object containing a list of newly constructed <code><a href="#file">File</a></code> objects corresponding to the same underlying data as those in <var title="">input</var>, maintaining their relative order.</dd>
<dt>If <var title="">input</var> is an Array object</dt>
@@ -31167,7 +31180,7 @@
attribute DOMString <a href="#dom-input-dirname" title="dom-input-dirName">dirName</a>;
attribute boolean <a href="#dom-fe-disabled" title="dom-fe-disabled">disabled</a>;
readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <a href="#dom-fae-form" title="dom-fae-form">form</a>;
- readonly attribute <span>FileList</span> <a href="#dom-input-files" title="dom-input-files">files</a>;
+ readonly attribute <a href="#filelist">FileList</a> <a href="#dom-input-files" title="dom-input-files">files</a>;
attribute DOMString <a href="#dom-fs-formaction" title="dom-fs-formAction">formAction</a>;
attribute DOMString <a href="#dom-fs-formenctype" title="dom-fs-formEnctype">formEnctype</a>;
attribute DOMString <a href="#dom-fs-formmethod" title="dom-fs-formMethod">formMethod</a>;
@@ -35477,7 +35490,7 @@
<dd>
- <p>Returns a <code>FileList</code> object listing the <a href="#concept-input-type-file-selected" title="concept-input-type-file-selected">selected files</a> of
+ <p>Returns a <code><a href="#filelist">FileList</a></code> object listing the <a href="#concept-input-type-file-selected" title="concept-input-type-file-selected">selected files</a> of
the form control.</p>
<p>Returns null if the control isn't a file control.</p>
@@ -35598,7 +35611,7 @@
<hr><p>The <dfn id="dom-input-files" title="dom-input-files"><code>files</code></dfn> IDL
attribute allows scripts to access the element's <a href="#concept-input-type-file-selected" title="concept-input-type-file-selected">selected files</a>. On
getting, if the IDL attribute applies, it must return a
- <code>FileList</code> object that represents the current <a href="#concept-input-type-file-selected" title="concept-input-type-file-selected">selected files</a>. The
+ <code><a href="#filelist">FileList</a></code> object that represents the current <a href="#concept-input-type-file-selected" title="concept-input-type-file-selected">selected files</a>. The
same object must be returned until the list of <a href="#concept-input-type-file-selected" title="concept-input-type-file-selected">selected files</a>
changes. If the IDL attribute does not apply, then it must instead
return null. <a href="#refsFILEAPI">[FILEAPI]</a></p>
@@ -51610,7 +51623,7 @@
</dd>
- <dt><i>File</i></dt>
+ <dt><i><a href="#file">File</a></i></dt>
<dd>
<p>Binary data with a file name.</p>
</dd>
@@ -51733,7 +51746,7 @@
DOMString <a href="#dom-datatransfer-getdata" title="dom-DataTransfer-getData">getData</a>(in DOMString format);
void <a href="#dom-datatransfer-setdata" title="dom-DataTransfer-setData">setData</a>(in DOMString format, in DOMString data);
void <a href="#dom-datatransfer-cleardata" title="dom-DataTransfer-clearData">clearData</a>(in optional DOMString format);
- readonly attribute <span>FileList</span> <a href="#dom-datatransfer-files" title="dom-DataTransfer-files">files</a>;
+ readonly attribute <a href="#filelist">FileList</a> <a href="#dom-datatransfer-files" title="dom-DataTransfer-files">files</a>;
};</pre><dl class="domintro"><dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-dropEffect"><a href="#dom-datatransfer-dropeffect">dropEffect</a></code> [ = <var title="">value</var> ]</dt>
<dd>
@@ -51834,7 +51847,7 @@
<dd>
- <p>Returns a <code>FileList</code> of the files being dragged, if any.</p>
+ <p>Returns a <code><a href="#filelist">FileList</a></code> of the files being dragged, if any.</p>
</dd>
@@ -51932,7 +51945,7 @@
<li><p>If there are any items in the <a href="#drag-data-store-item-list">drag data store item
list</a> whose <a href="#the-drag-data-item-kind" title="the drag data item kind">kind</a>
- is <i>File</i>, then add an entry to the list <var title="">L</var>
+ is <i><a href="#file">File</a></i>, then add an entry to the list <var title="">L</var>
consisting of the string "<code title="">Files</code>". (This value
can be distinguished from the other values because it is not
lowercase.)</li>
@@ -52051,18 +52064,18 @@
were included in the drag).</p>
<p>The <dfn id="dom-datatransfer-files" title="dom-DataTransfer-files"><code>files</code></dfn>
- attribute must return a <a href="#live">live</a> <code>FileList</code>
- sequence consisting of <code>File</code> objects representing the
+ attribute must return a <a href="#live">live</a> <code><a href="#filelist">FileList</a></code>
+ sequence consisting of <code><a href="#file">File</a></code> objects representing the
files found by the following steps. The same object must be returned
- each time. Furthermore, for a given <code>FileList</code> object and
- a given underlying file, the same <code>File</code> object must be
+ each time. Furthermore, for a given <code><a href="#filelist">FileList</a></code> object and
+ a given underlying file, the same <code><a href="#file">File</a></code> object must be
used each time.</p>
<ol><li><p>Start with an empty list <var title="">L</var>.</li>
<li><p>If the <code><a href="#datatransfer">DataTransfer</a></code> object is no longer
associated with a <a href="#drag-data-store">drag data store</a>, the
- <code>FileList</code> is empty. Abort these steps; return the
+ <code><a href="#filelist">FileList</a></code> is empty. Abort these steps; return the
empty list <var title="">L</var>.</li>
<li><p>If the <a href="#drag-data-store">drag data store</a>'s <a href="#drag-data-store-mode" title="drag data
@@ -52071,7 +52084,7 @@
<li><p>For each item in the <a href="#drag-data-store-item-list">drag data store item list</a>
whose <a href="#the-drag-data-item-kind" title="the drag data item
- kind">kind</a> is <i>File</i> ,
+ kind">kind</a> is <i><a href="#file">File</a></i> ,
add the item's data (the file, in particular its name and contents,
as well as its <a href="#the-drag-data-item-type-string" title="the drag data item type
string">type</a>) to the list <var title="">L</var>.</li>
@@ -52090,7 +52103,7 @@
<a href="#dom-datatransferitems-removeitem" title="dom-DataTransferItems-removeItem">deleter</a> void (in unsigned long index);
void <a href="#dom-datatransferitems-clear" title="dom-DataTransferItems-clear">clear</a>();
- <a href="#datatransferitem">DataTransferItem</a> <a href="#dom-datatransferitems-add" title="dom-DataTransferItems-add">add</a>(in DOMString data, in DOMString type); <a href="#datatransferitem">DataTransferItem</a> <a href="#dom-datatransferitems-add" title="dom-DataTransferItems-add">add</a>(in <span>File</span> data);};</pre><dl class="domintro"><dt><var title="">items</var> . <code title="dom-DataTransferItems-length"><a href="#dom-datatransferitems-length">length</a></code></dt>
+ <a href="#datatransferitem">DataTransferItem</a> <a href="#dom-datatransferitems-add" title="dom-DataTransferItems-add">add</a>(in DOMString data, in DOMString type); <a href="#datatransferitem">DataTransferItem</a> <a href="#dom-datatransferitems-add" title="dom-DataTransferItems-add">add</a>(in <a href="#file">File</a> data);};</pre><dl class="domintro"><dt><var title="">items</var> . <code title="dom-DataTransferItems-length"><a href="#dom-datatransferitems-length">length</a></code></dt>
<dd><p>Returns the number of items in the <a href="#drag-data-store">drag data store</a>.</dd>
@@ -52225,16 +52238,16 @@
</dd>
- <dt>If the first argument to the method is a <code>File</code></dt>
+ <dt>If the first argument to the method is a <code><a href="#file">File</a></code></dt>
<dd>
<p>Add an item to the <a href="#drag-data-store-item-list">drag data store item list</a>
whose <a href="#the-drag-data-item-kind" title="the drag data item kind">kind</a> is
- <i>File</i>, whose <a href="#the-drag-data-item-type-string" title="the drag data item type
- string">type string</a> is the <code title="dom-Blob-type">type</code> of the <code>File</code>,
+ <i><a href="#file">File</a></i>, whose <a href="#the-drag-data-item-type-string" title="the drag data item type
+ string">type string</a> is the <code title="dom-Blob-type">type</code> of the <code><a href="#file">File</a></code>,
<a href="#converted-to-ascii-lowercase">converted to ASCII lowercase</a>, and whose data is the
- same as the <code>File</code>'s data.</p>
+ same as the <code><a href="#file">File</a></code>'s data.</p>
</dd>
@@ -52250,7 +52263,7 @@
<code><a href="#datatransfer">DataTransfer</a></code> object.<pre class="idl">interface <dfn id="datatransferitem">DataTransferItem</dfn> {
readonly attribute DOMString <a href="#dom-datatransferitem-kind" title="dom-DataTransferItem-kind">kind</a>;
readonly attribute DOMString <a href="#dom-datatransferitem-type" title="dom-DataTransferItem-type">type</a>;
- void <a href="#dom-datatransferitem-getasstring" title="dom-DataTransferItem-getAsString">getAsString</a>(in <a href="#functionstringcallback">FunctionStringCallback</a> callback); <span>File</span> <a href="#dom-datatransferitem-getasfile" title="dom-DataTransferItem-getAsFile">getAsFile</a>();};
+ void <a href="#dom-datatransferitem-getasstring" title="dom-DataTransferItem-getAsString">getAsString</a>(in <a href="#functionstringcallback">FunctionStringCallback</a> callback); <a href="#file">File</a> <a href="#dom-datatransferitem-getasfile" title="dom-DataTransferItem-getAsFile">getAsFile</a>();};
[Callback=FunctionOnly, NoInterfaceObject]
interface <dfn id="functionstringcallback">FunctionStringCallback</dfn> {
@@ -52281,7 +52294,7 @@
<dt><var title="">file</var> = <var title="">item</var> . <code title="dom-DataTransferItem-getAsFile"><a href="#dom-datatransferitem-getasfile">getAsFile</a></code>()</dt>
<dd>
- <p>Returns a <code>File</code> object, if <a href="#the-drag-data-item-kind">the drag data item kind</a> is <i>File</i>.</p>
+ <p>Returns a <code><a href="#file">File</a></code> object, if <a href="#the-drag-data-item-kind">the drag data item kind</a> is <i><a href="#file">File</a></i>.</p>
</dd>
@@ -52317,7 +52330,7 @@
<table><thead><tr><th> Kind <th> String
<tbody><tr><td> <i>Plain Unicode string</i> <td> "<code title="">string</code>"
- <tr><td> <i>File</i> <td> "<code title="">file</code>"
+ <tr><td> <i><a href="#file">File</a></i> <td> "<code title="">file</code>"
</table><p>The <dfn id="dom-datatransferitem-type" title="dom-DataTransferItem-type"><code>type</code></dfn> attribute
must return the empty string if the <code><a href="#datatransferitem">DataTransferItem</a></code>
object is in the <i>disabled mode</i>; otherwise it must return
@@ -52347,10 +52360,10 @@
<ol><li><p>If the <code><a href="#datatransferitem">DataTransferItem</a></code> object is not in the <i title="concept-dnd-rw"><a href="#concept-dnd-rw">read/write mode</a></i> or the <i title="concept-dnd-ro"><a href="#concept-dnd-ro">read-only mode</a></i>, return null and abort
these steps.</li>
- <li><p>If <a href="#the-drag-data-item-kind">the drag data item kind</a> is not <i>File</i>,
+ <li><p>If <a href="#the-drag-data-item-kind">the drag data item kind</a> is not <i><a href="#file">File</a></i>,
then return null and abort these steps.</li>
- <li><p>Return a new <code>File</code> object representing the
+ <li><p>Return a new <code><a href="#file">File</a></code> object representing the
actual data of the item represented by the
<code><a href="#datatransferitem">DataTransferItem</a></code> object.</p>
@@ -52572,7 +52585,7 @@
<dd>The MIME type of the file, if known, or "<code>application/octet-stream</code>" otherwise.</dd>
<dt><a href="#the-drag-data-item-kind">The drag data item kind</a>
- <dd><i>File</i></dd>
+ <dd><i><a href="#file">File</a></i></dd>
<dt>The actual data</dt>
<dd>The file's contents and name.</dd>
@@ -53246,7 +53259,7 @@
case-insensitive</a> match for the string "<code title="">f:</code>")<dt>
</dt><dd><p>Indicates that items with <a href="#the-drag-data-item-kind">the drag data item
- kind</a> <i>File</i> and <a href="#the-drag-data-item-type-string">the drag data item type
+ kind</a> <i><a href="#file">File</a></i> and <a href="#the-drag-data-item-type-string">the drag data item type
string</a> set to a value that matches the remainder of the
keyword are accepted.</dd>
@@ -53331,7 +53344,7 @@
<dd>
<p>Let <var title="">kind</var> be
- <i>File</i>.</p>
+ <i><a href="#file">File</a></i>.</p>
</dd>
Received on Thursday, 5 May 2011 00:04:43 UTC