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
.
- submission - required reference to element
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 valueminimal
- analogue widget is <html:a onClick="form.submit();"/>.