- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 05 May 2011 19:26:59 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv3702
Modified Files:
Overview.html
Log Message:
Add a link to the fakepath example from the fakepath impl requirement. (whatwg r6083)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4886
retrieving revision 1.4887
diff -u -d -r1.4886 -r1.4887
--- Overview.html 5 May 2011 08:36:47 -0000 1.4886
+++ Overview.html 5 May 2011 19:26:54 -0000 1.4887
@@ -34323,7 +34323,7 @@
<p>User agents should prevent the user from selecting files that are
not accepted by one (or more) of these tokens.</p>
- </div><div class="example">
+ </div><div class="example" id="fakepath-srsly">
<p>For historical reasons, the <code title="dom-input-value"><a href="#dom-input-value">value</a></code> IDL attribute prefixes the
filename with the string "<code title="">C:\fakepath\</code>". Some
@@ -35571,34 +35571,56 @@
<dl><dt><dfn id="dom-input-value-value" title="dom-input-value-value">value</dfn>
- <dd>On getting, it must return the current <a href="#concept-fe-value" title="concept-fe-value">value</a> of the element. On setting,
- it must set the element's <a href="#concept-fe-value" title="concept-fe-value">value</a> to the new value, set the
- element's <a href="#concept-input-value-dirty-flag" title="concept-input-value-dirty-flag">dirty value
- flag</a> to true, and then invoke the <a href="#value-sanitization-algorithm">value sanitization
- algorithm</a>, if the element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute's current state
- defines one.</dd>
+ <dd>
+
+ <p>On getting, it must return the current <a href="#concept-fe-value" title="concept-fe-value">value</a> of the element. On setting,
+ it must set the element's <a href="#concept-fe-value" title="concept-fe-value">value</a> to the new value, set the
+ element's <a href="#concept-input-value-dirty-flag" title="concept-input-value-dirty-flag">dirty value
+ flag</a> to true, and then invoke the <a href="#value-sanitization-algorithm">value sanitization
+ algorithm</a>, if the element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute's current state
+ defines one.</p>
+
+ </dd>
<dt><dfn id="dom-input-value-default" title="dom-input-value-default">default</dfn>
- <dd>On getting, if the element has a <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute, it must return
- that attribute's value; otherwise, it must return the empty
- string. 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>
+ <dd>
+
+ <p>On getting, if the element has a <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute, it must return
+ that attribute's value; otherwise, it must return the empty
+ string. 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.</p>
+
+ </dd>
<dt><dfn id="dom-input-value-default-on" title="dom-input-value-default-on">default/on</dfn>
- <dd>On getting, if the element has a <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute, it must return
- 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>
+ <dd>
+
+ <p>On getting, if the element has a <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute, it must return
+ 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.</p>
+
+ </dd>
<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, if the
- new value is the empty string, it must empty the list of <a href="#concept-input-type-file-selected" title="concept-input-type-file-selected">selected files</a>;
- otherwise, it must throw an <code><a href="#invalid_state_err">INVALID_STATE_ERR</a></code>
- exception.</dd>
+ <dd id="fakepath-orly">
+
+ <p>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, if the
+ new value is the empty string, it must empty the list of <a href="#concept-input-type-file-selected" title="concept-input-type-file-selected">selected files</a>;
+ otherwise, it must throw an <code><a href="#invalid_state_err">INVALID_STATE_ERR</a></code>
+ exception.</p>
+
+ <p class="note">This "fakepath" requirement is a sad accident of
+ history. See <a href="#fakepath-srsly">the example in the File
+ Upload state section</a> for more information.</p>
+
+ </dd>
</dl><hr><p>The <dfn id="dom-input-checked" title="dom-input-checked"><code>checked</code></dfn> IDL
attribute allows scripts to manipulate the <a href="#concept-fe-checked" title="concept-fe-checked">checkedness</a> of an
Received on Thursday, 5 May 2011 19:27:02 UTC