Static Properties (2)

_ignoreAttribute

static private var _ignoreAttribute : Boolean = { ... };

Setting an argument attribute to this value in the construct routine of a subclass of LzNode will prevent further processing of the attribute

UIDs

static public var UIDs = 0.0;

Static Methods (1)

initialize()

<method name="initialize" args="prototype" />

static private function initialize(prototype : Object);

Link up the getter/setter/defaultattr inheritance

Initial Attributes (1)

Initial Attributes are given as attributes in LZX but are not generally available as properties in JavaScript.

ignoreplacement

<attribute name="ignoreplacement" />

Overrides placement attribute (and defaultplacement in lexical parent). See the LzNode.determinePlacement method. Defaults to false.

Properties (32)

$cfn

<attribute name="$cfn" />

private var $cfn = 0.0;

children

<attribute name="children" />

public var children = null;

classroot

<attribute name="classroot" type="lzNode" />

public var classroot : LzNode;

A reference to the node that is an instance of the <class> where this node is defined. Members of state subclasses do not define classroot. This is convenient to use when you want to access an attribute of the class in a method or event handler that is nested deep in the node hierarchy. For example, to set the bgcolor of the class object, instead of parent.parent.parent.setAttribute(bgcolor, 0xFFFFFF) you can simply use classroot.setAttribute(bgcolor, 0xFFFFFF).

cloneManager

<attribute name="cloneManager" type="lzNode" />

public var cloneManager : LzNode = null;

If this node is replicated due to data replication, the LzReplicationManager which controls this node.

datapath

<attribute name="datapath" type="string" />

public var datapath : String = null;

Specifies the data source for this node and its children. If the value begins with an identifier followed by a colon, the identifier names a dataset, and the portion of the string after the colon is an XPath description of a portion of the data. Otherwise the entire attribute value is an XPath description of the data, relative to the data source of this node's parent element. Examples: "mydata:", "mydata:/a/b", "/a/b".

defaultattrs

<attribute name="defaultattrs" value="{ ... }" />

public var defaultattrs = { ... };

defaultplacement

<attribute name="defaultplacement" type="string" />

public var defaultplacement : String = null;

An attribute used in container classes. If set to a non-null value, this forces this node to run its determinePlacement method for any node whose parent is this node. If the subnode has its own placement attribute, determinePlacement will be called with that value, otherwise it will be called with this value. Note that a class's defaultplacement attribute only applies to children in subclasses or in instances, not to the children of the class itself. This means that if a class and its subclass both define a defaultplacement attribute, the attribute will be set to one value before the subclass children are created and to a different one after they are created. See the determinePlacement method.

dependencies

<attribute name="dependencies" />

public var dependencies = null;

doneClassRoot

<attribute name="doneClassRoot" />

public var doneClassRoot = false;

earlySetters

<attribute name="earlySetters" value="{ ... }" />

private var earlySetters = { ... };

getters

<attribute name="getters" value="{ ... }" />

private var getters = { ... };

id

<attribute name="id" type="xsd:ID" />

public final var id : String = null;

A unique identifier for this element. Can be used as a global variable name in JavaScript code.

immediateparent

<attribute name="immediateparent" type="lzNode" />

public var immediateparent : LzNode = null;

Reference to this nodes's parent in the node hierarchy. This will be different from "parent" when a class uses placement or defaultplacement to assign a subnode a specific place. For example, always use immediateparent to get a mouse position in your views coordinate system.

initstage

<attribute name="initstage" type=""early" | "normal" | "late" | "immediate" | "defer"" value=""normal"" />

public final var initstage : String = null;

The execution of a node's init method and sending of the oninit event is under the control of its initstage attribute, as follows:

immediate

The init method is called immediately as the last stage of instantiation.

early

The init method is called immediately after the view and its children have been instantiated.

normal

The init method is called when the parent is initialized.

late

