Maps API for JavaScript Developer's Guide

H.ui.base.Container

Class Summary

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

Table 1. Methods
Methods
`addChild (child) : {H.ui.base.Container}` This method adds a child element to be rendered within the given container element.
`getChildren () : {Array<H.ui.base.Element>}` This method retrieves the child element collection of the given container.
`removeChild (child)` This method removes a child element from the given container's child element collection.
`addEventListener (type, handler, opt_capture, opt_scope)` This method sets a listener for a specific event triggered by the given element.
`removeEventListener (type, handler, opt_capture, opt_scope)` This method removes a previously added listener from the event target.
`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.
`isDisabled () : {boolean}` This method retrieves a value indicating if the given UI element is disabled.
`setDisabled (disabled, opt_force) : {H.ui.base.Element}` This method sets a value indicating if the given UI element is disabled.
`getData () : {*}` This method retrieves previously stored arbitrary data from the given element.
`setData (data)` This method stores arbitrary data with the given UI element.
`getElement () : {?HTMLElement}` This method retrieves the HTML element that represents the given UI element.
`setVisibility (visibility)` This method sets a value indicating if the given element is visible.
`getVisibility () : {boolean}` This method retrieves a value indicating if the given element is visibile.
`addClass (className) : {H.ui.base.Element}` This method adds a CSS class to the given UI element (if it is not already present).
`removeClass (className) : {H.ui.base.Element}` 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 that represents the given UI element.

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, otherwise false

getVisibility () : {boolean}

This method retrieves a value indicating if the given element is visibile.

Returns:
: {boolean}
: true if the given element is visible, otherwise false

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