Class YAHOO.widget.Tooltip

Package:	YAHOO.widget
Class:	Tooltip
Extends:	Overlay
Defined In:	container.js

Tooltip is an implementation of Overlay that behaves like an OS tooltip, displaying when the user mouses over a particular element, and disappearing on mouse out.

Public Properties

Property		Defined By
	BOTTOM_LEFT<static> : String	Overlay
	<static> Constant representing the top bottom left corner of an element, used for configuring the context eleme...	Overlay
	BOTTOM_RIGHT<static> : String	Overlay
	<static> Constant representing the bottom right corner of an element, used for configuring the context element ...	Overlay
	CSS_BODY<static> : String	Module
	<static> Constant representing the module body	Module
	CSS_FOOTER<static> : String	Module
	<static> Constant representing the module footer	Module
	CSS_HEADER<static> : String	Module
	<static> Constant representing the module header	Module
	CSS_MODULE<static> : String	Module
	<static> Constant for the default CSS class name that represents a Module	Module
	CSS_OVERLAY<static> : String	Overlay
	<static> Constant representing the default CSS class used for an Overlay	Overlay
	CSS_TOOLTIP<static> : String	Tooltip
	<static> Constant representing the Tooltip CSS class	Tooltip
	TOP_LEFT<static> : String	Overlay
	<static> Constant representing the top left corner of an element, used for configuring the context element alig...	Overlay
	TOP_RIGHT<static> : String	Overlay
	<static> Constant representing the top right corner of an element, used for configuring the context element ali...	Overlay
	body : HTMLElement	Module
	The body element, denoted with CSS class "bd"	Module
	browser : String	Module
	String representing the current user-agent browser	Module
	cfg : YAHOO.util.Config	Module
	The Module's Config object used for monitoring configuration properties.	Module
	contructor : Function	Module
	The class's constructor function	Module
	element : HTMLElement	Module
	The main module element that contains the header, body, and footer	Module
	footer : HTMLElement	Module
	The footer element, denoted with CSS class "ft"	Module
	header : HTMLElement	Module
	The header element, denoted with CSS class "hd"	Module
	http : String	Module
	<static> Constant representing the prefix path to use for non-secure images	Module
	https : String	Module
	<static> Constant representing the prefix path to use for securely served images	Module
	id : String	Module
	The id of the element	Module
	imageRoot : String	Module
	The String representing the image root	Module
	isSecure : Boolean	Module
	Boolean representing whether or not the current browsing context is secure (https)	Module
	javascript : String	Module
	<static> Constant representing the url for the "src" attribute of the iframe used to monitor changes to the bro...	Module
	platform : String	Module
	String representing the current user-agent platform	Module

Public Methods

