An option defines a named property of an item, page, or form. Options can appear as form globals, page globals, or as the contents of items. Array elements defines the settings within an option. The parameter entity reference to "%option;" could partially be defined as follows:
[15] <!ENTITY % options "(xformsmodels | xforms:input | xforms:secret |
xforms:textarea | xforms:range | xforms:select1 | xforms:select |
xforms:trigger | xforms:submit | xforms:upload | xforms:output |
xforms:repeat | xforms:group | xforms:switch | acclabel |
activated | active | bgcolor | border | borderinfo | colorinfo |
coordinates | cursortype | data | datagroup | delay | direction |
dirtyflag | display | enclosuresettings | excludedmetadata | filename |
filesize | first | fontcolor | fontinfo | format | formid | fullname |
gradient | image | imagemode | itemlocation | justify | label | labelbgcolor |
labelborder | labelfontcolor | labelfontinfo | last | layoutflow |
layoutinfo | linespacing | mimedata | mimetype | next |
numericshaping | orderingscheme | orientation |padding | pageid |
previous | printbgcolor | printfontcolor | printlabelbgcolor |
printlabelfontcolor | printsettings | printvisible |
readonly | requirements | rowpadding | rtf | saveformat | scrollhoriz |
scrollvert | signature | signatureimage | signdatagroups | signdetails |
signer | signformat | signgroups | signinstance | signitemrefs |
signitems | signnamespaces | signoptionrefs | signoptions |
signpagerefs | size | suppresslabel |texttype | thickness |
transmitdatagroups |transmitformat | transmitgroups | transmititemrefs |
transmititems |transmitnamespaces |transmitoptionrefs | transmitoptions |
transmitpagerefs | triggeritem | type | url | value | visible |
writeonly | xformsenabled | xformsreadonly | xformsrequired |
xformsvalid)">
Again, the definition is partial because XFDL supports namespace qualification of options as well as the interspersion of custom options in non-XFDL namespaces. Typically, application-defined options occur in application-defined items, but they are also sometimes used in XFDL-defined items to store intermediate results of complex computations, thereby allowing the form developer to arbitrarily break down a problem into manageable pieces. For more information, see <custom option>.
Also, note that only a subset of these options is valid for any XFDL item. For example, an xforms:repeat is only valid in a table item. The XFDL options are fully discussed in XFDL options and array elements and are summarized in the following sections.