|
Whitebeam Library Definition
|
Tag Description
<rbm:command>
Define a block of XML to be executed for a specific command.
Syntax
<rbm:command name=string test=string error=string msg=string>body</rbm:command>
Attributes
The 'rbm:command' tag has 4 attributes:
Name | Type/Value | Range/Length | Description | name | string | text | Required. The name of this command handler. | test | string | expr | Required. A JavaScript expression that must evaluate to true in order for this command to be executed. | error | string | text | Required. Valid if there is a test attribute. If the test does not evaluate to true then run the command
named by this attribute instead of this command. i.e. this specified an error handling command. | msg | string | text | Required. If the test is present and does not evaluate to true then set the JavaScript global rb$message
to the value of this attribute before executing the error handler. |
Body
The rbm:command tag can contain any valid XML within it's body.
Remarks This tag defines a handler for the specific command identified by the name attribute to this tag.
The form handling library will identify the command to execute from the parameters passed to the browser.
The command is identified by a parameter called 'rbcmd-????' where ???? is the name of the command to execute.
If a handler for the specified command cannot be located then the library attempts to execute a command
called 'default'. The default handler is identified by an <rbm:command...> tag with either a missing name
attribute or the name attribute present and with a value of 'default.
There may only be one command handler defined for each named command. If more than one
rbm:command tag has the same name attribute then the library generates an error.
Example
<rbm:formset>
<rbm:command>
<!-- Default handler -->
<h1>Welcome to the example form page........</h1>
<form action="thispage.rhtm">
<input type="submit" name="rbcmd-createForm" value="Create">
<input type="submit" name="rbcmd-delete" value="Delete">
<input type="submit" name="rbcmd-edit" value="Edit">
</form>
</rbm:command>
<rbm:command name="createForm">
<!-- Display Form -->
<h1>Create new user........</h1>
<form action="thispage.rhtm">
<input type="submit" name="rbcmd-do_create" value="Create">
</form>
</rbm:command>
<rbm:command name="do_creaete">
<!-- Really create the user from the form parameters.-->
...The real work goes here...
<!-- Redirect back the default handler -->
</rbm:command>
...Rest of the handlers go here!...
</rbm:formset>
|
|
(loadtime : 9ms) |