Method		Defined By
	Tooltip(`String el`, `HTMLElement el`, `Object userConfig`)	Tooltip
		Tooltip
	align(`String elementAlign`, `String contextAlign`) : void	Overlay
	Aligns the Overlay to its context element using the specified corner points (represented by the constants TOP_LEFT, T...	Overlay
	appendToBody(`HTMLElement element`) : void	Module
	Appends the passed element to the body. If no body is present, one will be automatically created.	Module
	appendToFooter(`HTMLElement element`) : void	Module
	Appends the passed element to the footer. If no footer is present, one will be automatically created.	Module
	appendToHeader(`HTMLElement element`) : void	Module
	Appends the passed element to the header. If no header is present, one will be automatically created.	Module
	center() : void	Overlay
	Centers the container in the viewport.	Overlay
	configConstrainToViewport(`String type`, `Object[] args`, `Object obj`) : void	Overlay
	The default event handler fired when the "constraintoviewport" property is changed.	Overlay
	configContainer(`String type`, `Object[] args`, `Object obj`) : void	Tooltip
	The default event handler fired when the "container" property is changed.	Tooltip
	configContext(`String type`, `Object[] args`, `Object obj`) : void	Tooltip
	The default event handler fired when the "context" property is changed.	Tooltip
	configFixedCenter(`String type`, `Object[] args`, `Object obj`) : void	Overlay
	The default event handler fired when the "fixedcenter" property is changed.	Overlay
	configHeight(`String type`, `Object[] args`, `Object obj`) : void	Overlay
	The default event handler fired when the "height" property is changed.	Overlay
	configIframe(`String type`, `Object[] args`, `Object obj`) : void	Overlay
	The default event handler fired when the "iframe" property is changed.	Overlay
	configMonitorResize(`String type`, `Object[] args`, `Object obj`) : void	Module
	Default event handler for the "monitorresize" configuration property	Module
	configText(`String type`, `Object[] args`, `Object obj`) : void	Tooltip
	The default event handler fired when the "text" property is changed.	Tooltip
	configVisible(`String type`, `Object[] args`, `Object obj`) : void	Module
	Default event handler for changing the visibility property of a Module. By default, this is achieved by switching the...	Module
	configWidth(`String type`, `Object[] args`, `Object obj`) : void	Overlay
	The default event handler fired when the "width" property is changed.	Overlay
	configX(`String type`, `Object[] args`, `Object obj`) : void	Overlay
	The default event handler fired when the "x" property is changed.	Overlay
	configXY(`String type`, `Object[] args`, `Object obj`) : void	Overlay
	The default event handler fired when the "xy" property is changed.	Overlay
	configY(`String type`, `Object[] args`, `Object obj`) : void	Overlay
	The default event handler fired when the "y" property is changed.	Overlay
	configzIndex(`String type`, `Object[] args`, `Object obj`) : void	Overlay
	The default event handler fired when the "zIndex" property is changed.	Overlay
	destroy() : void	Module
	Removes the Module element from the DOM and sets all child elements to null.	Module
	doCenterOnDOMEvent() : void	Overlay
	Center event handler used for centering on scroll/resize, but only if the Overlay is visible	Overlay
	doHide() : void	Tooltip
	Sets the timeout for the auto-dismiss delay, which by default is 5 seconds, meaning that a tooltip will automatically...	Tooltip
	doShow(`DOMEvent e`) : Number	Tooltip
	Processes the showing of the Tooltip by setting the timeout delay and offset of the Tooltip.	Tooltip
	enforceConstraints(`String type`, `Object[] args`, `Object obj`) : void	Overlay
	The default event handler executed when the moveEvent is fired, if the "constraintoviewport" is set to true.	Overlay
	hide() : void	Module
	Hides the Module element by setting the visible configuration property to false. Also fires two events: beforeHideEve...	Module
	hideIframe() : void	Overlay
	Hides the iframe shim, if it has been enabled	Overlay
	hideMacGeckoScrollbars() : void	Overlay
	Adds a special CSS class to the Overlay when Mac/Gecko is in use, to work around a Gecko bug where scrollbars cannot ...	Overlay
	init(`String el`, `HTMLElement el`, `Object userConfig`) : void	Tooltip
	The Tooltip initialization method. This method is automatically called by the constructor. A Tooltip is automatically...	Tooltip
	initDefaultConfig() : void	Tooltip
	Initializes the class's configurable properties which can be changed using the Overlay's Config object (cfg).	Tooltip
	initEvents() : void	Module
	Initializes the custom events for Module which are fired automatically at appropriate times by the Module class.	Module
	initResizeMonitor() : void	Module
	Initialized an empty IFRAME that is placed out of the visible area that can be used to detect text resize.	Module
	moveTo(`Number x`, `Number y`) : void	Overlay
	Moves the Overlay to the specified position. This function is identical to calling this.cfg.setProperty("xy", [x,y]);	Overlay
	onContextMouseMove(`DOMEvent e`, `Object obj`) : void	Tooltip
	The default event handler fired when the user moves the mouse while over the context element.	Tooltip
	onContextMouseOut(`DOMEvent e`, `Object obj`) : void	Tooltip
	The default event handler fired when the user mouses out of the context element.	Tooltip
	onContextMouseOver(`DOMEvent e`, `Object obj`) : void	Tooltip
	The default event handler fired when the user mouses over the context element.	Tooltip
	onDomResize(`DOMEvent e`, `Object obj`) : void	Module
	Event handler fired when the resize monitor element is resized.	Module
	preventOverlay(`Number pageX`, `Number pageY`) : void	Tooltip
	Fired when the Tooltip is moved, this event handler is used to prevent the Tooltip from overlapping with its context ...	Tooltip
	render(`String appendToNode`, `HTMLElement appendToNode`, `HTMLElement moduleElement`) : Boolean	Module
	Renders the Module by inserting the elements that are not already in the main Module into their correct places. Optio...	Module
	setBody(`String bodyContent`, `HTMLElement bodyContent`) : void	Module
	Sets the Module's body content to the HTML specified, or appends the passed element to the body. If no body is presen...	Module
	setFooter(`String footerContent`, `HTMLElement footerContent`) : void	Module
	Sets the Module's footer content to the HTML specified, or appends the passed element to the footer. If no footer is ...	Module
	setHeader(`String headerContent`, `HTMLElement headerContent`) : void	Module
	Sets the Module's header content to the HTML specified, or appends the passed element to the header. If no header is ...	Module
	show() : void	Module
	Shows the Module element by setting the visible configuration property to true. Also fires two events: beforeShowEven...	Module
	showIframe() : void	Overlay
	Shows the iframe shim, if it has been enabled	Overlay
	showMacGeckoScrollbars() : void	Overlay
	Removes a special CSS class from the Overlay when Mac/Gecko is in use, to work around a Gecko bug where scrollbars ca...	Overlay
	syncPosition() : void	Overlay
	Synchronizes the Panel's "xy", "x", and "y" properties with the Panel's position in the DOM. This is primarily used t...	Overlay
	toString() : String	Tooltip
	Returns a string representation of the object.	Tooltip
	windowResizeHandler<static>(`DOMEvent e`) : void	Overlay
	<static> The DOM event handler used to fire the CustomEvent for window resize	Overlay
	windowScrollHandler<static>(`DOMEvent e`) : void	Overlay
	<static> The DOM event handler used to fire the CustomEvent for window scroll	Overlay

Public Events

Event		Defined By
	YAHOO.widget.Overlay.windowResizeEvent : ()	Overlay
	A singleton CustomEvent used for reacting to the DOM event for window resize	Overlay
	YAHOO.widget.Overlay.windowScrollEvent : ()	Overlay
	A singleton CustomEvent used for reacting to the DOM event for window scroll	Overlay
	appendEvent : ()	Module
	CustomEvent fired when the Module is appended to the DOM	Module
	beforeHideEvent : ()	Module
	CustomEvent fired before the Module is hidden	Module
	beforeInitEvent : (`class classRef`)	Module
	CustomEvent fired prior to class initalization.	Module
	beforeMoveEvent : (`Number x`, `Number y`)	Overlay
	CustomEvent fired before the Overlay is moved.	Overlay
	beforeRenderEvent : ()	Module
	CustomEvent fired before the Module is rendered	Module
	beforeShowEvent : ()	Module
	CustomEvent fired before the Module is shown	Module
	changeBodyEvent : (`String/HTMLElement content`)	Module
	CustomEvent fired when the body content of the Module is modified	Module
	changeContentEvent : ()	Module
	CustomEvent fired when the content of the Module is modified	Module
	changeFooterEvent : (`String/HTMLElement content`)	Module
	CustomEvent fired when the footer content of the Module is modified	Module
	changeHeaderEvent : (`String/HTMLElement content`)	Module
	CustomEvent fired when the header content of the Module is modified	Module
	destroyEvent : ()	Module
	CustomEvent fired when the Module is destroyed	Module
	hideEvent : ()	Module
	CustomEvent fired after the Module is hidden	Module
	initEvent : (`class classRef`)	Module
	CustomEvent fired after class initalization.	Module
	moveEvent : (`Number x`, `Number y`)	Overlay
	CustomEvent fired after the Overlay is moved.	Overlay
	renderEvent : ()	Module
	CustomEvent fired after the Module is rendered	Module
	showEvent : ()	Module
	CustomEvent fired after the Module is shown	Module

Property Details

BOTTOM_LEFT<static>

public String BOTTOM_LEFT<static>

<static> Constant representing the top bottom left corner of an element, used for configuring the context element alignment

This property is defined by Overlay.

BOTTOM_RIGHT<static>

public String BOTTOM_RIGHT<static>

<static> Constant representing the bottom right corner of an element, used for configuring the context element alignment

This property is defined by Overlay.

CSS_BODY<static>

public String CSS_BODY<static>

<static> Constant representing the module body

This property is defined by Module.

CSS_FOOTER<static>

public String CSS_FOOTER<static>

<static> Constant representing the module footer

This property is defined by Module.

CSS_HEADER<static>

public String CSS_HEADER<static>

<static> Constant representing the module header

This property is defined by Module.

CSS_MODULE<static>

public String CSS_MODULE<static>

<static> Constant for the default CSS class name that represents a Module

This property is defined by Module.

CSS_OVERLAY<static>

public String CSS_OVERLAY<static>

<static> Constant representing the default CSS class used for an Overlay

This property is defined by Overlay.

CSS_TOOLTIP<static>

public String CSS_TOOLTIP<static>

<static> Constant representing the Tooltip CSS class

This property is defined by Tooltip.

TOP_LEFT<static>

public String TOP_LEFT<static>

<static> Constant representing the top left corner of an element, used for configuring the context element alignment

This property is defined by Overlay.

TOP_RIGHT<static>

public String TOP_RIGHT<static>

<static> Constant representing the top right corner of an element, used for configuring the context element alignment

This property is defined by Overlay.

body

public HTMLElement body

The body element, denoted with CSS class "bd"

This property is defined by Module.

browser

public String browser

String representing the current user-agent browser

This property is defined by Module.

cfg

public YAHOO.util.Config cfg

The Module's Config object used for monitoring configuration properties.

This property is defined by Module.

contructor

public Function contructor

The class's constructor function

This property is defined by Module.

element

public HTMLElement element

The main module element that contains the header, body, and footer

This property is defined by Module.

footer

public HTMLElement footer

The footer element, denoted with CSS class "ft"

This property is defined by Module.

header

public HTMLElement header

The header element, denoted with CSS class "hd"

This property is defined by Module.

http

public String http

<static> Constant representing the prefix path to use for non-secure images

This property is defined by Module.

https

public String https

<static> Constant representing the prefix path to use for securely served images

This property is defined by Module.

id

public String id

The id of the element

This property is defined by Module.

imageRoot

public String imageRoot

The String representing the image root

This property is defined by Module.

isSecure

public Boolean isSecure

Boolean representing whether or not the current browsing context is secure (https)

This property is defined by Module.

javascript

public String javascript

<static> Constant representing the url for the "src" attribute of the iframe used to monitor changes to the browser's base font size

This property is defined by Module.

platform

public String platform

String representing the current user-agent platform

This property is defined by Module.

Constructor Details

Tooltip

public function Tooltip(String el, HTMLElement el, Object userConfig)

Parameters:

el : String
The element ID representing the Tooltip OR
el : HTMLElement
The element representing the Tooltip
userConfig : Object
The configuration object literal containing the configuration that should be set for this Overlay. See configuration documentation for more details.

Method Details

align

public function align(String elementAlign, String contextAlign)

Aligns the Overlay to its context element using the specified corner points (represented by the constants TOP_LEFT, TOP_RIGHT, BOTTOM_LEFT, and BOTTOM_RIGHT.

Parameters:

elementAlign : String
The String representing the corner of the Overlay that should be aligned to the context element
contextAlign : String
The corner of the context element that the elementAlign corner should stick to.

Returns:

void

This method is defined by Overlay.

appendToBody

public function appendToBody(HTMLElement element)

Appends the passed element to the body. If no body is present, one will be automatically created.

Parameters:

element : HTMLElement
The element to append to the body

Returns:

void

This method is defined by Module.

appendToFooter

public function appendToFooter(HTMLElement element)

Appends the passed element to the footer. If no footer is present, one will be automatically created.

Parameters:

element : HTMLElement
The element to append to the footer

Returns:

void

This method is defined by Module.

appendToHeader

public function appendToHeader(HTMLElement element)

Appends the passed element to the header. If no header is present, one will be automatically created.

Parameters:

element : HTMLElement
The element to append to the header

Returns:

void

This method is defined by Module.

center

public function center()

Centers the container in the viewport.

Parameters:

None.

Returns:

void

This method is defined by Overlay.

configConstrainToViewport

public function configConstrainToViewport(String type, Object[] args, Object obj)

The default event handler fired when the "constraintoviewport" property is changed.

Parameters:

type : String
The CustomEvent type (usually the property name)
args : Object[]
The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
obj : Object
The scope object. For configuration handlers, this will usually equal the owner.

Returns:

void

This method is defined by Overlay.

configContainer

public function configContainer(String type, Object[] args, Object obj)

The default event handler fired when the "container" property is changed.

Parameters:

type : String
The CustomEvent type (usually the property name)
args : Object[]
The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
obj : Object
The scope object. For configuration handlers, this will usually equal the owner.

Returns:

void

This method is defined by Tooltip.

configContext

public function configContext(String type, Object[] args, Object obj)

The default event handler fired when the "context" property is changed.

Parameters:

type : String
The CustomEvent type (usually the property name)
args : Object[]
The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
obj : Object
The scope object. For configuration handlers, this will usually equal the owner.

Returns:

void

This method is defined by Tooltip.

configFixedCenter

public function configFixedCenter(String type, Object[] args, Object obj)

The default event handler fired when the "fixedcenter" property is changed.

Parameters:

type : String
The CustomEvent type (usually the property name)
args : Object[]
The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
obj : Object
The scope object. For configuration handlers, this will usually equal the owner.

Returns:

void

This method is defined by Overlay.

configHeight

public function configHeight(String type, Object[] args, Object obj)

The default event handler fired when the "height" property is changed.

Parameters:

type : String
The CustomEvent type (usually the property name)
args : Object[]
The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
obj : Object
The scope object. For configuration handlers, this will usually equal the owner.

Returns:

void

This method is defined by Overlay.

configIframe

public function configIframe(String type, Object[] args, Object obj)

The default event handler fired when the "iframe" property is changed.

Parameters:

type : String
The CustomEvent type (usually the property name)
args : Object[]
The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
obj : Object
The scope object. For configuration handlers, this will usually equal the owner.

Returns:

void

This method is defined by Overlay.

configMonitorResize

public function configMonitorResize(String type, Object[] args, Object obj)

Default event handler for the "monitorresize" configuration property

Parameters:

type : String
The CustomEvent type (usually the property name)
args : Object[]
The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
obj : Object
The scope object. For configuration handlers, this will usually equal the owner.

Returns:

void

This method is defined by Module.

configText

public function configText(String type, Object[] args, Object obj)

The default event handler fired when the "text" property is changed.

Parameters:

type : String
The CustomEvent type (usually the property name)
args : Object[]
The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
obj : Object
The scope object. For configuration handlers, this will usually equal the owner.

Returns:

void

This method is defined by Tooltip.

configVisible

public function configVisible(String type, Object[] args, Object obj)

Default event handler for changing the visibility property of a Module. By default, this is achieved by switching the "display" style between "block" and "none". This method is responsible for firing showEvent and hideEvent.

Parameters:

type : String
The CustomEvent type (usually the property name)
args : Object[]
The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
obj : Object
The scope object. For configuration handlers, this will usually equal the owner.

Returns:

void

This method is defined by Module.

configWidth

public function configWidth(String type, Object[] args, Object obj)

The default event handler fired when the "width" property is changed.

Parameters:

type : String
The CustomEvent type (usually the property name)
args : Object[]
The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
obj : Object
The scope object. For configuration handlers, this will usually equal the owner.

Returns:

void

This method is defined by Overlay.

configX

public function configX(String type, Object[] args, Object obj)

The default event handler fired when the "x" property is changed.

Parameters:

type : String
The CustomEvent type (usually the property name)
args : Object[]
The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
obj : Object
The scope object. For configuration handlers, this will usually equal the owner.

Returns:

void

This method is defined by Overlay.

configXY

public function configXY(String type, Object[] args, Object obj)

The default event handler fired when the "xy" property is changed.

Parameters:

type : String
The CustomEvent type (usually the property name)
args : Object[]
The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
obj : Object
The scope object. For configuration handlers, this will usually equal the owner.

Returns:

void

This method is defined by Overlay.

configY

public function configY(String type, Object[] args, Object obj)

The default event handler fired when the "y" property is changed.

Parameters:

type : String
The CustomEvent type (usually the property name)
args : Object[]
The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
obj : Object
The scope object. For configuration handlers, this will usually equal the owner.

Returns:

void

This method is defined by Overlay.

configzIndex

public function configzIndex(String type, Object[] args, Object obj)

The default event handler fired when the "zIndex" property is changed.

Parameters:

type : String
The CustomEvent type (usually the property name)
args : Object[]
The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
obj : Object
The scope object. For configuration handlers, this will usually equal the owner.

Returns:

void

This method is defined by Overlay.

destroy

public function destroy()

Removes the Module element from the DOM and sets all child elements to null.

Parameters:

None.

Returns:

void

This method is defined by Module.

doCenterOnDOMEvent

public function doCenterOnDOMEvent()

Center event handler used for centering on scroll/resize, but only if the Overlay is visible

Parameters:

None.

Returns:

void

This method is defined by Overlay.

doHide

public function doHide()

Sets the timeout for the auto-dismiss delay, which by default is 5 seconds, meaning that a tooltip will automatically dismiss itself after 5 seconds of being displayed.

Parameters:

None.

Returns:

void

This method is defined by Tooltip.

doShow

public function doShow(DOMEvent e)

Processes the showing of the Tooltip by setting the timeout delay and offset of the Tooltip.

Parameters:

e : DOMEvent
The current DOM event

Returns:

Number
The process ID of the timeout function associated with doShow

This method is defined by Tooltip.

enforceConstraints

public function enforceConstraints(String type, Object[] args, Object obj)

The default event handler executed when the moveEvent is fired, if the "constraintoviewport" is set to true.

Parameters:

type : String
The CustomEvent type (usually the property name)
args : Object[]
The CustomEvent arguments. For configuration handlers, args[0] will equal the newly applied value for the property.
obj : Object
The scope object. For configuration handlers, this will usually equal the owner.

Returns:

void

This method is defined by Overlay.

hide

public function hide()

Hides the Module element by setting the visible configuration property to false. Also fires two events: beforeHideEvent prior to the visibility change, and hideEvent after.

Parameters:

None.

Returns:

void

This method is defined by Module.

hideIframe

public function hideIframe()

Hides the iframe shim, if it has been enabled

Parameters:

None.

Returns:

void

This method is defined by Overlay.

hideMacGeckoScrollbars

public function hideMacGeckoScrollbars()

Adds a special CSS class to the Overlay when Mac/Gecko is in use, to work around a Gecko bug where scrollbars cannot be hidden. See https://bugzilla.mozilla.org/show_bug.cgi?id=187435

Parameters:

None.

Returns:

void

This method is defined by Overlay.

init

public function init(String el, HTMLElement el, Object userConfig)

The Tooltip initialization method. This method is automatically called by the constructor. A Tooltip is automatically rendered by the init method, and it also is set to be invisible by default, and constrained to viewport by default as well.

Parameters:

el : String
The element ID representing the Tooltip OR
el : HTMLElement
The element representing the Tooltip
userConfig : Object
The configuration object literal containing the configuration that should be set for this Tooltip. See configuration documentation for more details.

Returns:

void

This method is defined by Tooltip.

initDefaultConfig

public function initDefaultConfig()

Initializes the class's configurable properties which can be changed using the Overlay's Config object (cfg).

Parameters:

None.

Returns:

void

This method is defined by Tooltip.

initEvents

public function initEvents()

Initializes the custom events for Module which are fired automatically at appropriate times by the Module class.

Parameters:

None.

Returns:

void

This method is defined by Module.

initResizeMonitor

public function initResizeMonitor()

Initialized an empty IFRAME that is placed out of the visible area that can be used to detect text resize.

Parameters:

None.

Returns:

void

This method is defined by Module.

moveTo

public function moveTo(Number x, Number y)

Moves the Overlay to the specified position. This function is identical to calling this.cfg.setProperty("xy", [x,y]);

Parameters:

x : Number
The Overlay's new x position
y : Number
The Overlay's new y position

Returns:

void

This method is defined by Overlay.

onContextMouseMove

public function onContextMouseMove(DOMEvent e, Object obj)

The default event handler fired when the user moves the mouse while over the context element.

Parameters:

e : DOMEvent
The current DOM event
obj : Object
The object argument

Returns:

void

This method is defined by Tooltip.

onContextMouseOut

public function onContextMouseOut(DOMEvent e, Object obj)

The default event handler fired when the user mouses out of the context element.

Parameters:

e : DOMEvent
The current DOM event
obj : Object
The object argument

Returns:

void

This method is defined by Tooltip.

onContextMouseOver

public function onContextMouseOver(DOMEvent e, Object obj)

The default event handler fired when the user mouses over the context element.

Parameters:

e : DOMEvent
The current DOM event
obj : Object
The object argument

Returns:

void

This method is defined by Tooltip.

onDomResize

public function onDomResize(DOMEvent e, Object obj)

Event handler fired when the resize monitor element is resized.

Parameters:

e : DOMEvent
The DOM resize event
obj : Object
The scope object passed to the handler

Returns:

void

This method is defined by Module.

preventOverlay

public function preventOverlay(Number pageX, Number pageY)

Fired when the Tooltip is moved, this event handler is used to prevent the Tooltip from overlapping with its context element.

Parameters:

pageX : Number
The x coordinate position of the mouse pointer
pageY : Number
The y coordinate position of the mouse pointer

Returns:

void

This method is defined by Tooltip.

render

public function render(String appendToNode, HTMLElement appendToNode, HTMLElement moduleElement)

Renders the Module by inserting the elements that are not already in the main Module into their correct places. Optionally appends the Module to the specified node prior to the render's execution. NOTE: For Modules without existing markup, the appendToNode argument is REQUIRED. If this argument is ommitted and the current element is not present in the document, the function will return false, indicating that the render was a failure.

Parameters:

appendToNode : String
The element id to which the Module should be appended to prior to rendering OR
appendToNode : HTMLElement
The element to which the Module should be appended to prior to rendering
moduleElement : HTMLElement
OPTIONAL. The element that represents the actual Standard Module container.

Returns:

Boolean
Success or failure of the render

This method is defined by Module.

setBody

public function setBody(String bodyContent, HTMLElement bodyContent)

Sets the Module's body content to the HTML specified, or appends the passed element to the body. If no body is present, one will be automatically created.

Parameters:

bodyContent : String
The HTML used to set the body OR
bodyContent : HTMLElement
The HTMLElement to append to the body

Returns:

void

This method is defined by Module.

setFooter

public function setFooter(String footerContent, HTMLElement footerContent)

Sets the Module's footer content to the HTML specified, or appends the passed element to the footer. If no footer is present, one will be automatically created.

Parameters:

footerContent : String
The HTML used to set the footer OR
footerContent : HTMLElement
The HTMLElement to append to the footer

Returns:

void

This method is defined by Module.

setHeader

public function setHeader(String headerContent, HTMLElement headerContent)

Sets the Module's header content to the HTML specified, or appends the passed element to the header. If no header is present, one will be automatically created.

Parameters:

headerContent : String
The HTML used to set the header OR
headerContent : HTMLElement
The HTMLElement to append to the header

Returns:

void

This method is defined by Module.

show

public function show()

Shows the Module element by setting the visible configuration property to true. Also fires two events: beforeShowEvent prior to the visibility change, and showEvent after.

Parameters:

None.

Returns:

void

This method is defined by Module.

showIframe

public function showIframe()

Shows the iframe shim, if it has been enabled

Parameters:

None.

Returns:

void

This method is defined by Overlay.

showMacGeckoScrollbars

public function showMacGeckoScrollbars()

Removes a special CSS class from the Overlay when Mac/Gecko is in use, to work around a Gecko bug where scrollbars cannot be hidden. See https://bugzilla.mozilla.org/show_bug.cgi?id=187435

Parameters:

None.

Returns:

void

This method is defined by Overlay.

syncPosition

public function syncPosition()

Synchronizes the Panel's "xy", "x", and "y" properties with the Panel's position in the DOM. This is primarily used to update position information during drag & drop.

Parameters:

None.

Returns:

void

This method is defined by Overlay.

toString

public function toString()

Returns a string representation of the object.

Parameters:

None.

Returns:

String
The string representation of the Tooltip

This method is defined by Tooltip.

windowResizeHandler<static>

public function windowResizeHandler<static>(DOMEvent e)

<static> The DOM event handler used to fire the CustomEvent for window resize

Parameters:

e : DOMEvent
The DOM resize event

Returns:

void

This method is defined by Overlay.

windowScrollHandler<static>

public function windowScrollHandler<static>(DOMEvent e)

<static> The DOM event handler used to fire the CustomEvent for window scroll

Parameters:

e : DOMEvent
The DOM scroll event

Returns:

void

This method is defined by Overlay.

Event Details

YAHOO.widget.Overlay.windowResizeEvent

public event YAHOO.widget.Overlay.windowResizeEvent

A singleton CustomEvent used for reacting to the DOM event for window resize

Subscribers will be called with the following parameters:

None.

This event is defined by Overlay.

YAHOO.widget.Overlay.windowScrollEvent

public event YAHOO.widget.Overlay.windowScrollEvent

A singleton CustomEvent used for reacting to the DOM event for window scroll

Subscribers will be called with the following parameters:

None.

This event is defined by Overlay.

appendEvent

public event appendEvent

CustomEvent fired when the Module is appended to the DOM

Subscribers will be called with the following parameters:

None.

This event is defined by Module.

beforeHideEvent

public event beforeHideEvent

CustomEvent fired before the Module is hidden

Subscribers will be called with the following parameters:

None.

This event is defined by Module.

beforeInitEvent

public event beforeInitEvent

CustomEvent fired prior to class initalization.

Subscribers will be called with the following parameters:

classRef : class
class reference of the initializing class, such as this.beforeInitEvent.fire(YAHOO.widget.Module)

This event is defined by Module.

beforeMoveEvent

public event beforeMoveEvent

CustomEvent fired before the Overlay is moved.

Subscribers will be called with the following parameters:

x : Number
x coordinate
y : Number
y coordinate

This event is defined by Overlay.

beforeRenderEvent

public event beforeRenderEvent

CustomEvent fired before the Module is rendered

Subscribers will be called with the following parameters:

None.

This event is defined by Module.

beforeShowEvent

public event beforeShowEvent

CustomEvent fired before the Module is shown

Subscribers will be called with the following parameters:

None.

This event is defined by Module.

changeBodyEvent

public event changeBodyEvent

CustomEvent fired when the body content of the Module is modified

Subscribers will be called with the following parameters:

content : String/HTMLElement
String/element representing the new body content

This event is defined by Module.

changeContentEvent

public event changeContentEvent

CustomEvent fired when the content of the Module is modified

Subscribers will be called with the following parameters:

None.

This event is defined by Module.

changeFooterEvent

public event changeFooterEvent

CustomEvent fired when the footer content of the Module is modified

Subscribers will be called with the following parameters:

content : String/HTMLElement
String/element representing the new footer content

This event is defined by Module.

changeHeaderEvent

public event changeHeaderEvent

CustomEvent fired when the header content of the Module is modified

Subscribers will be called with the following parameters:

content : String/HTMLElement
String/element representing the new header content

This event is defined by Module.

destroyEvent

public event destroyEvent

CustomEvent fired when the Module is destroyed

Subscribers will be called with the following parameters:

None.

This event is defined by Module.

hideEvent

public event hideEvent

CustomEvent fired after the Module is hidden

Subscribers will be called with the following parameters:

None.

This event is defined by Module.

initEvent

public event initEvent

CustomEvent fired after class initalization.

Subscribers will be called with the following parameters:

classRef : class
class reference of the initializing class, such as this.beforeInitEvent.fire(YAHOO.widget.Module)

This event is defined by Module.

moveEvent

public event moveEvent

CustomEvent fired after the Overlay is moved.

Subscribers will be called with the following parameters:

x : Number
x coordinate
y : Number
y coordinate

This event is defined by Overlay.

renderEvent

public event renderEvent

CustomEvent fired after the Module is rendered

Subscribers will be called with the following parameters:

None.

This event is defined by Module.

showEvent

public event showEvent

CustomEvent fired after the Module is shown

Subscribers will be called with the following parameters:

None.

This event is defined by Module.