XForms Submit Element

Introduction

This form control initiates a submission. The result of which is all or part of an instance document being sent to a target destination, which could be local or remote (see the spec). Upon receiving a DOMActivate event, this form control dispatches a xforms-submit event to the submission element (see the spec) specified in its submission attibute.

Attributes

• UI Common
  • appearance - the value of this attribute gives a hint to the XForms processor as to which type of widget(s) to use to represent this control.
  • accesskey - used to specify the keyboard shortcut for focusing this control.
• Single-Node Binding
• Special
  • submission - required reference to element submission.

Type restrictions

The submit element can be bound to a node containing data of any type. Actually, the submit element doesn't interact with the data in the bound node. However, the relevant model item property on the bound node has an effect on a submit. If the bound node is irrelevant, then the submit will be hidden.

Representations

The XForms submit element can be represented by the following widgets for the specified appearance attribute values:

• button - default representation (xhtml/xul)
• link/clickable text - used when appearance = 'minimal' (xhtml only)

button

Displaying a button is the default presentation (xhtml/xul).

Characteristics

• analogous widgets are <html:input type="submit"/> and <xul:button/>

link/clickable text

XForms authors can use this representation if they want to have a widget like a XHTML anchor (xhtml only).

Characteristics

• appearance attribute contains the value minimal
• analogue widget is <html:a onClick="form.submit();"/>.