Make <input type=file>.files settable

annevk · web-flow · commit 5dc7db210865 · 2017-08-02T14:53:19.000+02:00
Tests: web-platform-tests/wpt#6617. Fixes whatwg#2861.
diff --git a/source b/source
@@ -43257,7 +43257,7 @@ interface <dfn>HTMLInputElement</dfn> : <span>HTMLElement</span> {
   [<span>CEReactions</span>] attribute DOMString <span data-x="dom-input-dirName">dirName</span>;
   [<span>CEReactions</span>] attribute boolean <span data-x="dom-fe-disabled">disabled</span>;
   readonly attribute <span>HTMLFormElement</span>? <span data-x="dom-fae-form">form</span>;
-  readonly attribute <span>FileList</span>? <span data-x="dom-input-files">files</span>;
+  attribute <span>FileList</span>? <span data-x="dom-input-files">files</span>;
   [<span>CEReactions</span>] attribute USVString <span data-x="dom-fs-formAction">formAction</span>;
   [<span>CEReactions</span>] attribute DOMString <span data-x="dom-fs-formEnctype">formEnctype</span>;
   [<span>CEReactions</span>] attribute DOMString <span data-x="dom-fs-formMethod">formMethod</span>;
@@ -48953,7 +48953,7 @@ You cannot submit this form when the field is incorrect.</samp></pre>
 
    </dd>
 
-   <dt><var>input</var> . <code subdfn data-x="dom-input-files">files</code> <!-- [ = <var>files</var> ] --></dt>
+   <dt><var>input</var> . <code subdfn data-x="dom-input-files">files</code> [ = <var>files</var> ]</dt>
 
    <dd>
 
@@ -48962,9 +48962,9 @@ You cannot submit this form when the field is incorrect.</samp></pre>
 
     <p>Returns null if the control isn't a file control.</p>
 
-<!--
-    <p>Can be set to an array of <code>File</code> or <code>Blob</code> instances.</p>-
--->
+    <p>Can be set to a <code>FileList</code> object to change the <span
+    data-x="concept-input-type-file-selected">selected files</span> of the form control. For
+    instance, as the result of a drag-and-drop operation.</p>
 
    </dd>
 
@@ -49118,13 +49118,26 @@ You cannot submit this form when the field is incorrect.</samp></pre>
   <hr>
 
   <p>The <dfn><code data-x="dom-input-files">files</code></dfn> IDL attribute allows scripts to
-  access the element's <span data-x="concept-input-type-file-selected">selected files</span>. On
-  getting, if the IDL attribute <span data-x="concept-input-apply">applies</span>, it must return a
-  <code>FileList</code> object that represents the current <span
+  access the element's <span data-x="concept-input-type-file-selected">selected files</span>.
+
+  <p>On getting, if the IDL attribute <span data-x="concept-input-apply">applies</span>, it must
+  return a <code>FileList</code> object that represents the current <span
   data-x="concept-input-type-file-selected">selected files</span>. The same object must be returned
-  until the list of <span data-x="concept-input-type-file-selected">selected files</span> changes. If
-  the IDL attribute <span data-x="do not apply">does not apply</span>, then it must instead return
-  null. <ref spec=FILEAPI></p>
+  until the list of <span data-x="concept-input-type-file-selected">selected files</span> changes.
+  If the IDL attribute <span data-x="do not apply">does not apply</span>, then it must instead
+  return null. <ref spec=FILEAPI></p>
+
+  <p>On setting, it must run these steps:
+
+  <ol>
+   <li><p>If the IDL attribute <span data-x="do not apply">does not apply</span> or the given value
+   is null, then return.</p></li>
+   <!-- This is inconsistent with other attributes, but Chrome and Safari already shipped so doesn't
+        seem worth the churn. -->
+
+   <li><p>Replace the element's <span data-x="concept-input-type-file-selected">selected
+   files</span> with the given value.</p></li>
+  </ol>
 
   <hr>
 
