Definition of Whitebeam XML Tags

Site Map
 
Home
 
Application Guide
Reference
  Installation
  Configuration
  XML Markup
    formset
    command
    pageinfo
  JavaScript Classes
  ROM
  Templates
  Environment
  Dev Process
  Tools
  External Links
  Example libraries
Community
Contact Whitebeam
To-Do
Download
Credits
Licence
Whitebeam Users
 
 
 

Definition of Whitebeam XML Tags

rbm:command

Define a block of XML to be executed for a specific command.

Body

The rbm:command tag can contain any valid XML within it's body.

Attributes

Attribute Required Description

name

implied

The name of this command handler.

test

implied

A JavaScript expression that must evaluate to true in order for this command to be executed.

error

implied

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

implied

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.

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>
Whitebeam release 1.3.36
(loadtime : 7ms)