| Attributes |
| Name | Required | Request-time | Type | Description |
| id | false | true | java.lang.String |
expose id, enables interaction with JavaScript
|
| flavor | false | true | java.lang.String |
styling of the button
choices:
standard
a standard form button. if you use it
you should specify "caption"
image
an image-button. if you use it you
should specify "src" and
"alt"
modern
a fancy button according to HTML4; dont
use if no all of your users have got
5th-generation browsers! You may embed
any code into this tag. (see docu or
www.w3.org)
|
| caption | false | true | java.lang.String |
Caption of the button. (use it if the chosen
flavor is "standard") If the value of
the 'captionResource' attribute in the parent
dbform is 'true', this tag retrieves it's
content via a resource bundle.
|
| src | false | true | java.lang.String |
source of the image (use it if the coosen flavor
is "image")
|
| alt | false | true | java.lang.String |
alternative to image (use it if the coosen
flavor is "image")
|
| border | false | true | java.lang.String | set html border attribute |
| destination | true | true | java.lang.String | the URL of the jsp-view to be invoked |
| destTable | false | true | java.lang.String |
the table of the toplevel form to jump to [may
be deprecated soon]
|
| destPos | false | true | java.lang.String |
a value indicating the row to navigate to.
Position strings are used as request
parameters allowing the framework to keep
track of the position the user comes from or
goes to. This string is structured as
follows:
fieldId : fieldValueLength : fieldValue
It is important to note that if multiple
keys exist in the definition of the table,
your position string must includes values
for each key. (separated by dashes (-))
Example:
<! Jump to another JSP, specify position
using multiple keys-->
<db:gotoButton caption="View Sample
Details"
destination="/viewSample.jsp"
destTable="Sample"
destPos="1:6:widget-3:2:23"/>
|
| keyToDestPos | false | true | java.lang.String |
a key indicating the row to navigate to.
Example:
<! Jump to another JSP, specify position
through a key -->
<db:gotoButton caption="View Sample
Details"
destination="/viewSample.jsp"
destTable="Sample"
keyToDestPos="k_1_1@root"/>
|
| keyToKeyToDestPos | false | true | java.lang.String |
a key to the key indicating the row to
navigate to. For each record in the
result-set, the associatedRadio tag
generates a key reference which can be used
to retrieve a position string.
Example:
<!for each record, generate a key to the
position string -->
<db:body><db:associatedRadio
name="test"/></db:body>
<db:footer>
<! Jump to another JSP, specify position
(get second record using appropriate
key!)-->
<db:gotoButton caption="View Sample
Details"
destination="/viewSample.jsp"
destTable="Sample"
keyToKeyDestPos="test"/>
Check "customerlist.jsp" in example!
Example for single form (works with mutilple
key columns):
<db:body>
<input type="hidden"
name="currentRow"
value="<db:pos>"/>
</db:body>
<db:footer>
<db:gotoButton
caption="View Sample Details"
destination="/viewSample.jsp"
destTable="Sample"
keyToDestPos="currentRow"/>
|
| singleRow | false | true | java.lang.String |
if set to true, only one row of data will be
fetched. default is false, so that all rows of
data will be fetched and the requested record
will be set as actual record.
|
| parentField | false | true | java.lang.String |
used in sub-form: field(s) in the main form
that is/are linked to this form
Should either be a key or set to
sortable="true"
in
dbforms-config.xml
|
| childField | false | true | java.lang.String |
used in sub-form: field(s) in this form that
is/are linked to the parent form
Should either be a key or set to
sortable="true"
in
dbforms-config.xml
|
| accessKey | false | true | java.lang.String |
The keyboard character used to move focus
immediately to thiselement.
|
| onBlur | false | true | java.lang.String |
JavaScript event handler executed when this
element loses inputfocus.
|
| onChange | false | true | java.lang.String |
JavaScript event handler executed when this
element loses inputfocus and its value has
changed.
|
| onSelect | false | true | java.lang.String |
JavaScipt event hanlder executed when the user
selects some text
|
| onClick | false | true | java.lang.String |
JavaScript event handler executed when this
element receives amouse click.
|
| onDblClick | false | true | java.lang.String |
JavaScript event handler executed when this
element receives amouse double click.
|
| onFocus | false | true | java.lang.String |
JavaScript event handler executed when this
element receives inputfocus.
|
| onKeyDown | false | true | java.lang.String |
JavaScript event handler executed when this
element has focus and akey is depressed.
|
| onKeyPress | false | true | java.lang.String |
JavaScript event handler executed when this
element has focus and akey is depressed and
released.
|
| onKeyUp | false | true | java.lang.String |
JavaScript event handler executed when this
element has focus and akey is released.
|
| onMouseDown | false | true | java.lang.String |
JavaScript event handler executed when this
element is under the mousepointer and a mouse
button is depressed.
|
| onMouseMove | false | true | java.lang.String |
JavaScript event handler executed when this
element is under themouse pointer and the
pointer is moved.
|
| onMouseOut | false | true | java.lang.String |
JavaScript event handler executed when this
element was under themouse pointer but the
pointer was moved outside the element.
|
| onMouseOver | false | true | java.lang.String |
JavaScript event handler executed when this
element was not underthe mouse pointer but the
pointer is moved inside the element.
|
| onMouseUp | false | true | java.lang.String |
JavaScript event handler executed when this
element is under themouse pointer and a mouse
button is released.
|
| style | false | true | java.lang.String |
CSS styles to be applied to this HTML element.
|
| styleClass | false | true | java.lang.String |
CSS stylesheet class to be applied to this HTML
element.
|
| title | false | true | java.lang.String |
this defines the "title" attribute for the HTML4
tag.
|
| tabIndex | false | true | java.lang.String |
The tab order (ascending positive integers) for
this element.
|