- From: poot <cvsmail@w3.org>
- Date: Wed, 5 Aug 2009 22:23:40 +0900 (JST)
- To: public-html-diffs@w3.org
mike: refined some more datatype descriptions
http://dev.w3.org/cvsweb/html5/markup/spec.html?r1=1.87&r2=1.88&f=h
===================================================================
RCS file: /sources/public/html5/markup/datatypes.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -d -r1.24 -r1.25
--- datatypes.html 4 Aug 2009 15:46:33 -0000 1.24
+++ datatypes.html 5 Aug 2009 13:23:16 -0000 1.25
@@ -286,16 +286,24 @@
<div id="common.data.date-or-time-mdl" class="section">
<h2 class="common-subhead">11.18. Date-or-time <a class="hash" href="#common.data.date-or-time-mdl">#</a></h2>
<div class="content-models">
- <div><span class="common-pattern-name"><dfn id="common.data.date-or-time">date-or-time</dfn></span><code class="punc"> = </code><a href="datatypes.html#form.data.date">date</a>
- | <a href="datatypes.html#form.data.time">time</a>
- | <a href="datatypes.html#common.data.datetime">datetime</a> <a href="datatypes.html#common.data.date-or-time" class="hash">#</a></div></div>
+ <div><span class="common-pattern-name"><dfn id="common.data.date-or-time">date-or-time</dfn></span><code class="punc"> = </code> <a href="datatypes.html#common.data.date-or-time" class="hash">#</a></div>
+ <div class="datatype-desc">Any one of the following:
+ <ul>
+ <li><a href="datatypes.html#form.data.date">date</a></li>
+ <li><a href="datatypes.html#form.data.time">time</a></li>
+ <li><a href="datatypes.html#common.data.datetime">datetime</a></li>
+ </ul>
+ </div>
+ </div>
</div>
<div id="common.data.uri-mdl" class="section">
<h2 class="common-subhead">11.19. URI <a class="hash" href="#common.data.uri-mdl">#</a></h2>
<div class="content-models">
- <div><span class="common-pattern-name"><dfn id="common.data.uri">uri</dfn></span><code class="punc"> = </code>"" | <a href="datatypes.html#data.iri-ref">IRI-reference</a> <a href="datatypes.html#common.data.uri" class="hash">#</a></div>
- <div class="datatype-desc">…where <dfn id="data.iri-ref">IRI-reference</dfn> is
- as defined in RFC 3987 <a href="references.html#refsRFC3987">[RFC3987]</a>.</div>
+ <div><span class="common-pattern-name"><dfn id="common.data.uri">uri</dfn></span><code class="punc"> = </code> <a href="datatypes.html#common.data.uri" class="hash">#</a></div>
+ <div class="datatype-desc">An
+ <dfn id="data.iri-ref" title="data.iri-ref">IRI-reference</dfn>,
+ as defined in RFC 3987
+ <a href="references.html#refsRFC3987">[RFC3987]</a>.</div>
<div class="example">
<p>Example:</p>
@@ -315,9 +323,11 @@
<div id="common.data.uri.absolute-mdl" class="section">
<h2 class="common-subhead">11.21. Absolute URI <a class="hash" href="#common.data.uri.absolute-mdl">#</a></h2>
<div class="content-models">
- <div><span class="common-pattern-name"><dfn id="common.data.uri.absolute">uri.absolute</dfn></span><code class="punc"> = </code>"" | <a href="datatypes.html#data.iri">IRI</a> <a href="datatypes.html#common.data.uri.absolute" class="hash">#</a></div>
- <div class="datatype-desc">…where <dfn id="data.iri">IRI</dfn> is
- as defined in RFC 3987 <a href="references.html#refsRFC3987">[RFC3987]</a>.</div>
+ <div><span class="common-pattern-name"><dfn id="common.data.uri.absolute">uri.absolute</dfn></span><code class="punc"> = </code> <a href="datatypes.html#common.data.uri.absolute" class="hash">#</a></div>
+ <div class="datatype-desc">An
+ <dfn id="data.iri">IRI</dfn>,
+ as defined in RFC 3987
+ <a href="references.html#refsRFC3987">[RFC3987]</a>.</div>
<div class="example">
<p>Examples:</p>
@@ -330,15 +340,32 @@
<div id="common.data.sizes-mdl" class="section">
<h2 class="common-subhead">11.22. Sizes <a class="hash" href="#common.data.sizes-mdl">#</a></h2>
<div class="content-models">
- <div><span class="common-pattern-name"><dfn id="common.data.sizes">sizes</dfn></span><code class="punc"> = </code><code class="regexp">[1-9][0-9]*x[1-9][0-9]*</code> <a href="datatypes.html#common.data.sizes" class="hash">#</a></div></div>
+ <div><span class="common-pattern-name"><dfn id="common.data.sizes">sizes</dfn></span><code class="punc"> = </code> <a href="datatypes.html#common.data.sizes" class="hash">#</a></div>
+ <div class="datatype-desc">An unordered set of unique
+ space-separated
+ <a href="datatypes.html#data-token">tokens</a>,
+ each of which must be one of the following:
+ <ul>
+ <li>the literal string "<code>any</code>"</li>
+ <li>two valid
+ <a href="datatypes.html#common.data.integer.non-negative">non-negative integers</a>
+ that do not have a leading
+ "<code title="U+0030 DIGIT ZERO">0</code>"
+ character and that are separated by a single
+ "<code title="U+0078 LATIN SMALL LETTER X">x</code>"
+ character.</li>
+ </ul>
+ </div>
+ </div>
</div>
<div id="common.data.mimetype-mdl" class="section">
<h2 class="common-subhead">11.23. Mimetype <a class="hash" href="#common.data.mimetype-mdl">#</a></h2>
<div class="content-models">
<div><span class="common-pattern-name"><dfn id="common.data.mimetype">mimetype</dfn></span><code class="punc"> = </code> <a href="datatypes.html#common.data.mimetype" class="hash">#</a></div>
<div class="datatype-desc">A string that identifies a valid
- <b class="defined-elsewhere">MIME media type</b>, as
- defined in RFC 2046 <a href="references.html#refsRFC2046">[RFC2046]</a>.</div> </div>
+ <dfn id="mime-media-type" title="mime-media-type">MIME media type</dfn>,
+ as defined in RFC 2046
+ <a href="references.html#refsRFC2046">[RFC2046]</a>.</div> </div>
</div>
<div id="common.data.charset-mdl" class="section">
<h2 class="common-subhead">11.24. Charset <a class="hash" href="#common.data.charset-mdl">#</a></h2>
@@ -370,10 +397,12 @@
<h2 class="common-subhead">11.26. Refresh <a class="hash" href="#common.data.refresh-mdl">#</a></h2>
<div class="content-models">
<div><span class="common-pattern-name"><dfn id="common.data.refresh">refresh</dfn></span><code class="punc"> = </code> <a href="datatypes.html#common.data.refresh" class="hash">#</a></div>
- <div class="datatype-desc">One of the following:
+ <div class="datatype-desc">Any one of the following:
<ul>
- <li>a <a href="datatypes.html#common.data.integer.non-negative">non-negative integer</a></li>
- <li>a <a href="datatypes.html#common.data.integer.non-negative">non-negative integer</a>, followed by a string that is
+ <li>a
+ <a href="datatypes.html#common.data.integer.non-negative">non-negative integer</a></li>
+ <li>a
+ <a href="datatypes.html#common.data.integer.non-negative">non-negative integer</a>, followed by a string that is
an <a href="terminology.html#ascii-case-insensitive">ASCII
case-insensitive</a> match for the regular expression
<code class="regexp">;\s+url=</code>, followed by a <a href="datatypes.html#common.data.uri">URI</a>.</li>
Index: spec.html
===================================================================
RCS file: /sources/public/html5/markup/spec.html,v
retrieving revision 1.87
retrieving revision 1.88
diff -u -d -r1.87 -r1.88
--- spec.html 4 Aug 2009 15:46:33 -0000 1.87
+++ spec.html 5 Aug 2009 13:23:16 -0000 1.88
@@ -15543,21 +15543,28 @@
</h2>
<div class="content-models">
<div>
-<span class="common-pattern-name"><dfn id="common.data.date-or-time">date-or-time</dfn></span><code class="punc"> = </code><a href="#form.data.date">date</a>
- | <a href="#form.data.time">time</a>
- | <a href="#common.data.datetime">datetime</a> <a href="#common.data.date-or-time" class="hash">#</a>
+<span class="common-pattern-name"><dfn id="common.data.date-or-time">date-or-time</dfn></span><code class="punc"> = </code> <a href="#common.data.date-or-time" class="hash">#</a>
</div>
+ <div class="datatype-desc">Any one of the following:
+ <ul>
+<li><a href="#form.data.date">date</a></li>
+ <li><a href="#form.data.time">time</a></li>
+ <li><a href="#common.data.datetime">datetime</a></li>
+ </ul>
</div>
+ </div>
</div>
<div id="common.data.uri-mdl" class="section">
<h2 class="common-subhead">11.19. URI <a class="hash" href="#common.data.uri-mdl">#</a>
</h2>
<div class="content-models">
<div>
-<span class="common-pattern-name"><dfn id="common.data.uri">uri</dfn></span><code class="punc"> = </code>"" | <a href="#data.iri-ref">IRI-reference</a> <a href="#common.data.uri" class="hash">#</a>
+<span class="common-pattern-name"><dfn id="common.data.uri">uri</dfn></span><code class="punc"> = </code> <a href="#common.data.uri" class="hash">#</a>
</div>
- <div class="datatype-desc">…where <dfn id="data.iri-ref">IRI-reference</dfn> is
- as defined in RFC 3987 <a href="#refsRFC3987">[RFC3987]</a>.</div>
+ <div class="datatype-desc">An
+ <dfn id="data.iri-ref" title="data.iri-ref">IRI-reference</dfn>,
+ as defined in RFC 3987
+ <a href="#refsRFC3987">[RFC3987]</a>.</div>
<div class="example">
<p>Example:</p>
@@ -15582,10 +15589,12 @@
</h2>
<div class="content-models">
<div>
-<span class="common-pattern-name"><dfn id="common.data.uri.absolute">uri.absolute</dfn></span><code class="punc"> = </code>"" | <a href="#data.iri">IRI</a> <a href="#common.data.uri.absolute" class="hash">#</a>
+<span class="common-pattern-name"><dfn id="common.data.uri.absolute">uri.absolute</dfn></span><code class="punc"> = </code> <a href="#common.data.uri.absolute" class="hash">#</a>
</div>
- <div class="datatype-desc">…where <dfn id="data.iri">IRI</dfn> is
- as defined in RFC 3987 <a href="#refsRFC3987">[RFC3987]</a>.</div>
+ <div class="datatype-desc">An
+ <dfn id="data.iri">IRI</dfn>,
+ as defined in RFC 3987
+ <a href="#refsRFC3987">[RFC3987]</a>.</div>
<div class="example">
<p>Examples:</p>
@@ -15600,9 +15609,24 @@
</h2>
<div class="content-models">
<div>
-<span class="common-pattern-name"><dfn id="common.data.sizes">sizes</dfn></span><code class="punc"> = </code><code class="regexp">[1-9][0-9]*x[1-9][0-9]*</code> <a href="#common.data.sizes" class="hash">#</a>
+<span class="common-pattern-name"><dfn id="common.data.sizes">sizes</dfn></span><code class="punc"> = </code> <a href="#common.data.sizes" class="hash">#</a>
</div>
+ <div class="datatype-desc">An unordered set of unique
+ space-separated
+ <a href="#data-token">tokens</a>,
+ each of which must be one of the following:
+ <ul>
+<li>the literal string "<code>any</code>"</li>
+ <li>two valid
+ <a href="#common.data.integer.non-negative">non-negative integers</a>
+ that do not have a leading
+ "<code title="U+0030 DIGIT ZERO">0</code>"
+ character and that are separated by a single
+ "<code title="U+0078 LATIN SMALL LETTER X">x</code>"
+ character.</li>
+ </ul>
</div>
+ </div>
</div>
<div id="common.data.mimetype-mdl" class="section">
<h2 class="common-subhead">11.23. Mimetype <a class="hash" href="#common.data.mimetype-mdl">#</a>
@@ -15612,8 +15636,9 @@
<span class="common-pattern-name"><dfn id="common.data.mimetype">mimetype</dfn></span><code class="punc"> = </code> <a href="#common.data.mimetype" class="hash">#</a>
</div>
<div class="datatype-desc">A string that identifies a valid
- <b class="defined-elsewhere">MIME media type</b>, as
- defined in RFC 2046 <a href="#refsRFC2046">[RFC2046]</a>.</div> </div>
+ <dfn id="mime-media-type" title="mime-media-type">MIME media type</dfn>,
+ as defined in RFC 2046
+ <a href="#refsRFC2046">[RFC2046]</a>.</div> </div>
</div>
<div id="common.data.charset-mdl" class="section">
<h2 class="common-subhead">11.24. Charset <a class="hash" href="#common.data.charset-mdl">#</a>
@@ -15654,11 +15679,13 @@
<div>
<span class="common-pattern-name"><dfn id="common.data.refresh">refresh</dfn></span><code class="punc"> = </code> <a href="#common.data.refresh" class="hash">#</a>
</div>
- <div class="datatype-desc">One of the following:
+ <div class="datatype-desc">Any one of the following:
<ul>
-<li>a <a href="#common.data.integer.non-negative">non-negative integer</a>
+<li>a
+ <a href="#common.data.integer.non-negative">non-negative integer</a>
</li>
- <li>a <a href="#common.data.integer.non-negative">non-negative integer</a>, followed by a string that is
+ <li>a
+ <a href="#common.data.integer.non-negative">non-negative integer</a>, followed by a string that is
an <a href="#ascii-case-insensitive">ASCII
case-insensitive</a> match for the regular expression
<code class="regexp">;\s+url=</code>, followed by a <a href="#common.data.uri">URI</a>.</li>
--- NEW FILE: forms-attributes.html ---
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<title>HTML5: Forms attributes</title>
<link rel="stylesheet" href="style.css" type="text/css"></link>
<link rel="stylesheet" href="W3C-ED.css" type="text/css"></link>
</head>
<body>
<h2 class="chunkpagetitle"><a href="Overview.html">HTML5: The Markup Language</a></h2>
<div class="nav">
<span class="nav-prev"><a href="common-attributes.html">« common-attributes</a></span>
<span class="nav-next"><a href="datatypes.html">datatypes »</a></span>
</div>
<div id="forms-attributes" class="section">
<h2>10. Forms attributes <a class="hash" href="#forms-attributes">#</a> <a class="toc-bak" href="Overview.html#forms-attributes-toc">T</a></h2>
<dl class="attr-defs">
<dt><dfn class="attribute-name" id="input.attrs.autocomplete" title="input.attrs.autocomplete">autocomplete</dfn> = <span class="attr-values"> "on" | "off" </span><a class="hash" href="forms-attributes.html#input.attrs.autocomplete">#</a></dt><dd>Specifies whether the element represents an input
control for which a UA is meant to store the value entered
by the user (so that the UA can prefill the form
later).</dd><dt><dfn class="attribute-name" id="shared-form.attrs.autofocus" title="shared-form.attrs.autofocus">autofocus</dfn> = <span class="attr-values"> "autofocus" | "" </span><a class="hash" href="forms-attributes.html#shared-form.attrs.autofocus">#</a></dt><dd>Specifies that the element represents a control to which
a UA is meant to give focus as soon as the document is
loaded.</dd><dt><dfn class="attribute-name" id="input.attrs.checked" title="input.attrs.checked">checked</dfn> = <span class="attr-values"> "checked" | "" </span><a class="hash" href="forms-attributes.html#input.attrs.checked">#</a></dt><dd>Specifies that the element represents a selected
control.</dd><dt><dfn class="attribute-name" id="common-form.attrs.disabled" title="common-form.attrs.disabled">disabled</dfn> = <span class="attr-values"> "disabled" | "" </span><a class="hash" href="forms-attributes.html#common-form.attrs.disabled">#</a></dt><dd>Specifies that the element represents a disabled
control.</dd><dt><dfn class="attribute-name" id="common-form.attrs.form" title="common-form.attrs.form">form</dfn> = <span class="attr-values">
<a class="ref" href="datatypes.html#common.data.idref" title="common.data.idref">idref</a>
</span><a class="hash" href="forms-attributes.html#common-form.attrs.form">#</a></dt><dd>A
<a href="form.html#form" class="form">form</a>
with which to associate the element.</dd><dt><dfn class="attribute-name" id="shared-form.attrs.formaction" title="shared-form.attrs.formaction">formaction</dfn> = <span class="attr-values">
<a class="ref" href="datatypes.html#common.data.uri" title="common.data.uri">uri</a>
</span><a class="hash" href="forms-attributes.html#shared-form.attrs.formaction">#</a></dt><dd>The form-submission action for the element.</dd><dt><dfn class="attribute-name" id="shared-form.attrs.formenctype" title="shared-form.attrs.formenctype">formenctype</dfn> = <span class="attr-values">
"application/x-www-form-urlencoded"
| "multipart/form-data"
| "text/plain"
</span><a class="hash" href="forms-attributes.html#shared-form.attrs.formenctype">#</a></dt><dd>A MIME type with which a UA is meant to associate this
element for form submission.</dd><dt><dfn class="attribute-name" id="shared-form.attrs.formmethod" title="shared-form.attrs.formmethod">formmethod</dfn> = <span class="attr-values">
"get"
| "post"
| "put"
| "delete"
</span><a class="hash" href="forms-attributes.html#shared-form.attrs.formmethod">#</a></dt><dd>The HTTP method with which a UA is meant to associate
this element for form submission.</dd><dt><dfn class="attribute-name" id="shared-form.attrs.formnovalidate" title="shared-form.attrs.formnovalidate">formnovalidate</dfn> = <span class="attr-values">
"formnovalidate" | ""
</span><a class="hash" href="forms-attributes.html#shared-form.attrs.formnovalidate">#</a></dt><dd>Specifies that the element represents a control whose
value is not meant to be validated during form
submission.</dd><dt><dfn class="attribute-name" id="shared-form.attrs.formtarget" title="shared-form.attrs.formtarget">formtarget</dfn> = <span class="attr-values">
<a class="ref" href="datatypes.html#common.data.browsing-context-name-or-keyword" title="common.data.browsing-context-name-or-keyword">browsing-context-name-or-keyword</a>
</span><a class="hash" href="forms-attributes.html#shared-form.attrs.formtarget">#</a></dt><dd>A browsing context or keyword that represents the target
of the control.</dd><dt><dfn class="attribute-name" id="input.attrs.list" title="input.attrs.list">list</dfn> = <span class="attr-values">
<a class="ref" href="datatypes.html#common.data.idref" title="common.data.idref">idref</a>
</span><a class="hash" href="forms-attributes.html#input.attrs.list">#</a></dt><dd>Specifies a
<a href="datalist.html#datalist" class="element">datalist</a>
with which to associate the element.</dd><dt><dfn class="attribute-name" id="shared-form.attrs.maxlength" title="shared-form.attrs.maxlength">maxlength</dfn> = <span class="attr-values">
<a class="ref" href="datatypes.html#common.data.integer.positive" title="common.data.integer.positive">integer.positive</a>
</span><a class="hash" href="forms-attributes.html#shared-form.attrs.maxlength">#</a></dt><dd>The maximum allowed value length of the element.</dd><dt><dfn class="attribute-name" id="input.attrs.multiple" title="input.attrs.multiple">multiple</dfn> = <span class="attr-values"> "multiple" | "" </span><a class="hash" href="forms-attributes.html#input.attrs.multiple">#</a></dt><dd>Specifies that the element allows multiple values.</dd><dt><dfn class="attribute-name" id="common-form.attrs.name" title="common-form.attrs.name">name</dfn> = <span class="attr-values"> string </span><a class="hash" href="forms-attributes.html#common-form.attrs.name">#</a></dt><dd>The name part of the name/value pair associated with this
element for the purposes of form submission.</dd><dt><dfn class="attribute-name" id="shared-form.attrs.pattern" title="shared-form.attrs.pattern">pattern</dfn> = <span class="attr-values">
<a class="ref" href="datatypes.html#form.data.pattern" title="form.data.pattern">pattern</a>
</span><a class="hash" href="forms-attributes.html#shared-form.attrs.pattern">#</a></dt><dd>Specifies a regular expression against which a UA is
meant to check the value of the control represented by its
element.</dd><dt><dfn class="attribute-name" id="shared-form.attrs.placeholder" title="shared-form.attrs.placeholder">placeholder</dfn> = <span class="attr-values"> string </span><a class="hash" href="forms-attributes.html#shared-form.attrs.placeholder">#</a></dt><dd>A short hint (one word or a short phrase) intended to
aid the user when entering data into the control
represented by its element.</dd><dt><dfn class="attribute-name" id="shared-form.attrs.readonly" title="shared-form.attrs.readonly">readonly</dfn> = <span class="attr-values"> "readonly" | "" </span><a class="hash" href="forms-attributes.html#shared-form.attrs.readonly">#</a></dt><dd>Specifies that element represents a control whose value
is not meant to be edited.</dd><dt><dfn class="attribute-name" id="shared-form.attrs.required" title="shared-form.attrs.required">required</dfn> = <span class="attr-values"> "required" | "" </span><a class="hash" href="forms-attributes.html#shared-form.attrs.required">#</a></dt><dd>Specifies that the element is a required part of form
submission.</dd><dt><dfn class="attribute-name" id="shared-form.attrs.size" title="shared-form.attrs.size">size</dfn> = <span class="attr-values">
<a class="ref" href="datatypes.html#common.data.integer.positive" title="common.data.integer.positive">integer.positive</a>
</span><a class="hash" href="forms-attributes.html#shared-form.attrs.size">#</a></dt><dd>The number of options meant to be shown by the control
represented by its element.</dd><dt><dfn class="attribute-name" id="input.attrs.step.float" title="input.attrs.step.float">step<span class="attr-qualifier">.float</span></dfn> = <span class="attr-values">
"any"
| <a class="ref" href="datatypes.html#common.data.float.positive" title="common.data.float.positive">float.positive</a>
</span><a class="hash" href="forms-attributes.html#input.attrs.step.float">#</a></dt><dd>Specifies the value granularity of the element’s
value.</dd><dt><dfn class="attribute-name" id="input.attrs.step.integer" title="input.attrs.step.integer">step<span class="attr-qualifier">.integer</span></dfn> = <span class="attr-values">
"any"
| <a class="ref" href="datatypes.html#common.data.integer.positive" title="common.data.integer.positive">integer.positive</a>
</span><a class="hash" href="forms-attributes.html#input.attrs.step.integer">#</a></dt><dd>Specifies the value granularity of the element’s
value.</dd>
</dl>
</div>
<hr class="footerbreak"></hr>
<div class="nav">
<span class="nav-prev"><a href="common-attributes.html">« common-attributes</a></span>
<span class="nav-next"><a href="datatypes.html">datatypes »</a></span>
</div>
</body>
</html>
Received on Wednesday, 5 August 2009 13:24:20 UTC