- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Sun, 07 Sep 2008 11:14:12 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec In directory hutz:/tmp/cvs-serv14384 Modified Files: Overview.html Log Message: WF2: Defining form=, .form, and the form element pointer. Also, s/initialise/initialize/. (whatwg r2157) Index: Overview.html =================================================================== RCS file: /sources/public/html5/spec/Overview.html,v retrieving revision 1.1329 retrieving revision 1.1330 diff -u -d -r1.1329 -r1.1330 --- Overview.html 7 Sep 2008 09:48:13 -0000 1.1329 +++ Overview.html 7 Sep 2008 11:14:09 -0000 1.1330 @@ -6321,7 +6321,7 @@ available. <li> - <p>Initialise <var title="">pos</var> to 0. + <p>Initialize <var title="">pos</var> to 0. <li> <p>If <span><var title="">s</var>[0]</span> is 0xEF, <span><var @@ -26574,6 +26574,8 @@ <dd><a href="#flow-content0">Flow content</a>. + <dd><a href="#form-associated">Form-associated element</a>. + <dt>Contexts in which this element may be used: <dd>Where <a href="#flow-content0">flow content</a> is expected. @@ -26586,7 +26588,7 @@ <dd><code title=attr-fieldset-disabled>disabled</code> - <dd><code title=attr-fieldset-form>form</code> + <dd><code title=attr-fae-form><a href="#form0">form</a></code> <dt>DOM interface: @@ -26594,7 +26596,7 @@ <pre class=idl>interface <dfn id=htmlfieldsetelement>HTMLFieldSetElement</dfn> : <a href="#htmlelement">HTMLElement</a> { attribute DOMString <span title=dom-fieldset-disabled>disabled</span>; - readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <span title=dom-fieldset-form>form</span>; + readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <span title=dom-fae-form>form</span>; readonly attribute DOMString <span title=dom-select-type>type</span>; @@ -26620,6 +26622,8 @@ <dd><a href="#interactive1">Interactive content</a>. + <dd><a href="#form-associated">Form-associated element</a>. + <dt>Contexts in which this element may be used: <dd>Where <a href="#phrasing0">phrasing content</a> is expected. @@ -26646,7 +26650,7 @@ <dd><code title=attr-input-enctype>enctype</code> - <dd><code title=attr-input-form>form</code> + <dd><code title=attr-fae-form><a href="#form0">form</a></code> <dd><code title=attr-input-inputmode>inputmode</code> @@ -26694,7 +26698,7 @@ attribute boolean <span title=dom-input-checked>checked</span>; attribute boolean <span title=dom-input-disabled>disabled</span>; attribute DOMString <span title=dom-input-enctype>enctype</span>; - readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <span title=dom-input-form>form</span>; + readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <span title=dom-fae-form>form</span>; attribute DOMString <span title=dom-input-inputmode>inputmode</span>; readonly attribute <a href="#htmlelement">HTMLElement</a> <span title=dom-input-list>list</span>; attribute DOMString <span title=dom-input-max>max</span>; @@ -26745,6 +26749,8 @@ <dd><a href="#interactive1">Interactive content</a>. + <dd><a href="#form-associated">Form-associated element</a>. + <dt>Contexts in which this element may be used: <dd>Where <a href="#phrasing0">phrasing content</a> is expected. @@ -26763,7 +26769,7 @@ <dd><code title=attr-button-enctype>enctype</code> - <dd><code title=attr-button-form>form</code> + <dd><code title=attr-fae-form><a href="#form0">form</a></code> <dd><code title=attr-button-method>method</code> @@ -26784,7 +26790,7 @@ attribute boolean <span title=dom-button-autofocus>autofocus</span>; attribute boolean <span title=dom-button-disabled>disabled</span>; attribute DOMString <span title=dom-button-enctype>enctype</span>; - readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <span title=dom-button-form>form</span>; + readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <span title=dom-fae-form>form</span>; attribute DOMString <span title=dom-button-method>method</span>; attribute DOMString <span title=dom-button-name>name</span>; attribute DOMString <span title=dom-button-target>target</span>; @@ -26813,6 +26819,8 @@ <dd><a href="#interactive1">Interactive content</a>. + <dd><a href="#form-associated">Form-associated element</a>. + <dt>Contexts in which this element may be used: <dd>Where <a href="#phrasing0">phrasing content</a> is expected. @@ -26823,7 +26831,7 @@ <dt>Element-specific attributes: - <dd><code title=attr-label-form>form</code> + <dd><code title=attr-fae-form><a href="#form0">form</a></code> <dd><code title=attr-label-for>for</code> @@ -26832,7 +26840,7 @@ <dd> <pre class=idl>interface <dfn id=htmllabelelement>HTMLLabelElement</dfn> : <a href="#htmlelement">HTMLElement</a> { - readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <span title=dom-label-form>form</span>; + readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <span title=dom-fae-form>form</span>; attribute DOMString <span title=dom-label-htmlFor>htmlFor</span>; readonly attribute <a href="#htmlelement">HTMLElement</a> <span title=dom-label-control>control</span>; };</pre> @@ -26850,6 +26858,8 @@ <dd><a href="#interactive1">Interactive content</a>. + <dd><a href="#form-associated">Form-associated element</a>. + <dt>Contexts in which this element may be used: <dd>Where <a href="#phrasing0">phrasing content</a> is expected. @@ -26865,7 +26875,7 @@ <dd><code title=attr-select-disabled>disabled</code> - <dd><code title=attr-select-form>form</code> + <dd><code title=attr-fae-form><a href="#form0">form</a></code> <dd><code title=attr-select-multiple>multiple</code> @@ -26880,7 +26890,7 @@ class=idl>interface <dfn id=htmlselectelement>HTMLSelectElement</dfn> : <a href="#htmlelement">HTMLElement</a> { attribute boolean <span title=dom-select-autofocus>autofocus</span>; attribute boolean <span title=dom-select-disabled>disabled</span>; - readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <span title=dom-select-form>form</span>; + readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <span title=dom-fae-form>form</span>; attribute boolean <span title=dom-select-multiple>multiple</span>; attribute DOMString <span title=dom-select-name>name</span>; attribute boolean <span title=dom-select-size>size</span>; @@ -27051,6 +27061,8 @@ <dd><a href="#interactive1">Interactive content</a>. + <dd><a href="#form-associated">Form-associated element</a>. + <dt>Contexts in which this element may be used: <dd>Where <a href="#phrasing0">phrasing content</a> is expected. @@ -27069,7 +27081,7 @@ <dd><code title=attr-textarea-disabled>disabled</code> - <dd><code title=attr-textarea-form>form</code> + <dd><code title=attr-fae-form><a href="#form0">form</a></code> <dd><code title=attr-textarea-inputmode>inputmode</code> @@ -27096,7 +27108,7 @@ attribute boolean <span title=dom-textarea-autofocus>autofocus</span>; attribute unsigned long <span title=dom-textarea-cols>cols</span>; attribute boolean <span title=dom-textarea-disabled>disabled</span>; - readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <span title=dom-textarea-form>form</span>; + readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <span title=dom-fae-form>form</span>; attribute DOMString <span title=dom-textarea-inputmode>inputmode</span>; attribute long <span title=dom-textarea-maxLength>maxLength</span>; attribute DOMString <span title=dom-textarea-name>name</span>; @@ -27134,6 +27146,8 @@ <dd><a href="#phrasing0">Phrasing content</a>. + <dd><a href="#form-associated">Form-associated element</a>. + <dt>Contexts in which this element may be used: <dd>Where <a href="#phrasing0">phrasing content</a> is expected. @@ -27146,7 +27160,7 @@ <dd><code title=attr-output-for>for</code> - <dd><code title=attr-output-form>form</code> + <dd><code title=attr-fae-form><a href="#form0">form</a></code> <dd><code title=attr-output-name>name</code> @@ -27156,7 +27170,7 @@ <pre class=idl>interface <dfn id=htmloutputelement>HTMLOutputElement</dfn> : <a href="#htmlelement">HTMLElement</a> { attribute DOMString <span title=dom-output-wrap>htmlFor</span>; - readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <span title=dom-output-form>form</span>; + readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <span title=dom-fae-form>form</span>; attribute DOMString <span title=dom-output-name>name</span>; readonly attribute DOMString <span title=dom-output-type>type</span>; @@ -27175,9 +27189,101 @@ <h4 id=association><span class=secno>4.9.12 </span>Association of controls and forms</h4> + <!-- XXX consider xreffing the 'ID' term in this section --> - <p class=big-issue>When an element is <dfn id=associated - title=concept-form-association>associated with a form</dfn>, ... + <p>A <dfn id=form-associated>form-associated element</dfn> is one that can + have a relationship with a <code><a href="#form">form</a></code> element, + which is called the element's <dfn id=form-owner>form owner</dfn>. + + <p>A <a href="#form-associated">form-associated element</a> is, by default, + associated with its nearest ancestor <code><a href="#form">form</a></code> + element (as described below), but may have a <dfn id=form0 + title=attr-fae-form><code>form</code></dfn> attribute specified to + override this. + + <p>If a <a href="#form-associated">form-associated element</a> has a <code + title=attr-fae-form><a href="#form0">form</a></code> attribute specified, + then its value must be the ID of a <code><a href="#form">form</a></code> + element in the element's owner <code>Document</code>. + + <p>When a <a href="#form-associated">form-associated element</a> is + created, its <a href="#form-owner">form owner</a> must be initialized to + null (no owner). + + <p>When a <a href="#form-associated">form-associated element</a> is to be + <dfn id=associated title=concept-form-association>associated</dfn> with a + form, its <a href="#form-owner">form owner</a> must be set to that form. + + <p>When a <a href="#form-associated">form-associated element</a>'s ancestor + chain changes, e.g. because it or one of its ancestors was inserted or + removed from a <code>Document</code>, then the user agent must <a + href="#reset">reset the form owner</a> of that element. + + <p>When a <a href="#form-associated">form-associated element</a>'s <code + title=attr-fae-form><a href="#form0">form</a></code> attribute is added, + removed, or has its value changed, then the user agent must <a + href="#reset">reset the form owner</a> of that element. + + <p>When a <a href="#form-associated">form-associated element</a> has a + <code title=attr-fae-form><a href="#form0">form</a></code> attribute and + the ID of any of the <code><a href="#form">form</a></code> elements in the + <code>Document</code> changes, then the user agent must <a + href="#reset">reset the form owner</a> of that <a + href="#form-associated">form-associated element</a>. + + <p>When the user agent is to <dfn id=reset>reset the form owner</dfn> of a + <a href="#form-associated">form-associated element</a>, it must run the + following steps: + + <ol> + <li> + <p>If the element's <a href="#form-owner">form owner</a> is not null, and + the element's <code title=attr-fae-form><a href="#form0">form</a></code> + content attribute is not present, and the element's <a + href="#form-owner">form owner</a> is one of the ancestors of the element + after the change to the ancestor chain, then do nothing, and abort these + steps. + + <li> + <p>Let the element's <a href="#form-owner">form owner</a> be null. + + <li> + <p>If the element has a <code title=attr-fae-form><a + href="#form0">form</a></code> content attribute, then run these + substeps:</p> + + <ol><!-- XXX how does ID matching get affected by quirks mode? --> + + <li> + <p>If the first element in the <code>Document</code> to have an ID that + is equal to the element's <code title=attr-fae-form><a + href="#form0">form</a></code> content attribute's value is a <code><a + href="#form">form</a></code> element, then <a href="#associated" + title=concept-form-association>associate</a> the <a + href="#form-associated">form-associated element</a> with that <code><a + href="#form">form</a></code> element. + + <li> + <p>Abort the "reset the form owner" steps. + </ol> + + <li> + <p>Otherwise, if the <a href="#form-associated">form-associated + element</a> in question has an ancestor <code><a + href="#form">form</a></code> element, then <a href="#associated" + title=concept-form-association>associate</a> the <a + href="#form-associated">form-associated element</a> with the nearest + such ancestor <code><a href="#form">form</a></code> element. + + <li> + <p>Otherwise, the element is left unassociated. + </ol> + + <p><a href="#form-associated" title="form-associated + element">Form-associated elements</a> have a <dfn id=form1 + title=dom-foa-form><code>form</code></dfn> DOM attribute, which, on + getting, must return the element's <a href="#form-owner">form owner</a>, + or null if there isn't one. <h4 id=processing1><span class=secno>4.9.13 </span>Processing model</h4> @@ -37186,7 +37292,7 @@ title=dom-PopStateEvent-initPopStateEvent><code>initPopStateEvent()</code></dfn> and <dfn id=initpopstateeventns title=dom-PopStateEvent-initPopStateEventNS><code>initPopStateEventNS()</code></dfn> - methods must initialise the event in a manner analogous to the + methods must initialize the event in a manner analogous to the similarly-named methods in the DOM3 Events interfaces. <a href="#references">[DOM3EVENTS]</a> @@ -38574,7 +38680,7 @@ title=dom-StorageEvent-initStorageEvent><code>initStorageEvent()</code></dfn> and <dfn id=initstorageeventns title=dom-StorageEvent-initStorageEventNS><code>initStorageEventNS()</code></dfn> - methods must initialise the event in a manner analogous to the + methods must initialize the event in a manner analogous to the similarly-named methods in the DOM3 Events interfaces. <a href="#references">[DOM3EVENTS]</a> @@ -41947,7 +42053,7 @@ title=dom-DragEvent-initDragEvent><code>initDragEvent()</code></dfn> and <dfn id=initdrageventns title=dom-DragEvent-initDragEventNS><code>initDragEventNS()</code></dfn> - methods must initialise the event in a manner analogous to the + methods must initialize the event in a manner analogous to the similarly-named methods in the DOM3 Events interfaces. <a href="#references">[DOM3EVENTS]</a> @@ -42000,7 +42106,7 @@ <p>The <dfn id=effectallowed title=dom-DataTransfer-effectAllowed><code>effectAllowed</code></dfn> - attribute is used in the drag-and-drop processing model to initialise the + attribute is used in the drag-and-drop processing model to initialize the <code title=dom-DataTransfer-dropEffect><a href="#dropeffect">dropEffect</a></code> attribute during the <code title=event-dragenter><a href="#dragenter">dragenter</a></code> and <code @@ -43218,7 +43324,7 @@ title=dom-UndoManagerEvent-initUndoManagerEvent><code>initUndoManagerEvent()</code></dfn> and <dfn id=initundomanagereventns><code title=dom-UndoManagerEvent-initUndoManagerEventNS>initUndoManagerEventNS()</code></dfn> - methods must initialise the event in a manner analogous to the + methods must initialize the event in a manner analogous to the similarly-named methods in the DOM3 Events interfaces. <a href="#references">[DOM3EVENTS]</a> @@ -43821,7 +43927,7 @@ title=dom-MessageEvent-initMessageEvent><code>initMessageEvent()</code></dfn> and <dfn id=initmessageeventns title=dom-MessageEvent-initMessageEventNS><code>initMessageEventNS()</code></dfn> - methods must initialise the event in a manner analogous to the + methods must initialize the event in a manner analogous to the similarly-named methods in the DOM3 Events interfaces. <a href="#references">[DOM3EVENTS]</a> @@ -47703,8 +47809,9 @@ <hr> - <p>When the steps below require the UA to <dfn id=reset>reset the insertion - mode appropriately</dfn>, it means the UA must follow these steps: + <p>When the steps below require the UA to <dfn id=reset0>reset the + insertion mode appropriately</dfn>, it means the UA must follow these + steps: <ol> <li>Let <var title="">last</var> be false. @@ -47946,7 +48053,7 @@ <ol> <li> - <p>Initialise <var title="">node</var> to be the <a + <p>Initialize <var title="">node</var> to be the <a href="#current5">current node</a> (the bottommost node of the stack). <li> @@ -47994,7 +48101,7 @@ <ol> <li> - <p>Initialise <var title="">node</var> to be the <a + <p>Initialize <var title="">node</var> to be the <a href="#current5">current node</a> (the bottommost node of the stack). <li> @@ -51310,11 +51417,12 @@ <p><a href="#insert0">Insert an HTML element</a> for the token.</p> <p>If the <a href="#form-element"><code title="">form</code> element - pointer</a> is not null, then <a href="#associated" - title=concept-form-association>associate</a> the newly created <code><a - href="#fieldset">fieldset</a></code> element with the <code><a - href="#form">form</a></code> element pointed to by the <a - href="#form-element"><code title="">form</code> element pointer</a>.</p> + pointer</a> is not null and the newly created element doesn't have a + <code title=attr-fae-form><a href="#form0">form</a></code> attribute, + then <a href="#associated" title=concept-form-association>associate</a> + the newly created <code><a href="#fieldset">fieldset</a></code> element + with the <code><a href="#form">form</a></code> element pointed to by the + <a href="#form-element"><code title="">form</code> element pointer</a>.</p> </dd> <!-- as normal, but imply </li> when there's another <li> open in weird cases --> @@ -51325,7 +51433,7 @@ <ol> <li> - <p>Initialise <var title="">node</var> to be the <a + <p>Initialize <var title="">node</var> to be the <a href="#current5">current node</a> (the bottommost node of the stack). <li> @@ -51373,7 +51481,7 @@ <ol> <li> - <p>Initialise <var title="">node</var> to be the <a + <p>Initialize <var title="">node</var> to be the <a href="#current5">current node</a> (the bottommost node of the stack). <li> @@ -51833,9 +51941,10 @@ <p><a href="#insert0">Insert an HTML element</a> for the token.</p> <p>If the <a href="#form-element"><code title="">form</code> element - pointer</a> is not null, then <a href="#associated" - title=concept-form-association>associate</a> the <code><a - href="#button">button</a></code> element with the <code><a + pointer</a> is not null and the newly created element doesn't have a + <code title=attr-fae-form><a href="#form0">form</a></code> attribute, + then <a href="#associated" title=concept-form-association>associate</a> + the <code><a href="#button">button</a></code> element with the <code><a href="#form">form</a></code> element pointed to by the <a href="#form-element"><code title="">form</code> element pointer</a>.</p> @@ -51972,10 +52081,11 @@ set.</p> <p>If the <a href="#form-element"><code title="">form</code> element - pointer</a> is not null, then <a href="#associated" - title=concept-form-association>associate</a> the newly created <code><a - href="#input0">input</a></code> element with the <code><a - href="#form">form</a></code> element pointed to by the <a + pointer</a> is not null and the newly created element doesn't have a + <code title=attr-fae-form><a href="#form0">form</a></code> attribute, + then <a href="#associated" title=concept-form-association>associate</a> + the newly created <code><a href="#input0">input</a></code> element with + the <code><a href="#form">form</a></code> element pointed to by the <a href="#form-element"><code title="">form</code> element pointer</a>.</p> <dt>A start tag whose tag name is "label" @@ -51987,10 +52097,11 @@ <p><a href="#insert0">Insert an HTML element</a> for the token.</p> <p>If the <a href="#form-element"><code title="">form</code> element - pointer</a> is not null, then <a href="#associated" - title=concept-form-association>associate</a> the newly created <code><a - href="#label">label</a></code> element with the <code><a - href="#form">form</a></code> element pointed to by the <a + pointer</a> is not null and the newly created element doesn't have a + <code title=attr-fae-form><a href="#form0">form</a></code> attribute, + then <a href="#associated" title=concept-form-association>associate</a> + the newly created <code><a href="#label">label</a></code> element with + the <code><a href="#form">form</a></code> element pointed to by the <a href="#form-element"><code title="">form</code> element pointer</a>.</p> <dt id=isindex>A start tag whose tag name is "isindex" @@ -52072,11 +52183,12 @@ the <a href="#current5">current node</a>.</p> <p>If the <a href="#form-element"><code title="">form</code> element - pointer</a> is not null, then <a href="#associated" - title=concept-form-association>associate</a> the newly created <code><a - href="#textarea">textarea</a></code> element with the <code><a - href="#form">form</a></code> element pointed to by the <a - href="#form-element"><code title="">form</code> element pointer</a>.</p> + pointer</a> is not null and the newly created element doesn't have a + <code title=attr-fae-form><a href="#form0">form</a></code> attribute, + then <a href="#associated" title=concept-form-association>associate</a> + the newly created <code><a href="#textarea">textarea</a></code> element + with the <code><a href="#form">form</a></code> element pointed to by the + <a href="#form-element"><code title="">form</code> element pointer</a>.</p> <p>Switch the tokeniser's <a href="#content4">content model flag</a> to the RCDATA state.</p> @@ -52118,9 +52230,10 @@ <p><a href="#insert0">Insert an HTML element</a> for the token.</p> <p>If the <a href="#form-element"><code title="">form</code> element - pointer</a> is not null, then <a href="#associated" - title=concept-form-association>associate</a> the <code><a - href="#select">select</a></code> element with the <code><a + pointer</a> is not null and the newly created element doesn't have a + <code title=attr-fae-form><a href="#form0">form</a></code> attribute, + then <a href="#associated" title=concept-form-association>associate</a> + the <code><a href="#select">select</a></code> element with the <code><a href="#form">form</a></code> element pointed to by the <a href="#form-element"><code title="">form</code> element pointer</a>.</p> @@ -52282,7 +52395,7 @@ <ol> <li> - <p>Initialise <var title="">node</var> to be the <a + <p>Initialize <var title="">node</var> to be the <a href="#current5">current node</a> (the bottommost node of the stack). <li> @@ -52542,7 +52655,7 @@ <p>Pop elements from this stack until a <code><a href="#table">table</a></code> element has been popped from the stack.</p> - <p><a href="#reset">Reset the insertion mode appropriately</a>.</p> + <p><a href="#reset0">Reset the insertion mode appropriately</a>.</p> <dt>An end tag whose tag name is one of: "body", "caption", "col", "colgroup", "html", "tbody", "td", "tfoot", "th", "thead", "tr" @@ -53146,7 +53259,7 @@ until a <code><a href="#select">select</a></code> element has been popped from the stack.</p> - <p><a href="#reset">Reset the insertion mode appropriately</a>.</p> + <p><a href="#reset0">Reset the insertion mode appropriately</a>.</p> <dt>A start tag whose tag name is "select" @@ -53940,7 +54053,7 @@ <ol> <li> - <p>Let <var title="">s</var> be a string, and initialise it to the empty + <p>Let <var title="">s</var> be a string, and initialize it to the empty string. <li> @@ -54203,7 +54316,7 @@ that it contains just the single element <var title="">root</var>.</p> <li> - <p><a href="#reset" title="reset the insertion mode appropriately">Reset + <p><a href="#reset0" title="reset the insertion mode appropriately">Reset the parser's insertion mode appropriately</a>.</p> <p class=note>The parser will reference the <var title="">context</var>
Received on Sunday, 7 September 2008 11:14:46 UTC