ContainerControl

This is a convenience method for getting the ID_childControls property of this control and manipulating that.

Writing:

control.addChild(new LabelControl());

is equivalent to:

var childrenList = control.getValue(ID_childControls);
childrenList.add(new LabelControl());

This returns the child at position n in the childControls list, or null if there is no such child. Note that the child may either be a string or a Control object.

A string, Control, or null.

returns the value of the ID_tagName property if it is available, or "div" by default.

An HTML tag name string, e.g. "span", "tr", "div" etc.

ListControl.getTagName() | ButtonControl.getTagName()

Set this to a SitedList containing the child controls of this container.

Override the method in subclasses to change how a control inserts or removes childControls to the Dom (e.g. to animate changes).

All framework-generated Dom structural changes go via this method. Subclasses can modify this method to change how the Dom is updated, e.g. to animate the change.

The default implementation looks like this:

function modifyDOM(actionName, parentNode, childNode, nodeInDom)
{
	switch (actionName) {
		case ID_appendChild: {
			parentNode.appendChild(childNode); break;
		case ID_insertBefore:
			parentNode.insertBefore(childNode, nodeInDom); break;
		case ID_removeChild:
			parentNode.removeChild(childNode); break;
		case ID_replaceChild:
			parentNode.replaceChild(childNode, nodeInDom); break;
	}
}

Either ID_appendChild, ID_insertBefore, ID_removeChild, or ID_replaceChild.The Dom node to to perform the append, insert, remove or replace on.The child node to append, insert, remove or replace.For insertBefore or replaceChild, this is the node to insert before or replace.

Used to listens for changes to the ID_childControls list on this object.

SliderControl.onSetValue() | ListControl.onSetValue()

Used to listen for changes to the ID_childControls list on this object.

Used to listen for changes to the ID_childControls list on this object.

Subclasses typically call this method when something about the internal structure of the container has changed and the peer needs to be updated. This method calls ContainerControl.renderChildren() and then updates the container's peer's innerHTML property to the resulting HTML.

This is a convenience method for getting the ID_childControls property of this control and manipulating that.

Writing:

control.removeChild(aChild);

is roughly equivalent to:

list = control.getValue(ID_childControls);
list.remove(aChild);

Overrides Control.renderChildren() to render all the childControls of this control. For each child in this control, if the child is a string, this calls htmlBuilder.add(string). Otherwise this calls child.render(htmlBuilder).