---

relatedTarget

---

Identifies a secondary target for the event.

Syntax

sTargetObj = event.relatedTarget
 

Parameters

sTargetObj is a reference to an additional event target.

Example

var rel = event.relatedTarget; // dump("LEAVING " + (rel ? rel.localName : "null") + "\n"); // relatedTarget is null when the titletip is first shown: // a mouseout event fires because the mouse is exiting // the main window and entering the titletip "window". // relatedTarget is also null when the mouse exits the main // window completely, so count how many times relatedTarget // was null after titletip is first shown and hide popup // the 2nd time if (!rel) {   ++this._mouseOutCount;   if (this._mouseOutCount > 1)     this.hidePopup();   return; } // find out if the node we are entering is one of our // anonymous children while (rel) {   if (rel == this)     break;   rel.parentNode; } // if the entered node is not a descendant of ours, hide // the tooltip if (rel != this && this._isMouseOver) {   this.hidePopup(); }

Notes

From the W3 spec: "Currently this attribute is used with the mouseover event to indicate the EventTarget which the pointing device exited and with the mouseout event to indicate the EventTarget which the pointing device entered."

The example above is typical: the relatedTarget property is used to find the other element, if any, involved in an event. Events like mouseovers are oriented around a certain target, but may also involve a secondary target, such as the target that is exited as the mouseover fires for the primary target.

Specification

relatedTarget