Whitebeam Object Definition

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

Whitebeam Object Definition

XmlGeneric Object Description

Elements in the XML tree are represented by a number of separate classes, the most common of which are XmlTag and XmlText. The Each of these specific classes share a lot of commonoality and this is documented as a 'virtual' class - XmlGeneric. It is effectively the base - or super class of each of the specific element types.

Methods

XmlGeneric.select() Execute an XPath 1.0 exression
XmlGeneric.xpath() Execute an XPath 1.0 exression
XmlGeneric.clean() Discard generated output from this element
XmlGeneric.execute() Re-execute part of an XML tag tree. ADVANCED.
XmlGeneric.toString() Return string equivalent of sub-tree
XmlGeneric.moveTo() Move XML element to a parent
XmlGeneric.destroy() Destructor

Object Properties

Name Type/Value Range/Length Description
parentstruct XmlGeneric.XmlTagsee definition Required. A reference to the XmlTag that is the parent of this XmlTag. The only element not to have a parent is the root tag in the parser (parser.root).
typestring  Required.

A textual name for the element represented by this JavaScript object. Allows the underlying code to tell whether a child of a tag is another tag, a text element or a comment etc. The possible values for this property are:

ValueInstance of...
"tag"XmlTag
"text"XmlText
"comment"XmlComment
"pi"XmlPi
"cdata"XmlCData

You can also distinguish the type of the element using the 'instanceof' JavaScript operation.

textstring  Required. For XmlText, XmlComment, XmlCData and XmlPi classes the 'text' property contains the raw text for that element. This value can be changed. Note though that the changes are not reflected in the generated output from an element util it is next executed.
rb$tagidnumber  Required. Every XML element is allocated a numeric unique identifier within the page execution. This value is not usually required, however it can be used to test two elements to see whether they are in fact the same element.
existsbool  Required.

This property returns 'true' if the JavaScript object currently maps down to an underlying XML tree object (a tag, comment, text element etc). This property is useful when manipulating XML trees because attempting operations on objects that no longer map to an XML element will throw an error.

Example: if you delete a tag in an XML tree and have another JavaScript object the references one of the children of that tag then the child element will cease to reference an object when the parent is deleted.

Available from version : 1.3.27

lineNumbernumber  Required. Return the line number in the source XML tree where the parser found this element. Useful, for example, where you want to evaluate some embedded script within an XML document and you want to pass the line number to the rb.page.eval function.

Available from version : 1.3.27
Whitebeam release 1.3.36
(loadtime : 21ms)