[html5] r6075 - [e] (0) add explicit dependency on File API spec Fixing http://www.w3.org/Bugs/P [...]
whatwg at whatwg.org
whatwg at whatwg.org
Wed May 4 17:00:58 PDT 2011
Author: ianh
Date: 2011-05-04 17:00:57 -0700 (Wed, 04 May 2011)
New Revision: 6075
Modified:
complete.html
index
source
Log:
[e] (0) add explicit dependency on File API spec
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=12153
Modified: complete.html
===================================================================
--- complete.html 2011-05-04 23:54:38 UTC (rev 6074)
+++ complete.html 2011-05-05 00:00:57 UTC (rev 6075)
@@ -239,7 +239,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1>Web Applications 1.0</h1>
- <h2 class="no-num no-toc">Living Standard — Last Updated 4 May 2011</h2>
+ <h2 class="no-num no-toc">Living Standard — Last Updated 5 May 2011</h2>
</hgroup><p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
<p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
<!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->
@@ -3402,6 +3402,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>
@@ -8210,17 +8223,17 @@
<code title=dom-canvaspixelarray-length><a href=#dom-canvaspixelarray-length>length</a></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>
@@ -41549,7 +41562,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>;
@@ -46833,7 +46846,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>
@@ -46954,7 +46967,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>
@@ -70118,7 +70131,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>
@@ -70256,7 +70269,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>
@@ -70359,7 +70372,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>
@@ -70459,7 +70472,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>
@@ -70578,18 +70591,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
@@ -70598,7 +70611,7 @@
<li><p>For each item in the <a href=#drag-data-store-item-list>drag data store item list</a>
<!-- in some order...? --> whose <a href=#the-drag-data-item-kind title="the drag data item
- kind">kind</a> is <i>File</i> <!-- DND-v3: (not <i>Blob</i>) -->,
+ kind">kind</a> is <i><a href=#file>File</a></i> <!-- DND-v3: (not <i>Blob</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>
@@ -70626,7 +70639,7 @@
<a href=#datatransferitem>DataTransferItem</a> <a href=#dom-datatransferitems-add title=dom-DataTransferItems-add>add</a>(in DOMString data, in DOMString type);<!--
DND-v3: <span>DataTransferItem</span> <span title="dom-DataTransferItems-add">add</span>(in <span>Blob</span> data);-->
- <a href=#datatransferitem>DataTransferItem</a> <a href=#dom-datatransferitems-add title=dom-DataTransferItems-add>add</a>(in <span>File</span> data);<!--
+ <a href=#datatransferitem>DataTransferItem</a> <a href=#dom-datatransferitems-add title=dom-DataTransferItems-add>add</a>(in <a href=#file>File</a> data);<!--
DND-v4: <span>DataTransferItem</span> <span title="dom-DataTransferItems-add">add</span>(in any data, in DOMString type);--><!--
DND-v5: <span>DataTransferItem</span> <span title="dom-DataTransferItems-add">add</span>(in <span>DataTransferPromise</span> data);-->
};</pre>
@@ -70781,16 +70794,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>
@@ -70831,7 +70844,7 @@
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);<!--
DND-v3: <span>Blob</span> <span title="dom-DataTransferItem-getAsBlob">getAsBlob</span>();-->
- <span>File</span> <a href=#dom-datatransferitem-getasfile title=dom-DataTransferItem-getAsFile>getAsFile</a>();<!--
+ <a href=#file>File</a> <a href=#dom-datatransferitem-getasfile title=dom-DataTransferItem-getAsFile>getAsFile</a>();<!--
DND-v4: void <span title="dom-DataTransferItem-getAsObject">getAsObject</span>(in <span>FunctionObjectCallback</span> callback);-->
};
@@ -70880,7 +70893,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>
@@ -70925,7 +70938,7 @@
<table><thead><tr><th> Kind <th> String
<tbody><tr><td> <i>Plain Unicode string</i> <td> "<code title="">string</code>"
<!-- DND-v3: <tr> <td> <i>Blob</i> <td> "<code title="">blob</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>"
<!-- DND-v4: <tr> <td> <i>Object</i> <td> "<code title="">object</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>
@@ -70997,10 +71010,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>
@@ -71278,7 +71291,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>
@@ -72011,7 +72024,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>
@@ -72118,7 +72131,7 @@
<dd>
<p>Let <var title="">kind<!--DND-v3:/DND-v4: s--></var> be
- <i>File</i>.</p>
+ <i><a href=#file>File</a></i>.</p>
</dd>
@@ -73651,15 +73664,15 @@
[Callback=FunctionOnly, NoInterfaceObject]
interface <dfn id=blobcallback>BlobCallback</dfn> {
- void <span title=dom-BlobCallback-handleEvent>handleEvent</span>(in <span>Blob</span> blob);
+ void <span title=dom-BlobCallback-handleEvent>handleEvent</span>(in <a href=#blob>Blob</a> blob);
};</pre>
<dl class=domintro><dt><var title="">recorder</var> . <code title=dom-StreamRecorder-getRecordedData><a href=#dom-streamrecorder-getrecordeddata>getRecordedData</a></code>(<var title="">callback</var>)</dt>
<dd>
- <p>Creates a <code>Blob</code> of the recorded data, and invokes
- the provided callback with that <code>Blob</code>.</p>
+ <p>Creates a <code><a href=#blob>Blob</a></code> of the recorded data, and invokes
+ the provided callback with that <code><a href=#blob>Blob</a></code>.</p>
</dd>
@@ -73687,7 +73700,7 @@
a format supported by the user agent for use in <code><a href=#the-audio-element>audio</a></code>
and <code><a href=#the-video-element>video</a></code> elements.</li>
- <li><p>Let <var title="">blob</var> be a <code>Blob</code> object
+ <li><p>Let <var title="">blob</var> be a <code><a href=#blob>Blob</a></code> object
representing the contents of the file generated in the previous
step. <a href=#refsFILEAPI>[FILEAPI]</a></p>
@@ -73788,7 +73801,7 @@
<p class=bookkeeping>A <dfn id=blob-url>Blob URL</dfn> is the same as what the
File API specification calls a <span>Blob URI</span>, except that
anything in the definition of that feature that refers to
- <code>File</code> and <code>Blob</code> objects is hereby extended
+ <code><a href=#file>File</a></code> and <code><a href=#blob>Blob</a></code> objects is hereby extended
to also apply to <code><a href=#stream>Stream</a></code> and
<code><a href=#generatedstream>GeneratedStream</a></code> objects.</p>
Modified: index
===================================================================
--- index 2011-05-04 23:54:38 UTC (rev 6074)
+++ index 2011-05-05 00:00:57 UTC (rev 6075)
@@ -243,7 +243,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
- <h2 class="no-num no-toc">Living Standard — Last Updated 4 May 2011</h2>
+ <h2 class="no-num no-toc">Living Standard — Last Updated 5 May 2011</h2>
</hgroup><p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
<p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
<!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->
@@ -3427,6 +3427,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>
@@ -8235,17 +8248,17 @@
<code title=dom-canvaspixelarray-length><a href=#dom-canvaspixelarray-length>length</a></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>
@@ -41577,7 +41590,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>;
@@ -46861,7 +46874,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>
@@ -46982,7 +46995,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>
@@ -70172,7 +70185,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>
@@ -70310,7 +70323,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>
@@ -70413,7 +70426,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>
@@ -70513,7 +70526,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>
@@ -70632,18 +70645,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
@@ -70652,7 +70665,7 @@
<li><p>For each item in the <a href=#drag-data-store-item-list>drag data store item list</a>
<!-- in some order...? --> whose <a href=#the-drag-data-item-kind title="the drag data item
- kind">kind</a> is <i>File</i> <!-- DND-v3: (not <i>Blob</i>) -->,
+ kind">kind</a> is <i><a href=#file>File</a></i> <!-- DND-v3: (not <i>Blob</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>
@@ -70680,7 +70693,7 @@
<a href=#datatransferitem>DataTransferItem</a> <a href=#dom-datatransferitems-add title=dom-DataTransferItems-add>add</a>(in DOMString data, in DOMString type);<!--
DND-v3: <span>DataTransferItem</span> <span title="dom-DataTransferItems-add">add</span>(in <span>Blob</span> data);-->
- <a href=#datatransferitem>DataTransferItem</a> <a href=#dom-datatransferitems-add title=dom-DataTransferItems-add>add</a>(in <span>File</span> data);<!--
+ <a href=#datatransferitem>DataTransferItem</a> <a href=#dom-datatransferitems-add title=dom-DataTransferItems-add>add</a>(in <a href=#file>File</a> data);<!--
DND-v4: <span>DataTransferItem</span> <span title="dom-DataTransferItems-add">add</span>(in any data, in DOMString type);--><!--
DND-v5: <span>DataTransferItem</span> <span title="dom-DataTransferItems-add">add</span>(in <span>DataTransferPromise</span> data);-->
};</pre>
@@ -70835,16 +70848,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>
@@ -70885,7 +70898,7 @@
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);<!--
DND-v3: <span>Blob</span> <span title="dom-DataTransferItem-getAsBlob">getAsBlob</span>();-->
- <span>File</span> <a href=#dom-datatransferitem-getasfile title=dom-DataTransferItem-getAsFile>getAsFile</a>();<!--
+ <a href=#file>File</a> <a href=#dom-datatransferitem-getasfile title=dom-DataTransferItem-getAsFile>getAsFile</a>();<!--
DND-v4: void <span title="dom-DataTransferItem-getAsObject">getAsObject</span>(in <span>FunctionObjectCallback</span> callback);-->
};
@@ -70934,7 +70947,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>
@@ -70979,7 +70992,7 @@
<table><thead><tr><th> Kind <th> String
<tbody><tr><td> <i>Plain Unicode string</i> <td> "<code title="">string</code>"
<!-- DND-v3: <tr> <td> <i>Blob</i> <td> "<code title="">blob</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>"
<!-- DND-v4: <tr> <td> <i>Object</i> <td> "<code title="">object</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>
@@ -71051,10 +71064,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>
@@ -71332,7 +71345,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>
@@ -72065,7 +72078,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>
@@ -72172,7 +72185,7 @@
<dd>
<p>Let <var title="">kind<!--DND-v3:/DND-v4: s--></var> be
- <i>File</i>.</p>
+ <i><a href=#file>File</a></i>.</p>
</dd>
@@ -73705,15 +73718,15 @@
[Callback=FunctionOnly, NoInterfaceObject]
interface <dfn id=blobcallback>BlobCallback</dfn> {
- void <span title=dom-BlobCallback-handleEvent>handleEvent</span>(in <span>Blob</span> blob);
+ void <span title=dom-BlobCallback-handleEvent>handleEvent</span>(in <a href=#blob>Blob</a> blob);
};</pre>
<dl class=domintro><dt><var title="">recorder</var> . <code title=dom-StreamRecorder-getRecordedData><a href=#dom-streamrecorder-getrecordeddata>getRecordedData</a></code>(<var title="">callback</var>)</dt>
<dd>
- <p>Creates a <code>Blob</code> of the recorded data, and invokes
- the provided callback with that <code>Blob</code>.</p>
+ <p>Creates a <code><a href=#blob>Blob</a></code> of the recorded data, and invokes
+ the provided callback with that <code><a href=#blob>Blob</a></code>.</p>
</dd>
@@ -73741,7 +73754,7 @@
a format supported by the user agent for use in <code><a href=#the-audio-element>audio</a></code>
and <code><a href=#the-video-element>video</a></code> elements.</li>
- <li><p>Let <var title="">blob</var> be a <code>Blob</code> object
+ <li><p>Let <var title="">blob</var> be a <code><a href=#blob>Blob</a></code> object
representing the contents of the file generated in the previous
step. <a href=#refsFILEAPI>[FILEAPI]</a></p>
@@ -73842,7 +73855,7 @@
<p class=bookkeeping>A <dfn id=blob-url>Blob URL</dfn> is the same as what the
File API specification calls a <span>Blob URI</span>, except that
anything in the definition of that feature that refers to
- <code>File</code> and <code>Blob</code> objects is hereby extended
+ <code><a href=#file>File</a></code> and <code><a href=#blob>Blob</a></code> objects is hereby extended
to also apply to <code><a href=#stream>Stream</a></code> and
<code><a href=#generatedstream>GeneratedStream</a></code> objects.</p>
Modified: source
===================================================================
--- source 2011-05-04 23:54:38 UTC (rev 6074)
+++ source 2011-05-05 00:00:57 UTC (rev 6075)
@@ -2399,6 +2399,23 @@
</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>Blob</dfn></li>
+ <li><dfn>File</dfn></li>
+ <li><dfn>FileList</dfn></li>
+
+ </ul>
+
+ </dd>
+
<dt>Web IDL</dt>
<dd>
More information about the Commit-Watchers
mailing list