The init method is called during idle time. To check whether init has been called, check the isinited property. Force calling init using the completeInstantiation method.

defer

The init method will not be called unless explicitly requested by the completeInstantiation method.

isinited

<attribute name="isinited" type="boolean" />

public read-only var isinited : boolean = false;

Indicates that a node's init method has been called. The execution of the init method is under control of the initstage attribute.

$isstate

<attribute name="$isstate" />

private var $isstate = false;

__LZdelayedSetters

<attribute name="__LZdelayedSetters" value="{ ... }" />

private var __LZdelayedSetters = { ... };

__LZdelegates

<attribute name="__LZdelegates" />

private var __LZdelegates = null;

__LZdeleted

<attribute name="__LZdeleted" />

private var __LZdeleted = false;

__LZlateinit

<attribute name="__LZlateinit" />

private var __LZlateinit = null;

__LZpreventSubInit

<attribute name="__LZpreventSubInit" />

private var __LZpreventSubInit = null;

__LZresolveDict

<attribute name="__LZresolveDict" />

private var __LZresolveDict = null;

__LZsourceLocation

<attribute name="__LZsourceLocation" />

private var __LZsourceLocation = null;

__LZUID

<attribute name="__LZUID" />

private var __LZUID = null;

name

<attribute name="name" type="string" />

public final var name : String = null;

The name for this subnode. If given, then this node's parent and immediate parent will store a pointer to this node as the given name value.

nodeLevel

<attribute name="nodeLevel" type="number" />

public var nodeLevel : Number;

The depth of this node in the overall node hierarchy

options

<attribute name="options" type="css" value="{ ... }" />

private final var options : Css = { ... };

A list of CSS property names and values that configure the behavior of objects, such as data binding and view layouts, that operate on this view.

parent

<attribute name="parent" />

public var parent;

Reference to the node that was passed as this node's ancestor in the constructor. If this node was created by declaring it in a tag, the parent will be its lexical parent. Its lexical parent is the tag that encloses it. Allow a null parent so that nodes can be garbage collected when they are no longer needed. See also, immediateparent.

placement

<attribute name="placement" type="string" />

public final var placement : String = null;

Instructions to this element's container about where it should go within its container's internal hierarchy. See the LzNode.determinePlacement method. Defaults to the container itself.

setters

<attribute name="setters" value="{ ... }" />

public var setters = { ... };

sourceLocatorTable

<attribute name="sourceLocatorTable" value="{ ... }" />

public var sourceLocatorTable = { ... };

subnodes

<attribute name="subnodes" type="array" />

public var subnodes : Array = null;

An array of all of the LzNodes which consider this LzNode their parent. This list is similar to the subviews list, but it contains all the children of this node, not just the view children.

Methods (59)

addToExpectedAttribute()

<method name="addToExpectedAttribute" args="prop, val" />

private function addToExpectedAttribute(prop, val);

animate()

<method name="animate" args="prop, to, duration, isRelative, moreargs" />

public function animate(prop : String, to : Number, duration : Number, isRelative : Boolean, moreargs : Object) : LzAnimator;

animate is the simplest way to animate a property of a node. This method creates an animator which will change the value of the given property over the given duration. The result of this call is an LzAnimator object. Note that the animation is asynchronous -- that is, code that follows this call will be executed before the animation finishes. Calling this method with a duration of 0 does not create an animator, but instead just calls setAttribute.

applyConstraint()

<method name="applyConstraint" args="prop, cfunc, dep" />

public function applyConstraint(prop : String, cfunc : Function, dep : Array);

Applies a constraint for the given attribute.

applyData()

<method name="applyData" args="data" />

public function applyData(data : String);

Called on any node that is declared with a datapath that matches a terminal selector, such as text() or @attribute when the data it matches is changed.

childOf()

<method name="childOf" args="node" />

public function childOf(node : LzNode) : Boolean;

Tests whether the given node is a parent (or grand-parent, etc.) of this node.

