Specifies a click button that performs an action when clicked with the mouse or activated with the space bar when it receives the input focus. Buttons can request data from a web server, submit or cancel the form, sign the form, save it to disk, or enclose external files.
acclabel, activated, active, bgcolor, border, borderinfo, coordinates, data, datagroup, enclosuresettings (enclose button only), focused, fontcolor, fontinfo, format, gradient, help, image, imagemode, itemlocation, itemnext, itemprevious, justify, keypress, linespacing, mouseover, next, printbgcolor, printfontcolor, printvisible, signature, signatureimage, signdatagroups, signdetails, signer, signformat, signgroups, signinstances, signitemrefs, signitems, signnamespaces, signoptionrefs, signoptions, signnamespaces, signpagerefs, size, transmitformat, transmititemrefs, transmititems, transmitnamespaces, transmitoptionrefs, transmitoptions, transmitpagerefs, type, url, value, visible, xformsenabled, xformsreadonly, xformsrequired, xformsvalid, xforms:submit, xforms:trigger, xforms:upload
Submit button
Buttons that trigger form processing requests must have a type option setting of submit or done. The definition for such a button might look like this:
<button sid="submit_button">
<value>Process Form</value>
<fontinfo>
<fontname>Helvetica</fontname>
<size>18</size>
<effect>bold</effect>
<effect>italic</effect>
</fontinfo>
<type>done</type>
<url>http://www.ibm.server.com/cgi-bin/formProcessor</url>
</button>
Enclosure button
This button encloses an external file in the form. The action to enclose a file is enclose. The datagroup option identifies the list of datagroups, or folders, in which the user can store the enclosed file. An enclose button might take the following form:
<button sid="enclose_button">
<value>Enclose File</value>
<fontinfo>
<fontname>Helvetica</fontname>
<size>18</size>
<effect>bold</effect>
<effect>italic</effect>
</fontinfo>
<type>enclose</type>
<datagroup>
<datagroupref>Images_Asia</datagroupref>
<datagroupref>Images_Eur</datagroupref>
<datagroupref>Images_SAmer</datagroupref>
</datagroup>
</button>
This button will allow users to enclose files into one of three datagroups (folders): Images_Asia, Images_Eur, Images_SAmer.
The usual options for other buttons (i.e. size, image, value) can also be used with signature buttons.