goog.ui.MenuButtonRenderer

Returns true if this renderer can decorate the element. Overrides goog.ui.ButtonRenderer#canDecorate by returning true if the element is a DIV, false otherwise.

Defined by	goog.ui.CustomButtonRenderer
Overrides	goog.ui.ControlRenderer
Parameters	element (Element|null) Element to decorate.
Returns	boolean Whether the renderer can decorate the element.

Takes a text caption or existing DOM structure, and returns the content and a dropdown arrow element wrapped in a pseudo-rounded-corner box. Creates the following DOM structure:

<div class="goog-inline-block goog-menu-button-outer-box">
  <div class="goog-inline-block goog-menu-button-inner-box">
    <div class="goog-inline-block goog-menu-button-caption">
      Contents...
    </div>
    <div class="goog-inline-block goog-menu-button-dropdown">
      &nbsp;
    </div>
  </div>
</div>

Overrides	goog.ui.CustomButtonRenderer
Parameters	content (string|Node|Array<Node>|NodeList<Node>|null) Text caption or DOM structure to wrap in a box. dom (goog.dom.DomHelper|null) DOM helper, used for document interaction.
Returns	Element Pseudo-rounded-corner box containing the content.

Takes a text caption or existing DOM structure, and returns it wrapped in an appropriately-styled DIV. Creates the following DOM structure:

<div class="goog-inline-block goog-menu-button-caption">
  Contents...
</div>

Parameters	content (string|Node|Array<Node>|NodeList<Node>|null) Text caption or DOM structure to wrap in a box. dom (goog.dom.DomHelper|null) DOM helper, used for document interaction.
Returns	Element Caption element.

Returns the button's contents wrapped in the following DOM structure:

<div class="goog-inline-block goog-custom-button">
  <div class="goog-inline-block goog-custom-button-outer-box">
    <div class="goog-inline-block goog-custom-button-inner-box">
      Contents...
    </div>
  </div>
</div>

Overrides goog.ui.ButtonRenderer#createDom.

Defined by	goog.ui.CustomButtonRenderer
Overrides	goog.ui.ButtonRenderer
Parameters	control (goog.ui.Control|null) goog.ui.Button to render.
Returns	Element Root element for the button.

Returns an appropriately-styled DIV containing a dropdown arrow element. Creates the following DOM structure:

<div class="goog-inline-block goog-menu-button-dropdown">
  &nbsp;
</div>

Parameters	dom (goog.dom.DomHelper|null) DOM helper, used for document interaction.
Returns	Element Dropdown element.

Takes an element, decorates it with the menu button control, and returns the element. Overrides goog.ui.CustomButtonRenderer#decorate by looking for a child element that can be decorated by a menu, and if it finds one, decorates it and attaches it to the menu button.

Overrides	goog.ui.CustomButtonRenderer
Parameters	control (goog.ui.Control|null) goog.ui.MenuButton to decorate the element. element (Element|null) Element to decorate.
Returns	(Element|null) Decorated element.

Updates the control's DOM by adding or removing the specified class name to/from its root element. May add additional combined classes as needed in IE6 and lower. Because of this, subclasses should use this method when modifying class names on the control's root element.

Defined by	goog.ui.ControlRenderer
Parameters	control (goog.ui.Control|Element|null) Control instance (or root element) to be updated. className string CSS class name to add or remove. enable boolean Whether to add or remove the class name.

Updates the control's DOM by adding or removing the specified extra class name to/from its element.

Defined by	goog.ui.ControlRenderer
Parameters	control (goog.ui.Control|null) Control to be updated. className string CSS class name to add or remove. enable boolean Whether to add or remove the class name.

Returns the ARIA role to be applied to custom buttons.

Defined by	goog.ui.CustomButtonRenderer
Overrides	goog.ui.ButtonRenderer
Parameters	None.
Returns	(goog.a11y.aria.Role|undefined) ARIA role.

Takes a single goog.ui.Component.State, and returns the corresponding CSS class name (null if none).

Defined by	goog.ui.ControlRenderer
Parameters	state goog.ui.Component.State Component state.
Returns	(string|undefined) CSS class representing the given state (undefined if none).

Returns all CSS class names applicable to the given control, based on its state. The return value is an array of strings containing