completeInstantiation()

<method name="completeInstantiation" />

public function completeInstantiation();

Ensures that the children of this node have been created, and this node has been inited. The LFC does this automatically for nodes with initstage other than late or defer. Call this function to force instantiation to complete synchronously for nodes with initstage=late, and to force it to happen at all for nodes with initstage=defer.

construct()

<method name="construct" args="parent, args" />

public function construct(parent : LzNode, args : Object);

The construct() method of a node is called as early as possible -- before any arguments have been applied. This is the method to override in lieu of writing a class constructor for your LZX class. If you override this method, you must call the superclass method or your results will be extremely unpredictable. Note that construct can only be overriden within a subclass definition, not within a customized instance. The construct method is also responsible for placing the newly-built view into the appropriate place within its lexical parent's view hierarchy. The process for this is as follows:

• First, if the view has an ignoreplacement attribute with a true value, then the view will be placed directly under its lexical parent in all cases. The next steps are skipped.
• Second, the placement view name is determined from the first of the following that matches:
• Third, if there is no placement view name, the subview is placed within its lexical parent (that is, view.immediateparent = view.parent), and the next steps are skipped.
• Fourth, the placement view name is looked up within the lexical parent by calling determinePlacement, and the result is taken as the view's placement view.
• If this new placement view is a subview and it has a defaultplacement attribute, determinePlacement is called again. This process is repeated until no defaultplacement attribute is found to ensure that all placement directives are correctly followed.

constructWithArgs()

<method name="constructWithArgs" args="parent, args" />

private function constructWithArgs(parent, args);

createChildren()

<method name="createChildren" args="carr" />

protected function createChildren(carr : Array);

This function is used to instantiate subnodes. LzNodes may override or extend this method to change the meaning of attached subnodes.

dataBindAttribute()

<method name="dataBindAttribute" args="attr, path" />

public function dataBindAttribute(attr : String, path : String);

Binds the named attribute to the given path, relative to this node's datapath. This is the method that is called when the $path{} constraint is used. Note that the binding is two-way -- changing the value of the attribute will update the data.

_dbg_name()

<method name="_dbg_name" />

private function _dbg_name();

