Definition of Whitebeam XML Tags

Site Map
 
Home
 
Application Guide
Reference
  Installation
  Configuration
  XML Markup
    authenticate
    block
    cachecontrol
    eval
    false
    header
    include
    insertblock
    insertdebug
    macrotag
    marksession
    nomacro
    noscript
    parser
    redirect
    repeatfor
    return
    script
    if
    test
    true
    xmp
    eval
    id
    marksession
    test
  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

rb:script

Execute server-side JavaScrip

Body

The body of this tag contains a JavaScript source code to execute.

Attributes

Attribute Required Description

src

implied

Optionally read the script to execute from another file. This attribute specified the filename containing the source code to execute assuming it is not in the body of this tag.

once

optional

Only execute the referenced script file if it has not already been the subject of a previous <script...> tag.

system

implied

Optional and only valid if the src attribute is specified, otherwise it is ignored. Has the value 'yes' or 'no'. If 'yes' then the script tag searches the system area for the specified JavaScript file. The file will have been provided by Whitebeam. These files are located in a reserved area of the Whitebeam system.

rb:loaderror

optional

By default, if the presentation engine cannot locate a named file then it throws an error and page execution stops. If you set this attribute to 'ignore' then the error is ignored and execution continues. This is useful in the case where an optional configuration script is not required in a particular instance of a web application.

Remarks

The language syntax is conformant to ECMAScript standard as defined in ECMA-262 which in turn is equivalent to JavaScript 1.5.

'JavaScript' provides access to the Redbourne Object Model (ROM) that comprises the set of objects, data types and methods defined by the various Whitebeam Templates.

The script to be implemented is most commonly contained in the body of the tag but may be in a separate file reference with the src attribute. The latter option has a potential performance benefit for large JavaScript libraries because the contents of the file are not parsed by the XML system - instead being passed directly to JavaScript for execution.

Whitebeam provide a number of 'utility' and 'extension' facilities that are enabled through the inclusion of special Whitebeam 'system' include files. These are documented separately when available. To use these facilities you specify the pathname provided to you by Whitebeam along with a 'system=yes' attribute to the tag.
Whitebeam release 1.3.36
(loadtime : 8ms)