The standard does not provide the function of labelling an actionable form element. There is also no explicit relationship between a label and its associated form field (textInput - 2.16.33, checkBox - 2.16.7, and ddList - 2.16.7). Where a label is a human readable text string identifying the choice to be made or the text to be filled into the text field that is accessible to a screen reader. This functionality is different from a name.

Provide the functionality of a label for actionable form elements and provide a way to explicitly link labels to their text fields.

page 1585 Part 4, Section 2.16.17

TE

Proposed Disposition of DIS 29500 Comment CA-0069 (Modified: 2007-11-26) Agreed; we should provide a mechanism for screen readers to associate content controls and form controls to specific labels in order to meet accessibility guidelines. The following changes will be made: In Part 4, §2.5.2, add a new subclause, which becomes the new §2.5.2.19: label (Structured Document Tag Label) This element specifies the label identifier associated with the current structured document tag. The identifier representing the label shall be stored on this element’s val attribute and is used to reference the unique identifier value of a structured document tag. The contents of the structured document tag resolved by a specific unique identifier shall be used as the label content for the structured document tag that references that specific unique identifier of the structured document tag. If this element is omitted or the value of the label identifier cannot be resolved, then no label shall be associated with the given structured document tag. [Example: Consider the following two structured document tags where one structured document tag references another structured document tag as a label: <w:sdt> <w:sdtPr> <w:id w:val="5" /> </w:sdtPr> <w:sdtContent> <w:p> <w:r> <w:t>Name</w:t> </w:r> </w:p> </w:sdtContent> </w:sdt> ... <w:sdt> <w:sdtPr> <w:id w:val="6" /> <w:label w:val="5" /> </w:sdtPr> ... </w:sdt> The label element specifies that the structured document tag with an identifier value of 6 will use the contents of the structured document tag with an identifier value of 5 as a label source. In this example, the label contents will be "Name". end example] Attributes Description val (Decimal Number Value) Specifies that the contents of this attribute will contain a decimal number. The contents of this decimal number are interpreted based on the context of the parent XML element. [Example: Consider the following numeric WordprocessingML property of type ST_DecimalNumber : <w:... w:val="1512645511" /> The value of the val attribute is a decimal number whose value must be interpreted in the context of the parent element. end example] The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16). In Part 4, §2.5.2.37, page 585, line 22, one more child element will be included in the Child Elements table Child Elements Subclause alias (Friendly Name) §2.5.2.1 bibliography (Bibliography Structured Document Tag) §2.5.2.2 citation (Citation Structured Document Tag) §2.5.2.4 comboBox (Combo Box Structured Document Tag) §2.5.2.5 dataBinding (XML Mapping) §2.5.2.6 date (Date Structured Document Tag) §2.5.2.7 docPartList (Document Part Gallery Structured Document Tag) §2.5.2.12 docPartObj (Built-In Document Part Structured Document Tag) §2.5.2.13 dropDownList (Drop-Down List Structured Document Tag) §2.5.2.15 equation (Equation Structured Document Tag) §2.5.2.16 group (Group Structured Document Tag) §2.5.2.17 id (Unique ID) §2.5.2.18 label (Structured Document Tag Label) §2.5.2.19 Child Elements Subclause lock (Locking Setting) §2.5.2.22 picture (Picture Structured Document Tag) §2.5.2.23 placeholder (Structured Document Tag Placeholder Text) §2.5.2.24 richText (Rich Text Structured Document Tag) §2.5.2.25 rPr (Run Properties For Structured Document Tag Contents) §2.5.2.26 showingPlcHdr (Current Contents Are Placeholder Text) §2.5.2.38 tag (Programmatic Tag) §2.5.2.40 temporary (Remove Structured Document Tag When Contents Are Edited) §2.5.2.41 text (Plain Text Structured Document Tag) §2.5.2.42 In Part 4, §2.16.17, page 1,586, line 16, one more child element will be included in the Child Elements table Child Elements Subclause calcOnExit (Recalculate Fields When Current Field Is Modified) §2.16.6 checkBox (Checkbox Form Field Properties) §2.16.7 ddList (Drop-Down List Form Field Properties) §2.16.9 enabled (Form Field Enabled) §2.16.14 entryMacro (Script Function to Execute on Form Field Entry) §2.16.15 exitMacro (Script Function to Execute on Form Field Exit) §2.16.16 helpText (Associated Help Text) §2.16.23 label (Form Field Label) §2.16.26 name (Form Field Name) §2.16.28 statusText (Associated Status Text) §2.16.32 textInput (Text Box Form Field Properties) §2.16.33 In Part 4, §2.16, add a new subclause, which becomes the new §2.16.26: label (Form Field Label) This element specifies the label identifier associated with the current form field. The identifier representing the label shall be stored on this element’s val attribute and is used to reference the unique identifier value of a structured document tag. The contents of the structured document tag resolved by a specific unique identifier shall be used as the label content for the form field that references that specific unique identifier of the structured document tag. If this element is omitted or the value of the label identifier cannot be resolved, then no label shall be associated with the given form field. [Example: Consider the following text box form field, which references a structured document tag as a label: <w:sdt> <w:sdtPr> <w:id w:val="5" /> </w:sdtPr> <w:sdtContent> <w:p> <w:r> <w:t>Name</w:t> </w:r> </w:p> </w:sdtContent> </w:sdt> ... <w:ffData> <w:name w:val="TextTextBox" /> <w:enabled /> <w:textInput /> <w:label w:val="5" /> </w:ffData> The label element specifies that the text box form field will use the contents of the structured document tag with an identifier value of 5 as a label source. In this example, the label contents will be "Name". end example] Attributes Description val (Decimal Number Value) Specifies that the contents of this attribute will contain a decimal number. The contents of this decimal number are interpreted based on the context of the parent XML element. [Example: Consider the following numeric WordprocessingML property of type ST_DecimalNumber : <w:... w:val="1512645511" /> The value of the val attribute is a decimal number whose value must be interpreted in the context of the parent element. end example] The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16). In wml.xsd: The label element will be added to the CT_SdtPr and CT_FFData content models. Similar Comments: ECMA-0039 , US-0026