/** _onyx.Tooltip_ is a kind of onyx.Popup that works with an onyx.TooltipDecorator. It automatically displays a tooltip when the user hovers over the decorator. The tooltip is positioned around the decorator where there is available window space. {kind: "onyx.TooltipDecorator", components: [ {kind: "onyx.Button", content: "Tooltip"}, {kind: "onyx.Tooltip", content: "I'm a tooltip for a button."} ]} You may manually display the tooltip by calling its _show_ method. */ enyo.kind({ name: "onyx.Tooltip", kind: "onyx.Popup", classes: "onyx-tooltip below left-arrow", autoDismiss: false, showDelay: 500, defaultLeft: -6, //default margin-left value handlers: { onRequestShowTooltip: "requestShow", onRequestHideTooltip: "requestHide" }, requestShow: function() { this.showJob = setTimeout(enyo.bind(this, "show"), this.showDelay); return true; }, cancelShow: function() { clearTimeout(this.showJob); }, requestHide: function() { this.cancelShow(); return this.inherited(arguments); }, showingChanged: function() { this.cancelShow(); this.adjustPosition(true); this.inherited(arguments); }, applyPosition: function(inRect) { var s = "" for (n in inRect) { s += (n + ":" + inRect[n] + (isNaN(inRect[n]) ? "; " : "px; ")); } this.addStyles(s); }, adjustPosition: function(belowActivator) { if (this.showing && this.hasNode()) { var b = this.node.getBoundingClientRect(); //when the tooltip bottom goes below the window height move it above the decorator if (b.top + b.height > window.innerHeight) { this.addRemoveClass("below", false); this.addRemoveClass("above", true); } else { this.addRemoveClass("above", false); this.addRemoveClass("below", true); } //when the tooltip's right edge is out of the window, align it's right edge with the decorator left edge (approx) if (b.left + b.width > window.innerWidth){ this.applyPosition({'margin-left': -b.width, bottom: "auto"}); //use the right-arrow this.addRemoveClass("left-arrow", false); this.addRemoveClass("right-arrow", true); } } }, resizeHandler: function() { //reset the tooltip to align it's left edge with the decorator this.applyPosition({'margin-left': this.defaultLeft, bottom: "auto"}); this.addRemoveClass("left-arrow", true); this.addRemoveClass("right-arrow", false); this.adjustPosition(true); this.inherited(arguments); } });