[giow] (2) provide a .value API for <input type=file>

git-svn-id: http://svn.whatwg.org/webapps@2814 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Feb 13, 2009 · 4ded33a · 4ded33a
1 parent 1738984
commit 4ded33a
Show file tree

Hide file tree

Showing 2 changed files with 28 additions and 14 deletions.
diff --git a/index b/index
@@ -27241,7 +27241,7 @@ interface <dfn id=htmlformelement>HTMLFormElement</dfn> : <a href=#htmlelement>H
      <td class=yes> <a href=#dom-input-value-value title=dom-input-value-value>value</a> <!-- Color -->
      <td class=yes> <a href=#dom-input-value-default-on title=dom-input-value-default-on>default/on</a> <!-- Checkbox -->
 <!-- <td class="yes"> <span title="dom-input-value-default-on">default/on</span>      Radio Button -->
-     <td class=no> · <!-- File Upload -->
+     <td class=yes> <a href=#dom-input-value-filename title=dom-input-value-filename>filename</a> <!-- File Upload -->
      <td class=yes> <a href=#dom-input-value-default title=dom-input-value-default>default</a> <!-- Submit Button -->
      <td class=yes> <a href=#dom-input-value-default title=dom-input-value-default>default</a> <!-- Image Button -->
      <td class=yes> <a href=#dom-input-value-default title=dom-input-value-default>default</a> <!-- Reset Button -->
@@ -29336,6 +29336,9 @@ interface <dfn id=htmlformelement>HTMLFormElement</dfn> : <a href=#htmlelement>H
    <code title=attr-input-multiple><a href=#attr-input-multiple>multiple</a></code>, and
    <code title=attr-input-required><a href=#attr-input-required>required</a></code>.</p>
 
+   <p>The <code title=dom-input-value><a href=#dom-input-value>value</a></code> DOM attribute is
+   in mode <a href=#dom-input-value-filename title=dom-input-value-filename>filenmae</a>.</p>
+
    <p>The <code title=event-input-change><a href=#event-input-change>change</a></code> event applies.</p>
 
    <p>The following content attributes must not be specified and do not
@@ -29368,7 +29371,6 @@ interface <dfn id=htmlformelement>HTMLFormElement</dfn> : <a href=#htmlelement>H
    <code class=no-backref title=dom-input-checked><a href=#dom-input-checked>checked</a></code>,
    <code class=no-backref title=dom-input-list><a href=#dom-input-list>list</a></code>,
    <code class=no-backref title=dom-input-selectedOption><a href=#dom-input-selectedoption>selectedOption</a></code>,
-   <code class=no-backref title=dom-input-value><a href=#dom-input-value>value</a></code>,
    <code class=no-backref title=dom-input-valueAsDate><a href=#dom-input-valueasdate>valueAsDate</a></code> and
    <code class=no-backref title=dom-input-valueAsNumber><a href=#dom-input-valueasnumber>valueAsNumber</a></code> DOM attributes;
    <code class=no-backref title=dom-input-stepDown><a href=#dom-input-stepdown>stepDown()</a></code> and
@@ -30200,8 +30202,8 @@ You cannot complete this form until the field is correct.</samp></pre>
 
   <p>The <dfn id=dom-input-value title=dom-input-value><code>value</code></dfn> DOM
   attribute allows scripts to manipulate the <a href=#concept-fe-value title=concept-fe-value>value</a> of an <code><a href=#the-input-element>input</a></code>
-  element. If the attribute applies, then it is in one of the
-  following modes, which define its behavior:</p>
+  element. The attribute is in one of the following modes, which
+  define its behavior:</p>
 
   <dl>
 
@@ -30227,10 +30229,14 @@ You cannot complete this form until the field is correct.</samp></pre>
    that attribute's value; otherwise, it must return the string "<code title="">on</code>". On setting, it must set the element's <code title=attr-input-value><a href=#attr-input-value>value</a></code> attribute to the new
    value.</dd>
 
