name Attribute

Where to use the name Attribute

• As Type CDATA - #REQUIRED:
  name is declared on the element: param
• As Type CDATA:
  name is declared on the elements: object, input, textarea, select, button
• As Type NMTOKEN:
  name is declared on the element: meta

Description

For a param (or meta) element, the name attribute specifies a name for the object parameter (or meta property).

For a form control (e.g. textarea), it specifies the name to be sent to the processing URI for that control if the control is successful when the form is submitted. It is sent as part of a name=value pair, where the value is the "final value" of that form control. Note: The input type="image" element behaves slightly differently, in that two pairs are sent - see the Server-side Image Map Module for more details. Multiple name=value pairs are also sent for select lists when multiple option elements have been selected.

For those form controls whose data is never sent to the processing URI (e.g. input type="reset") the name attribute merely specifies a name which may be used to refer to the control from within a script (although its id attribute may also be used for that purpose).