1. the renderer-specific CSS class returned by #getCssClass, followed by
2. the structural CSS class returned by getStructuralCssClass (if different from the renderer-specific CSS class), followed by
3. any state-specific classes returned by #getClassNamesForState, followed by
4. any extra classes returned by the control's `getExtraClassNames` method and
5. for IE6 and lower, additional combined classes from getAppliedCombinedClassNames_.

Since all controls have at least one renderer-specific CSS class name, this method is guaranteed to return an array of at least one element.

Defined by	goog.ui.ControlRenderer
Parameters	control (goog.ui.Control|null) Control whose CSS classes are to be returned.
Returns	Array<string> Array of CSS class names applicable to the control.

Takes a bit mask of goog.ui.Component.States, and returns an array of the appropriate class names representing the given state, suitable to be applied to the root element of a component rendered using this renderer, or null if no state-specific classes need to be applied. This default implementation uses the renderer's getClassForState method to generate each state-specific class.

Defined by	goog.ui.ControlRenderer
Parameters	state number Bit mask of component states.
Returns	Array<string> Array of CSS class names representing the given state.

Takes the button's root element and returns the parent element of the button's contents. Overrides the superclass implementation by taking the nested DIV structure of menu buttons into account.

Overrides	goog.ui.CustomButtonRenderer
Parameters	element (Element|null) Root element of the button whose content element is to be returned.
Returns	(Element|null) The button's content element.

Returns the CSS class to be applied to the root element of components rendered using this renderer.

Overrides	goog.ui.CustomButtonRenderer
Parameters	None.
Returns	string Renderer-specific CSS class.

Returns an array of combinations of classes to apply combined class names for in IE6 and below. See IE6_CLASS_COMBINATIONS for more detail. This method doesn't reference IE6_CLASS_COMBINATIONS so that it can be compiled out, but subclasses should return their IE6_CLASS_COMBINATIONS static constant instead.

Defined by	goog.ui.ControlRenderer
Parameters	None.
Returns	Array<(Array<string>|null)> Array of class name combinations.

Returns the element within the component's DOM that should receive keyboard focus (null if none). The default implementation returns the control's root element.

Defined by	goog.ui.ControlRenderer
Parameters	control (goog.ui.Control|null) Control whose key event target is to be returned.
Returns	(Element|null) The key event target.

Takes a single CSS class name which may represent a component state, and returns the corresponding component state (0x00 if none).

Defined by	goog.ui.ControlRenderer
Parameters	className string CSS class name, possibly representing a component state.
Returns	goog.ui.Component.State state Component state corresponding to the given CSS class (0x00 if none).

Returns the name of a DOM structure-specific CSS class to be applied to the root element of all components rendered or decorated using this renderer. Unlike the class name returned by #getCssClass, the structural class name may be shared among different renderers that generate similar DOM structures. The structural class name also serves as the basis of derived class names used to identify and style structural elements of the control's DOM, as well as the basis for state-specific class names. The default implementation returns the same class name as #getCssClass, but subclasses are expected to override this method as needed.

Defined by	goog.ui.ControlRenderer
Parameters	None.
Returns	string DOM structure-specific CSS class name (same as the renderer- specific CSS class name by default).

Takes a button's root element, and returns its tooltip text.

Defined by	goog.ui.ButtonRenderer
Parameters	element (Element|null) The button's root element.
Returns	(string|undefined) The tooltip text.

Takes a button's root element, and returns the value associated with it. No-op in the base class.

Defined by	goog.ui.ButtonRenderer
Parameters	element (Element|null) The button's root element.
Returns	(string|undefined) The button's value (undefined if none).

Check if the button's element has a box structure.

Defined by	goog.ui.CustomButtonRenderer
Parameters	button (goog.ui.Button|null) Button instance whose structure is being checked. element (Element|null) Element of the button.
Returns	boolean Whether the element has a box structure.

Initializes the control's DOM by configuring properties that can only be set after the DOM has entered the document. This implementation sets up BiDi and keyboard focus. Called from goog.ui.Control#enterDocument.

Defined by	goog.ui.ControlRenderer
Parameters	control (goog.ui.Control|null) Control whose DOM is to be initialized as it enters the document.

Returns true if the control's key event target supports keyboard focus (based on its tabIndex attribute), false otherwise.