-  </dl>
+   <dt><dfn id=dom-input-value-filename title=dom-input-value-filename>filename</dfn>
+
+   <dd>On getting, it must return the string "<code title="">c:\fakepath\</code>" followed by the filename of the first
+   file in the list of <a href=#concept-input-type-file-selected title=concept-input-type-file-selected>selected files</a>, if
+   any, or the empty string if the list is empty. On setting, it must
+   throw an <code><a href=#invalid_access_err>INVALID_ACCESS_ERR</a></code> exception.</dd>
 
-  <p>If the attribute does not apply, then on getting and setting it
-  must throw an <code><a href=#invalid_access_err>INVALID_ACCESS_ERR</a></code> exception.</p>
+  </dl>
 
   <hr>
 

diff --git a/source b/source
@@ -28304,7 +28304,7 @@ interface <dfn>HTMLFormElement</dfn> : <span>HTMLElement</span> {
      <td class="yes"> <span title="dom-input-value-value">value</span> <!-- Color -->
      <td class="yes"> <span title="dom-input-value-default-on">default/on</span> <!-- Checkbox -->
 <!-- <td class="yes"> <span title="dom-input-value-default-on">default/on</span>      Radio Button -->
-     <td class="no"> &middot; <!-- File Upload -->
+     <td class="yes"> <span title="dom-input-value-filename">filename</span> <!-- File Upload -->
      <td class="yes"> <span title="dom-input-value-default">default</span> <!-- Submit Button -->
      <td class="yes"> <span title="dom-input-value-default">default</span> <!-- Image Button -->
      <td class="yes"> <span title="dom-input-value-default">default</span> <!-- Reset Button -->
@@ -30679,6 +30679,9 @@ interface <dfn>HTMLFormElement</dfn> : <span>HTMLElement</span> {
    <code title="attr-input-multiple">multiple</code>, and
    <code title="attr-input-required">required</code>.</p>
 
+   <p>The <code title="dom-input-value">value</code> DOM attribute is
+   in mode <span title="dom-input-value-filename">filenmae</span>.</p>
+
    <p>The <code title="event-input-change">change</code> event applies.</p>
 
    <p>The following content attributes must not be specified and do not
@@ -30711,7 +30714,6 @@ interface <dfn>HTMLFormElement</dfn> : <span>HTMLElement</span> {
    <code class="no-backref" title="dom-input-checked">checked</code>,
    <code class="no-backref" title="dom-input-list">list</code>,
    <code class="no-backref" title="dom-input-selectedOption">selectedOption</code>,
-   <code class="no-backref" title="dom-input-value">value</code>,
    <code class="no-backref" title="dom-input-valueAsDate">valueAsDate</code> and
    <code class="no-backref" title="dom-input-valueAsNumber">valueAsNumber</code> DOM attributes;
    <code class="no-backref" title="dom-input-stepDown">stepDown()</code> and
@@ -31680,8 +31682,8 @@ You cannot complete this form until the field is correct.</samp></pre>
   <p>The <dfn title="dom-input-value"><code>value</code></dfn> DOM
   attribute allows scripts to manipulate the <span
   title="concept-fe-value">value</span> of an <code>input</code>
-  element. If the attribute applies, then it is in one of the
-  following modes, which define its behavior:</p>
+  element. The attribute is in one of the following modes, which
+  define its behavior:</p>
 
   <dl>
 
@@ -31715,10 +31717,16 @@ You cannot complete this form until the field is correct.</samp></pre>
    title="attr-input-value">value</code> attribute to the new
    value.</dd>
 
-  </dl>
+   <dt><dfn title="dom-input-value-filename">filename</dfn>
+
+   <dd>On getting, it must return the string "<code
+   title="">c:\fakepath\</code>" followed by the filename of the first
+   file in the list of <span
+   title="concept-input-type-file-selected">selected files</span>, if
+   any, or the empty string if the list is empty. On setting, it must
+   throw an <code>INVALID_ACCESS_ERR</code> exception.</dd>
 
-  <p>If the attribute does not apply, then on getting and setting it
-  must throw an <code>INVALID_ACCESS_ERR</code> exception.</p>
+  </dl>
 
   <hr>