H.ui.base.Container
Class Summary
Extends: H.ui.base.Element
This class represents an abstract base class for container UI elements such as Lists and Panels.
[ For full details, see the Class Details ]
Method Summary
Methods |
---|
This method adds a child element to be rendered within the given container element. |
This method retrieves the child element collection of the given container. |
This method removes a child element from the given container's child element collection. |
This method sets a listener for a specific event triggered by the given element. |
This method removes a previously added listener from the event target. |
This method is the concrete implementation of the UI element. It receives the pre-rendered HTML element which may be modified by deriving classes. |
This method retrieves a value indicating if the given UI element is disabled. |
This method sets a value indicating if the given UI element is disabled. |
This method retrieves previously stored arbitrary data from the given element. |
This method stores arbitrary data with the given UI element. |
This method retrieves the HTML element the given UI element renders. |
This method sets a value indicating if the given element is visible. |
This method retrieves a value indicating if the given element is visibile. |
This method adds a CSS class to the given UI element (if it is not already present). |
This method removes a CSS class from the given UI element (if it is present). |
Class Description
This class represents an abstract base class for container UI elements such as Lists and Panels.
Constructor Details
H.ui.base.Container(opt_elementType, opt_className, opt_children)
- Parameters:
-
opt_elementType
: -
{string=} [optional]
- The rendering HTML element type (the given UI element is to be rendered as this type), the default is
div
-
opt_className
: -
{string=} [optional]
- An optional class name to be used on the given element
-
opt_children
: -
{Array<H.ui.base.Element>=} [optional]
- Optional child elements to be added to the given container element
Method Details
addChild (child) : {H.ui.base.Container}
This method adds a child element to be rendered within the given container element.
- Parameters:
-
child
: -
{H.ui.base.Element}
- The child element to be added
- Returns:
-
{H.ui.base.Container}
- This container instance
getChildren () : {Array<H.ui.base.Element>}
This method retrieves the child element collection of the given container.
- Returns:
-
{Array<H.ui.base.Element>}
- The child elements of the given container
removeChild (child)
This method removes a child element from the given container's child element collection.
- Parameters:
-
child
: -
{H.ui.base.Element}
- The child element to be removed
addEventListener (type, handler, opt_capture, opt_scope)
This method sets a listener for a specific event triggered by the given element.
- Parameters:
-
type
: -
{string}
- The name of the event type
-
handler
: -
{!Function}
- An event handler function to be invoked when the event is fired
-
opt_capture
: -
{boolean=} [optional]
- If
true
, listening is active in the capture phase (bubble otherwise) -
opt_scope
: -
{Object=} [optional]
- The scope for the handler function
removeEventListener (type, handler, opt_capture, opt_scope)
This method removes a previously added listener from the event target.
- Parameters:
-
type
: -
{string}
- The name of the event type
-
handler
: -
{!Function}
- The previously added event handler
-
opt_capture
: -
{boolean=} [optional]
- If
true
, listening is active in the capture phase (bubble otherwise) -
opt_scope
: -
{Object=} [optional]
- The scope for the handler function
renderInternal (element, doc)
This method is the concrete implementation of the UI element. It receives the pre-rendered HTML element which may be modified by deriving classes.
- Parameters:
-
element
: -
{Element}
- The HTML representation of the given UI element
-
doc
: -
{Document}
- The HTML document into which the give UI element is rendered
isDisabled () : {boolean}
This method retrieves a value indicating if the given UI element is disabled.
- Returns:
-
{boolean}
-
true
if the element is disabled,false
otherwise
setDisabled (disabled, opt_force) : {H.ui.base.Element}
This method sets a value indicating if the given UI element is disabled.
- Parameters:
-
disabled
: -
{boolean}
-
true
to disable the element,false
to enable it -
opt_force
: -
{boolean=} [optional]
- An optional Boolean flag indicating that the value should be set and propagated even if it is the same as the current state
- Returns:
-
{H.ui.base.Element}
- An object representing the given element instance
getData () : {*}
This method retrieves previously stored arbitrary data from the given element.
- Returns:
-
{*}
- The previously stored data object or
null
if no data was stored.
setData (data)
This method stores arbitrary data with the given UI element.
- Parameters:
-
data
: -
{*}
- The data to be stored
getElement () : {?HTMLElement}
This method retrieves the HTML element the given UI element renders.
Note: If the UI element has not been rendered, the method retrieves null
.
- Returns:
-
{?HTMLElement}
- An object representing the given element instance or
null
setVisibility (visibility)
This method sets a value indicating if the given element is visible.
- Parameters:
-
visibility
: -
{boolean}
-
true
if the given element is visible, otherwisefalse
getVisibility () : {boolean}
This method retrieves a value indicating if the given element is visibile.
- Returns:
-
{boolean}
-
true
if the given element is visible, otherwisefalse
addClass (className) : {H.ui.base.Element}
This method adds a CSS class to the given UI element (if it is not already present).
- Parameters:
-
className
: -
{string}
- The name of the CSS class to add
- Returns:
-
{H.ui.base.Element}
- The given UI element instance
removeClass (className) : {H.ui.base.Element}
This method removes a CSS class from the given UI element (if it is present).
- Parameters:
-
className
: -
{string}
- The CSS class name to add
- Returns:
-
{H.ui.base.Element}
- The given UI element instance