17.16.27 name

This element specifies the name of the current form field.

[Example: Consider the following WordprocessingML fragment for a text box form field:

<w:r>
  <w:fldChar w:fldCharType="begin">
    <w:ffData>
      <w:name w:val=”FirstName” />
      <w:textInput>
        …
      </w:textInput>
    </w:ffData>
  </w:fldChar>
</w:r>
<w:r>
  <w:instrText> FORMTEXT </w:instrText>
</w:r>
<w:r>
  <w:fldChar w:fldCharType="separate"/>
</w:r>
<w:r>
  <w:t>1</w:t>
</w:r>
<w:r>
  <w:fldChar w:fldCharType="end"/>
</w:r>

The name element specifies that the name of the current form field is FirstName. end example]

Attributes

val (Form Field Name Value)

Specifies the name of the form field.

If this attribute is omitted, then the parent form field shall have no name.

[Example: Consider the following WordprocessingML fragment for a form field:

    <w:ffData>
      <w:name w:val="ExampleFieldName"/>
    </w:ffData>

The val attribute specifies that the name of the current form field is ExampleFieldName. end example]

The possible values for this attribute are defined by the ST_FFName simple type (17.18.26).

[Note: The W3C XML Schema definition of this element’s content model (CT_FFName) is located in A.1. end note]