Main content

form

Characteristics

Superclass Role:

  • landmark

Base Concept:

  • HTML form

See Related:

  • search.

Inherited States and Properties:

  • aria-atomic
  • aria-busy (state)
  • aria-controls
  • aria-describedby
  • aria-disabled (state)
  • aria-dropeffect
  • aria-expanded (state)
  • aria-flowto
  • aria-grabbed (state)
  • aria-haspopup
  • aria-hiden (state)
  • aria-invalid (state)
  • aria-label
  • aria-labelledby
  • aria-live
  • aria-owns
  • aria-relevant

Name From:

  • author

A landmark region that contains a collection of items and objects that, as a whole, combine to create a form.

A region of the document that represents a collection of form-associated elements, some of which can represent editable values that can be submitted to a server for processing. Form role is a landmark role.

A form may be a mix of host language form controls, scripted controls, and hyperlinks. Authors are reminded to use native host language semantics to create form controls, whenever possible.

For search facilities, authors should use the search role and not the generic form role. Authors should provide a visible label for the form referenced with aria-labelledby. If an author uses a script to submit a form based on a user action that would otherwise not trigger an onsubmit event (for example, a form submission triggered by the user changing a form element's value), the author should provide the user with advance notification of the behavior. Authors are reminded to use native host language semantics to create form controls, whenever possible.

User agents should treat elements with the role of form as navigational landmarks.

Syntax

<div role="form">
</div>
More in this category: « grid document »