Defined by	goog.ui.ControlRenderer
Parameters	control (goog.ui.Control|null) Control whose key event target is to be checked.
Returns	boolean Whether the control's key event target is focusable.

Allows or disallows text selection within the control's DOM.

Defined by	goog.ui.ControlRenderer
Parameters	element (Element|null) The control's root element. allow boolean Whether the element should allow text selection.

Sets the element's ARIA label. This should be overriden by subclasses that don't apply the role directly on control.element_.

Defined by	goog.ui.ControlRenderer
Parameters	element Element Element whose ARIA label is to be updated. ariaLabel string Label to add to the element.

Sets the element's ARIA role.

Defined by	goog.ui.ControlRenderer
Parameters	element (Element|null) Element to update. opt_preferredRole (goog.a11y.aria.Role|null)= The preferred ARIA role.

Sets the element's ARIA attributes, including distinguishing between universally supported ARIA properties and ARIA states that are only supported by certain ARIA roles. Only attributes which are initialized to be true will be set.

Defined by	goog.ui.ControlRenderer
Parameters	control goog.ui.Control Control whose ARIA state will be updated. element Element Element whose ARIA state is to be updated.

Collapses the border on one or both sides of the button, allowing it to be combined with the adjacent button(s), forming a single UI componenet with multiple targets.

Defined by	goog.ui.ButtonRenderer
Parameters	button (goog.ui.Button|null) Button to update. sides number Bitmap of one or more goog.ui.ButtonSides for which borders should be collapsed.

Takes a control's root element, and sets its content to the given text caption or DOM structure. The default implementation replaces the children of the given element. Renderers that create more complex DOM structures must override this method accordingly.

Defined by	goog.ui.ControlRenderer
Parameters	element (Element|null) The control's root element. content (string|Node|Array<Node>|NodeList<Node>|null) Text caption or DOM structure to be set as the control's content. The DOM nodes will not be cloned, they will only moved under the content element of the control.

Updates the control's key event target to make it focusable or non-focusable via its tabIndex attribute. Does nothing if the control doesn't support the FOCUSED state, or if it has no key event target.

Defined by	goog.ui.ControlRenderer
Parameters	control (goog.ui.Control|null) Control whose key event target is to be updated. focusable boolean Whether to enable keyboard focus support on the control's key event target.

Applies special styling to/from the control's element if it is rendered right-to-left, and removes it if it is rendered left-to-right.

Defined by	goog.ui.ControlRenderer
Parameters	element (Element|null) The control's root element. rightToLeft boolean Whether the component is rendered right-to-left.

Updates the appearance of the control in response to a state change.

Defined by	goog.ui.ControlRenderer
Parameters	control (goog.ui.Control|null) Control instance to update. state goog.ui.Component.State State to enable or disable. enable boolean Whether the control is entering or exiting the state.

Takes a button's root element and a tooltip string, and updates the element with the new tooltip.

Defined by	goog.ui.ButtonRenderer
Parameters	element (Element|null) The button's root element. tooltip string New tooltip text.

Takes a button's root element and a value, and updates the element to reflect the new value. No-op in the base class.

Defined by	goog.ui.ButtonRenderer
Parameters	element (Element|null) The button's root element. value string New value.

Shows or hides the element.

Defined by	goog.ui.ControlRenderer
Parameters	element (Element|null) Element to update. visible boolean Whether to show the element.

Updates the button's ARIA (accessibility) state if the button is being treated as a checkbox. Also makes sure that attributes which aren't supported by buttons aren't being added.

Defined by	goog.ui.ButtonRenderer
Overrides	goog.ui.ControlRenderer
Parameters	element (Element|null) Element whose ARIA state is to be updated. state goog.ui.Component.State Component state being enabled or disabled. enable boolean Whether the state is being enabled or disabled.

Takes a text caption or existing DOM structure, and returns it wrapped in an appropriately-styled DIV. Creates the following DOM structure:

<div class="goog-inline-block goog-menu-button-caption">
  Contents...
</div>

Parameters	content (string|Node|Array<Node>|NodeList<Node>|null) Text caption or DOM structure to wrap in a box. cssClass string The CSS class for the renderer. dom (goog.dom.DomHelper|null) DOM helper, used for document interaction.
Returns	Element Caption element.

Default CSS class to be applied to the root element of components rendered by this renderer.