powertip-rails 0.0.1

data/MIT-LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 mahm
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,25 @@
+# powertip-rails
+
+## Installation
+
+Add this to your `Gemfile`:
+
+```ruby
+group :assets do
+  gem 'sass-rails'
+  gem 'compass-rails'
+  gem 'powertip-rails'
+end
+```
+
+## Usage
+
+- [http://stevenbenner.github.com/jquery-powertip/](http://stevenbenner.github.com/jquery-powertip/)
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/lib/powertip-rails.rb

@@ -0,0 +1,6 @@
+require "powertip-rails/version"
+
+module PowertipRails
+  class Engine < ::Rails::Engine
+  end
+end

data/lib/powertip-rails/version.rb

@@ -0,0 +1,3 @@
+module PowertipRails
+  VERSION = "0.0.1"
+end

data/vendor/assets/javascripts/core.js

@@ -0,0 +1,257 @@
+/**
+ * PowerTip Core
+ *
+ * @fileoverview  Core variables, plugin object, and API.
+ * @link          http://stevenbenner.github.com/jquery-powertip/
+ * @author        Steven Benner (http://stevenbenner.com/)
+ * @requires      jQuery 1.7+
+ */
+
+// useful private variables
+var $document = $(window.document),
+	$window = $(window),
+	$body = $('body');
+
+// constants
+var DATA_DISPLAYCONTROLLER = 'displayController',
+	DATA_HASACTIVEHOVER = 'hasActiveHover',
+	DATA_FORCEDOPEN = 'forcedOpen',
+	DATA_HASMOUSEMOVE = 'hasMouseMove',
+	DATA_MOUSEONTOTIP = 'mouseOnToPopup',
+	DATA_ORIGINALTITLE = 'originalTitle',
+	DATA_POWERTIP = 'powertip',
+	DATA_POWERTIPJQ = 'powertipjq',
+	DATA_POWERTIPTARGET = 'powertiptarget',
+	RAD2DEG = 180 / Math.PI;
+
+/**
+ * Session data
+ * Private properties global to all powerTip instances
+ */
+var session = {
+	isTipOpen: false,
+	isFixedTipOpen: false,
+	isClosing: false,
+	tipOpenImminent: false,
+	activeHover: null,
+	currentX: 0,
+	currentY: 0,
+	previousX: 0,
+	previousY: 0,
+	desyncTimeout: null,
+	mouseTrackingActive: false,
+	delayInProgress: false
+};
+
+/**
+ * Collision enumeration
+ * @enum {number}
+ */
+var Collision = {
+	none: 0,
+	top: 1,
+	bottom: 2,
+	left: 4,
+	right: 8
+};
+
+/**
+ * Display hover tooltips on the matched elements.
+ * @param {(Object|string)} opts The options object to use for the plugin, or
+ *     the name of a method to invoke on the first matched element.
+ * @param {*=} [arg] Argument for an invoked method (optional).
+ * @return {jQuery} jQuery object for the matched selectors.
+ */
+$.fn.powerTip = function(opts, arg) {
+	// don't do any work if there were no matched elements
+	if (!this.length) {
+		return this;
+	}
+
+	// handle api method calls on the plugin, e.g. powerTip('hide')
+	if (typeof opts === 'string' && $.powerTip[opts]) {
+		return $.powerTip[opts].call(this, this, arg);
+	}
+
+	// extend options
+	var options = $.extend({}, $.fn.powerTip.defaults, opts),
+		tipController = new TooltipController(options);
+
+	// hook mouse tracking
+	initMouseTracking();
+
+	// setup the elements
+	this.each(function elementSetup() {
+		var $this = $(this),
+			dataPowertip = $this.data(DATA_POWERTIP),
+			dataElem = $this.data(DATA_POWERTIPJQ),
+			dataTarget = $this.data(DATA_POWERTIPTARGET),
+			title = $this.attr('title');
+
+		// handle repeated powerTip calls on the same element by destroying the
+		// original instance hooked to it and replacing it with this call
+		if ($this.data(DATA_DISPLAYCONTROLLER)) {
+			$.powerTip.destroy($this);
+			title = $this.attr('title');
+		}
+
+		// attempt to use title attribute text if there is no data-powertip,
+		// data-powertipjq or data-powertiptarget. If we do use the title
+		// attribute, delete the attribute so the browser will not show it
+		if (!dataPowertip && !dataTarget && !dataElem && title) {
+			$this.data(DATA_POWERTIP, title);
+			$this.data(DATA_ORIGINALTITLE, title);
+			$this.removeAttr('title');
+		}
+
+		// create hover controllers for each element
+		$this.data(
+			DATA_DISPLAYCONTROLLER,
+			new DisplayController($this, options, tipController)
+		);
+	});
+
+	// attach events to matched elements if the manual options is not enabled
+	if (!options.manual) {
+		this.on({
+			// mouse events
+			'mouseenter.powertip': function elementMouseEnter(event) {
+				$.powerTip.show(this, event);
+			},
+			'mouseleave.powertip': function elementMouseLeave() {
+				$.powerTip.hide(this);
+			},
+			// keyboard events
+			'focus.powertip': function elementFocus() {
+				$.powerTip.show(this);
+			},
+			'blur.powertip': function elementBlur() {
+				$.powerTip.hide(this, true);
+			},
+			'keydown.powertip': function elementKeyDown(event) {
+				// close tooltip when the escape key is pressed
+				if (event.keyCode === 27) {
+					$.powerTip.hide(this, true);
+				}
+			}
+		});
+	}
+
+	return this;
+};
+
+/**
+ * Default options for the powerTip plugin.
+ */
+$.fn.powerTip.defaults = {
+	fadeInTime: 200,
+	fadeOutTime: 100,
+	followMouse: false,
+	popupId: 'powerTip',
+	intentSensitivity: 7,
+	intentPollInterval: 100,
+	closeDelay: 100,
+	placement: 'n',
+	smartPlacement: false,
+	offset: 10,
+	mouseOnToPopup: false,
+	manual: false
+};
+
+/**
+ * Default smart placement priority lists.
+ * The first item in the array is the highest priority, the last is the lowest.
+ * The last item is also the default, which will be used if all previous options
+ * do not fit.
+ */
+$.fn.powerTip.smartPlacementLists = {
+	n: ['n', 'ne', 'nw', 's'],
+	e: ['e', 'ne', 'se', 'w', 'nw', 'sw', 'n', 's', 'e'],
+	s: ['s', 'se', 'sw', 'n'],
+	w: ['w', 'nw', 'sw', 'e', 'ne', 'se', 'n', 's', 'w'],
+	nw: ['nw', 'w', 'sw', 'n', 's', 'se', 'nw'],
+	ne: ['ne', 'e', 'se', 'n', 's', 'sw', 'ne'],
+	sw: ['sw', 'w', 'nw', 's', 'n', 'ne', 'sw'],
+	se: ['se', 'e', 'ne', 's', 'n', 'nw', 'se'],
+	'nw-alt': ['nw-alt', 'n', 'ne-alt', 'sw-alt', 's', 'se-alt', 'w', 'e'],
+	'ne-alt': ['ne-alt', 'n', 'nw-alt', 'se-alt', 's', 'sw-alt', 'e', 'w'],
+	'sw-alt': ['sw-alt', 's', 'se-alt', 'nw-alt', 'n', 'ne-alt', 'w', 'e'],
+	'se-alt': ['se-alt', 's', 'sw-alt', 'ne-alt', 'n', 'nw-alt', 'e', 'w']
+};
+
+/**
+ * Public API
+ */
+$.powerTip = {
+	/**
+	 * Attempts to show the tooltip for the specified element.
+	 * @param {jQuery|Element} element The element to open the tooltip for.
+	 * @param {jQuery.Event=} event jQuery event for hover intent and mouse
+	 *     tracking (optional).
+	 */
+	show: function apiShowTip(element, event) {
+		if (event) {
+			trackMouse(event);
+			session.previousX = event.pageX;
+			session.previousY = event.pageY;
+			$(element).data(DATA_DISPLAYCONTROLLER).show();
+		} else {
+			$(element).first().data(DATA_DISPLAYCONTROLLER).show(true, true);
+		}
+		return element;
+	},
+
+	/**
+	 * Repositions the tooltip on the element.
+	 * @param {jQuery|Element} element The element the tooltip is shown for.
+	 */
+	reposition: function apiResetPosition(element) {
+		$(element).first().data(DATA_DISPLAYCONTROLLER).resetPosition();
+		return element;
+	},
+
+	/**
+	 * Attempts to close any open tooltips.
+	 * @param {(jQuery|Element)=} element The element with the tooltip that
+	 *     should be closed (optional).
+	 * @param {boolean=} immediate Disable close delay (optional).
+	 */
+	hide: function apiCloseTip(element, immediate) {
+		if (element) {
+			$(element).first().data(DATA_DISPLAYCONTROLLER).hide(immediate);
+		} else {
+			if (session.activeHover) {
+				session.activeHover.data(DATA_DISPLAYCONTROLLER).hide(true);
+			}
+		}
+		return element;
+	},
+
+	/**
+	 * Destroy and roll back any powerTip() instance on the specified element.
+	 * @param {jQuery|Element} element The element with the powerTip instance.
+	 */
+	destroy: function apiDestroy(element) {
+		$(element).off('.powertip').each(function destroy() {
+			var $this = $(this),
+				dataAttributes = [
+					DATA_ORIGINALTITLE,
+					DATA_DISPLAYCONTROLLER,
+					DATA_HASACTIVEHOVER,
+					DATA_FORCEDOPEN
+				];
+
+			if ($this.data(DATA_ORIGINALTITLE)) {
+				$this.attr('title', $this.data(DATA_ORIGINALTITLE));
+				dataAttributes.push(DATA_POWERTIP);
+			}
+
+			$this.removeData(dataAttributes);
+		});
+		return element;
+	}
+};
+
+// API aliasing
+$.powerTip.showTip = $.powerTip.show;
+$.powerTip.closeTip = $.powerTip.hide;

data/vendor/assets/javascripts/csscoordinates.js

@@ -0,0 +1,34 @@
+/**
+ * PowerTip CSSCoordinates
+ *
+ * @fileoverview  CSSCoordinates object for describing CSS positions.
+ * @link          http://stevenbenner.github.com/jquery-powertip/
+ * @author        Steven Benner (http://stevenbenner.com/)
+ * @requires      jQuery 1.7+
+ */
+
+/**
+ * Creates a new CSSCoordinates object.
+ * @private
+ * @constructor
+ */
+function CSSCoordinates() {
+	var me = this;
+
+	// initialize object properties
+	me.top = 'auto';
+	me.left = 'auto';
+	me.right = 'auto';
+
+	/**
+	 * Set a property to a value.
+	 * @private
+	 * @param {string} property The name of the property.
+	 * @param {number} value The value of the property.
+	 */
+	me.set = function(property, value) {
+		if ($.isNumeric(value)) {
+			me[property] = Math.round(value);
+		}
+	};
+}

data/vendor/assets/javascripts/displaycontroller.js

@@ -0,0 +1,120 @@
+/**
+ * PowerTip DisplayController
+ *
+ * @fileoverview  DisplayController object used to manage tooltips for elements.
+ * @link          http://stevenbenner.github.com/jquery-powertip/
+ * @author        Steven Benner (http://stevenbenner.com/)
+ * @requires      jQuery 1.7+
+ */
+
+/**
+ * Creates a new tooltip display controller.
+ * @private
+ * @constructor
+ * @param {jQuery} element The element that this controller will handle.
+ * @param {Object} options Options object containing settings.
+ * @param {TooltipController} tipController The TooltipController object for
+ *     this instance.
+ */
+function DisplayController(element, options, tipController) {
+	var hoverTimer = null;
+
+	/**
+	 * Begins the process of showing a tooltip.
+	 * @private
+	 * @param {boolean=} immediate Skip intent testing (optional).
+	 * @param {boolean=} forceOpen Ignore cursor position and force tooltip to
+	 *     open (optional).
+	 */
+	function openTooltip(immediate, forceOpen) {
+		cancelTimer();
+		if (!element.data(DATA_HASACTIVEHOVER)) {
+			if (!immediate) {
+				session.tipOpenImminent = true;
+				hoverTimer = window.setTimeout(
+					function intentDelay() {
+						hoverTimer = null;
+						checkForIntent();
+					},
+					options.intentPollInterval
+				);
+			} else {
+				if (forceOpen) {
+					element.data(DATA_FORCEDOPEN, true);
+				}
+				tipController.showTip(element);
+			}
+		}
+	}
+
+	/**
+	 * Begins the process of closing a tooltip.
+	 * @private
+	 * @param {boolean=} disableDelay Disable close delay (optional).
+	 */
+	function closeTooltip(disableDelay) {
+		cancelTimer();
+		session.tipOpenImminent = false;
+		if (element.data(DATA_HASACTIVEHOVER)) {
+			element.data(DATA_FORCEDOPEN, false);
+			if (!disableDelay) {
+				session.delayInProgress = true;
+				hoverTimer = window.setTimeout(
+					function closeDelay() {
+						hoverTimer = null;
+						tipController.hideTip(element);
+						session.delayInProgress = false;
+					},
+					options.closeDelay
+				);
+			} else {
+				tipController.hideTip(element);
+			}
+		}
+	}
+
+	/**
+	 * Checks mouse position to make sure that the user intended to hover on the
+	 * specified element before showing the tooltip.
+	 * @private
+	 */
+	function checkForIntent() {
+		// calculate mouse position difference
+		var xDifference = Math.abs(session.previousX - session.currentX),
+			yDifference = Math.abs(session.previousY - session.currentY),
+			totalDifference = xDifference + yDifference;
+
+		// check if difference has passed the sensitivity threshold
+		if (totalDifference < options.intentSensitivity) {
+			tipController.showTip(element);
+		} else {
+			// try again
+			session.previousX = session.currentX;
+			session.previousY = session.currentY;
+			openTooltip();
+		}
+	}
+
+	/**
+	 * Cancels active hover timer.
+	 * @private
+	 */
+	function cancelTimer() {
+		hoverTimer = window.clearTimeout(hoverTimer);
+		session.delayInProgress = false;
+	}
+
+	/**
+	 * Repositions the tooltip on this element.
+	 * @private
+	 */
+	function repositionTooltip() {
+		tipController.resetPosition(element);
+	}
+
+	// expose the methods
+	this.show = openTooltip;
+	this.hide = closeTooltip;
+	this.cancel = cancelTimer;
+	this.resetPosition = repositionTooltip;
+}