debugString hook If the node has an id (and is the value of that id), return that (prefixed by #, as a css id would be), if it has a name (and is the value of that name in its parent), return that (prefixed by ., as a property would be. If the node has no valid name or id, call the toString method (for backward compatibility). TODO: [2005-07-30 ptw] rewrite all those toString methods that really should be _dbg_name methods.

defaultSet()

<method name="defaultSet" args="val, prop" />

private function defaultSet(val, prop);

deleteNode()

<method name="deleteNode" args="recursiveCall" />

private function deleteNode(recursiveCall);

destroy()

<method name="destroy" args="recursiveCall" />

public function destroy(recursiveCall : Boolean);

Deletes the node and all the subnodes.

determinePlacement()

<method name="determinePlacement" args="aSub, placement, args" />

protected function determinePlacement(aSub : LzNode, placement : String, args : dictionary);

Determines the immediateparent for a subnode whose parent is this node. This method will only be called for subnodes which have a placement attribute, or for all subnodes if this node has a non-null defaultplacement. The placement attribute of a subnode overrides a parent's defaultplacement. This method looks for a subnode with the name given in the placement parameter, and returns that node. If no such named node exists, it returns 'this'. A subclass might implement this method to cause the "placement" parameter to have a different behavior or additional effects. Note that this function is not currently designed to be called by anyone but LzNode.construct. Do not expect to be able to 'place' a view properly after it has been constructed.

getAttribute()

<method name="getAttribute" args="prop" />

public function getAttribute(prop : String) : any;

returns the value for a property

getDebugIdentification()

<method name="getDebugIdentification" />

private function getDebugIdentification();

getExpectedAttribute()

<method name="getExpectedAttribute" args="prop" />

private function getExpectedAttribute(prop);

returns the expected value for the specified property, which is the value of the property after all executing animators are complete. FUTURE ENHANCEMENT: add a time parameter to specify expected value at a specific time.

getOption()

<method name="getOption" args="key" />

public function getOption(key : String) : any;

Returns the value for an option (set with the options= attribute) for nodes created from LZX, or from the dictionary passed as the options attribute to the node constructor from script

getUID()

<method name="getUID" />

public function getUID() : String;

Returns the unique ID of the node.

init()

<method name="init" />

public function init();

Called at the same time that the node sends its oninit event -- usually when the node's siblings are instantiated, and always after the node's children are instantiated.

initialize()

<method name="initialize" args="parent, attrs, children, instcall" />

public function initialize(parent : LzNode, attrs : Object, children : Object, instcall : Boolean);

lookupSourceLocator()

<method name="lookupSourceLocator" args="sourceLocator" />

public function lookupSourceLocator(sourceLocator : String) : any;

Translate a source locator to the corresponding node

__LZaddSetter()

<method name="__LZaddSetter" args="key, val" />

private function __LZaddSetter(key, val);

__LZapplyArgs()

<method name="__LZapplyArgs" args="args, constcall" />

private function __LZapplyArgs(args, constcall);

Applies a dictionary of args

__LZapplyStyleConstraints()

<method name="__LZapplyStyleConstraints" />

private function __LZapplyStyleConstraints();

Process style constraints Compute each of the style constraints that were saved above and apply them

__LZapplyStyleMap()

<method name="__LZapplyStyleMap" args="stylemap, initialArgs" />

private function __LZapplyStyleMap(stylemap : Object, initialArgs : Object);

Process the style map. For each style-constrained attribute, if it does not have an explicit value defined by the instance, lookup the css value that it should be constrained to. If it is a simple value, set it directly, otherwise save it to be applied after the instance is fully inited (since the constraint may depend on other attributes).

__LZassignClassRoot()

<method name="__LZassignClassRoot" args="arr, depth" />

private function __LZassignClassRoot(arr, depth);

called when the first instance of the class is instantiated must be called only once for each class

__LZcallInit()

<method name="__LZcallInit" />

private function __LZcallInit();

__LZclearPreventInit()

<method name="__LZclearPreventInit" />

private function __LZclearPreventInit();

__LZevalPathExpr()

<method name="__LZevalPathExpr" args="$lzsc$rp" />

private function __LZevalPathExpr($lzsc$rp);

Take care to evaluate a path expression in the proper environment $lzsc$ is the compiler convention for internal variables we resort to this in hopes that it is not shadowed in the with contexts because the compiler is not smart enough to use a register

__LZincrementCounter()

<method name="__LZincrementCounter" args="prop" />

private function __LZincrementCounter(prop);

__LZinstantiationDone()

<method name="__LZinstantiationDone" />

protected function __LZinstantiationDone();

Called when the node's subnodes have finished instantiating. If this node's parent is inited, this method clears the queue of nodes awaiting init.

__LZmakeDatapath()

<method name="__LZmakeDatapath" args="dpobj" />

private function __LZmakeDatapath(dpobj);

__LZresolveReferences()

<method name="__LZresolveReferences" />

private function __LZresolveReferences();

__LZresolveRefs()

<method name="__LZresolveRefs" args="refs" />

private function __LZresolveRefs(refs);

__LZsetClassRoot()

<method name="__LZsetClassRoot" args="d" />

private function __LZsetClassRoot(d);

__LZsetDefaultHandler()

<method name="__LZsetDefaultHandler" args="eName, func" />

private function __LZsetDefaultHandler(eName, func);

__LZsetDelegates()

<method name="__LZsetDelegates" args="delarr" />

private function __LZsetDelegates(delarr);

__LZsetEvents()

<method name="__LZsetEvents" args="eventNames" />

private function __LZsetEvents(eventNames);

__LZsetOptions()

<method name="__LZsetOptions" args="hash" />

private function __LZsetOptions(hash);

Setter to install options on a class or instance

__LZsetPreventInit()

<method name="__LZsetPreventInit" />

private function __LZsetPreventInit();

__LZsetSetters()

<method name="__LZsetSetters" args="o" />

private function __LZsetSetters(o);

__LZstoreAttr()

<method name="__LZstoreAttr" args="val, prop" />

private function __LZstoreAttr(val, prop);

__LZstoreDelegates()

<method name="__LZstoreDelegates" args="delarr" />

private function __LZstoreDelegates(delarr);

__LZstoreRefs()

<method name="__LZstoreRefs" args="val, prop" />

private function __LZstoreRefs(val, prop);

makeChild()

<method name="makeChild" args="e, async" />

private function makeChild(e, async);

Makes a child to the specification given in the child hash argument, calling the constructor with this as the value for the ancestorView.

releaseConstraint()

<method name="releaseConstraint" args="prop" />

private function releaseConstraint(prop);

Release the constraint on the named property This function doesn't seem to work. Marking private to remove from docs. -sa

searchImmediateSubnodes()

<method name="searchImmediateSubnodes" args="prop, val" />

public function searchImmediateSubnodes(prop : String, val : any) : LzNode;

Searches immediate subnodes for the given value of the given property.

searchSubnodes()

<method name="searchSubnodes" args="prop, val" />

public function searchSubnodes(prop : String, val : any) : LzNode;

Searches subnodes for the given value of the given property. Note that in this release, searchSubnodes actually searches only subviews (and thus is identical to LzView.searchSubiews). This bug will be fixed in a future release.

setAttribute()

<method name="setAttribute" args="prop, val" />

public function setAttribute(prop : String, val : any);

Sets the named attribute to the given value. If there is no setter for the property, this[ prop ] is set to the value, and the event this [ "on"+prop ] is sent.

setDatapath()

<method name="setDatapath" args="dp" />

public function setDatapath(dp : String);

Sets the datacontext for the node to the xpath given as an argument

setExpectedAttribute()

<method name="setExpectedAttribute" args="prop, val" />

private function setExpectedAttribute(prop, val);

setID()

<method name="setID" args="id" />

protected function setID(id : String);

Sets the id of the given to the string given. Nodes that have an id can be referred to using just the id. The id is in the global namespace, unlike names which need to be references in a specific context (e.g. 'parent.myname' or 'this.myname', vs. simply using 'myid')

setName()

<method name="setName" args="name" />

protected function setName(name : String);

Sets the name of the node.

setOption()

<method name="setOption" args="key, val" />

public function setOption(key : String, val : any);

Sets the value for an option (also set with the options= attribute for nodes created from LZX, or from the dictionary passed as the options attribute to the node constructor from script)

setProp()

<method name="setProp" args="prop, val" />

private function setProp(prop, val);

$styles()

<method name="$styles" />

private function $styles();

Default style map. Will be overridden for classes that have $style constraints.

toString()

<method name="toString" />

private function toString();

Events (5)

onclonenumber

<attribute name="onclonenumber" />

public event onclonenumber;

onconstruct

<attribute name="onconstruct" />

public event onconstruct;

This is the first event a node sends, right at the end of the instantiation process, but before any subnodes have been created or references resolved

ondata

<attribute name="ondata" />

public event ondata;

The ondata script is executed when the data selected by a view's datapath changes.

ondestroy

<attribute name="ondestroy" />

public event ondestroy;

oninit

<attribute name="oninit" />

public event oninit;

This event is sent right before a node becomes active -- e.g. before a view displays, or before a layout affects its subviews.

Prototype Properties (2)

getProp

<attribute name="getProp" />

private var getProp;

_setProp

<attribute name="_setProp" />

private var _setProp;