Merge pull request #1805 from pjmagee/master

Added definitions for JQuery plugin tooltipster

README.md

@@ -157,6 +157,7 @@ List of Definitions
 * [jQuery.Timer](http://jchavannes.com/jquery-timer/demo) (by [Joshua Strobl](https://github.com/JoshStrobl))
 * [jQuery.TinyCarousel](http://baijs.nl/tinycarousel/) (by [Christiaan Rakowski](https://github.com/csrakowski))
 * [jQuery.TinyScrollbar](http://baijs.nl/tinyscrollbar/) (by [Christiaan Rakowski](https://github.com/csrakowski))
+* [jQuery.tooltipster] (https://github.com/iamceege/tooltipster) (by [Patrick Magee](https://github.com/pjmagee))
 * [jQuery.Transit](http://ricostacruz.com/jquery.transit/) (by [MrBigDog2U](https://github.com/MrBigDog2U))
 * [jQuery.Validation](http://bassistance.de/jquery-plugins/jquery-plugin-validation/) (by [Boris Yankov](https://github.com/borisyankov))
 * [jQuery.Watermark](http://jquery-watermark.googlecode.com) (by [Anwar Javed](https://github.com/anwarjaved))

jquery.tooltipster/jquery.tooltipster-tests.ts

@@ -0,0 +1,194 @@
+/// <reference path="jquery.tooltipster.d.ts" />
+
+// Type definition tests for jQuery Tooltipster 3.0.5
+// Project: https://github.com/iamceege/tooltipster
+// Definitions by: Patrick Magee <https://github.com/pjmagee/>
+// Definitions: https://github.com/borisyankov/DefinitelyTyped
+// Tests taken from the getting started section of the Tooltipster website
+
+$(document).ready(function () {
+
+    $('.tooltip').tooltipster();
+
+    $('#my-tooltip').tooltipster({
+        content: $('<span><img src="my-image.png" /> <strong>This text is in bold case !</strong></span>')
+    });
+});
+
+
+$(document).ready(function () {
+    $('.tooltip').tooltipster({
+        contentAsHTML: true
+    });
+});
+
+$('.tooltip').tooltipster({
+    theme: 'tooltipster-noir'
+});
+
+$('.tooltip').tooltipster({
+    animation: 'fade',
+    delay: 200,
+    theme: 'tooltipster-default',
+    touchDevices: false,
+    trigger: 'hover'
+});
+
+$.fn.tooltipster('setDefaults', {
+    position: 'bottom'
+});
+
+var myNewContent = '';
+
+function callback(): void {
+
+}
+
+// temporarily disable a tooltip from being able to open
+$('.tooltip').tooltipster('disable');
+
+// if a tooltip was disabled from opening, reenable its previous functionality
+$('.tooltip').tooltipster('enable');
+
+// hide and destroy tooltip functionality
+$('.tooltip').tooltipster('destroy');
+
+// return a tooltip's current content (if selector contains multiple origins, only the value of the first will be returned)
+$('.tooltip').tooltipster('content');
+
+// update tooltip content
+$('.tooltip').tooltipster('content', myNewContent);
+
+// reposition and resize the tooltip
+$('.tooltip').tooltipster('reposition');
+
+// return the HTML root element of the tooltip
+$('.tooltip').tooltipster('elementTooltip');
+
+// return the HTML root element of the icon if there is one, 'undefined' otherwise
+$('.tooltip').tooltipster('elementIcon');
+
+$('.tooltip').tooltipster({
+    content: 'Loading...',
+    functionBefore: function (origin, continueTooltip) {
+
+        // we'll make this function asynchronous and allow the tooltip to go ahead and show the loading notification while fetching our data
+        continueTooltip();
+
+        // next, we want to check if our data has already been cached
+        if (origin.data('ajax') !== 'cached') {
+            $.ajax({
+                type: 'POST',
+                url: 'example.php',
+                success: function (data) {
+                    // update our tooltip content with our returned data and cache it
+                    origin.tooltipster('content', data).data('ajax', 'cached');
+                }
+            });
+        }
+    }
+});
+
+
+
+$('.tooltip').tooltipster({
+    content: 'Loading...',
+    functionBefore: (origin, continueTooltip) => {
+
+        // we'll make this function asynchronous and allow the tooltip to go ahead and show the loading notification while fetching our data
+        continueTooltip();
+
+        // next, we want to check if our data has already been cached
+        if (origin.data('ajax') !== 'cached') {
+            $.ajax({
+                type: 'POST',
+                url: 'example.php',
+                success: function (data) {
+                    // update our tooltip content with our returned data and cache it
+                    origin.tooltipster('content', data).data('ajax', 'cached');
+                }
+            });
+        }
+    }
+});
+
+$('.tooltip').tooltipster({
+    functionInit: function (origin, content) {
+
+        if (content === 'This is bad content') {
+
+            // when the request has finished loading, we will change the tooltip's content
+            $.ajax({
+                type: 'POST',
+                url: 'example.php',
+                success: function (data) {
+                    origin.tooltipster('content', 'New content has been loaded : ' + data);
+                }
+            });
+
+            // this returned string will overwrite the content of the tooltip for the time being
+            return 'Wait while we load new content...';
+        }
+        else {
+            // return nothing : the initialization continues normally with its content unchanged.
+        }
+    }
+});
+
+$('.tooltip').tooltipster({
+    functionInit: (origin, content) => {
+
+        if (content === 'This is bad content') {
+
+            // when the request has finished loading, we will change the tooltip's content
+            $.ajax({
+                type: 'POST',
+                url: 'example.php',
+                success: function (data) {
+                    origin.tooltipster('content', 'New content has been loaded : ' + data);
+                }
+            });
+
+            // this returned string will overwrite the content of the tooltip for the time being
+            return 'Wait while we load new content...';
+        }
+        else {
+            // return nothing : the initialization continues normally with its content unchanged.
+        }
+    }
+});
+
+$(document).ready(function () {
+
+    // first on page load, initiate the Tooltipster plugin
+    $('.tooltip').tooltipster();
+
+    // then immediately show the tooltip
+    $('#example').tooltipster('show');
+
+    // as soon as a key is pressed on the keyboard, hide the tooltip.
+    $(window).keypress(function () {
+        $('#example').tooltipster('hide');
+    });
+});
+
+$(document).ready(function () {
+
+    $('.tooltip').tooltipster();
+
+    $('#example').tooltipster('show', function () {
+        alert('The tooltip is now fully open. The content is: ' + this.tooltipster('content'));
+    });
+
+    $('#example').tooltipster('show', () => {
+        alert('The tooltip is now fully open. The content is: ' + this.tooltipster('content'));
+    });
+
+    $(window).keypress(function () {
+        $('#example').tooltipster('hide', function () {
+            alert('The tooltip is now fully closed');
+        });
+    });
+});
+
+$('#my-special-tooltip').tooltipster('content', 'My new content');

jquery.tooltipster/jquery.tooltipster-tests.ts.tscparams

@@ -0,0 +1 @@
+""

jquery.tooltipster/jquery.tooltipster.d.ts

@@ -0,0 +1,186 @@
+// Type definitions for jQuery Tooltipster 3.0.5
+// Project: https://github.com/iamceege/tooltipster
+// Definitions by: Patrick Magee <https://github.com/pjmagee/>
+// Definitions: https://github.com/borisyankov/DefinitelyTyped
+
+/// <reference path="../jquery/jquery.d.ts" />
+
+interface JQueryTooltipsterOptions {
+    /**
+    * Determines how the tooltip will animate in and out. Feel free to modify or create custom transitions in the tooltipster.css file. In IE9 and 8, all animations default to a JavaScript generated, fade animation. Default: 'fade'
+    * fade, grow, swing, slide, fall
+    */
+    animation?: string;
+    /**
+    * Adds the "speech bubble arrow" to the tooltip. Default: true
+    */
+    arrow?: boolean;
+    /**
+    * Select a specific color for the "speech bubble arrow". Default: will inherit the tooltip's background color
+    * hex code / rgb
+    */
+    arrowColor?: any;
+    /**
+    * If autoClose is set to false, the tooltip will never close unless you call the 'close' method yourself. Default: true
+    */
+    autoClose?: boolean;
+    /**
+    * If set, this will override the content of the tooltip. Default: null
+    * @type string, jQuery object
+    */
+    content?: any;
+    /**
+    * If the content of the tooltip is provided as a string, it is displayed as plain text by default. If this content should actually be interpreted as HTML, set this option to true. Default: false
+    */
+    contentAsHTML?: boolean;
+    /**
+    * If you provide a jQuery object to the 'content' option, this sets if it is a clone of this object that should actually be used. Default: true
+    */
+    contentCloning?: boolean;
+    /**
+    * Delay how long it takes (in milliseconds) for the tooltip to start animating in. Default: 200
+    */
+    delay?: number;
+    /**
+    * Set a fixed width for the tooltip. The tooltip will always be a consistent width - no matter your content size. Default: 0 (auto width)
+    */
+    fixedWidth?: number;
+    /**
+    * Set a max width for the tooltip. If the tooltip ends up being smaller than the set max width, the tooltip's width will be set automatically. Default: 0 (no max width)
+    */
+    maxWidth?: number;
+    /**
+    * Create a custom function to be fired only once at instantiation. If the function returns a value, this value will become the content of the tooltip. See the advanced section to learn more. Default: function(origin, content) {}
+    */
+    functionInit?: (origin, content) => any;
+    /**
+    * Create a custom function to be fired before the tooltip opens. This function may prevent or hold off the opening. See the advanced section to learn more. Default: function(origin, continueTooltip) { continueTooltip(); }
+    */
+    functionBefore?: (origin, continueTooltip) => void;
+    /**
+    * Create a custom function to be fired when the tooltip and its contents have been added to the DOM. Default: function(origin, tooltip) {}
+    */
+    functionReady?: (origin, tooltip) => void;
+    /**
+    * Create a custom function to be fired once the tooltip has been closed and removed from the DOM. Default: function(origin) {}
+    */
+    functionAfter?: (origin) => void;
+    /**
+    * If using the iconDesktop or iconTouch options, this sets the content for your icon. Default: '(?)'
+    * @type string, jQuery object
+    */
+    icon?: any;
+    /**
+    * If you provide a jQuery object to the 'icon' option, this sets if it is a clone of this object that should actually be used. Default: true
+    */
+    iconCloning?: boolean;
+    /**
+    * Generate an icon next to your content that is responsible for activating the tooltip on non-touch devices. Default: false
+    */
+    iconDesktop?: boolean;
+    /**
+    * If using the iconDesktop or iconTouch options, this sets the class on the icon (used to style the icon). Default: 'tooltipster-icon'
+    */
+    iconTheme?: string;
+    /**
+    * Generate an icon next to your content that is responsible for activating the tooltip on touch devices (tablets, phones, etc). Default: false
+    */
+    iconTouch?: boolean;
+    /**
+    * Give users the possibility to interact with the tooltip. Unless autoClose is set to false, the tooltip will still close if the user moves away from or clicks out of the tooltip. Default: false
+    */
+    interactive?: boolean;
+    /**
+    * If the tooltip is interactive and activated by a hover event, set the amount of time (milliseconds) allowed for a user to hover off of the tooltip activator (origin) on to the tooltip itself - keeping the tooltip from closing. Default: 350
+    */
+    interactiveTolerance?: number;
+    /**
+    * Offsets the tooltip (in pixels) farther left/right from the origin. Default: 0
+    */
+    offsetX?: number;
+    /**
+    * Offsets the tooltip (in pixels) farther up/down from the origin. Default: 0
+    */
+    offsetY?: number;
+    /**
+    * If true, only one tooltip will be allowed to be active at a time. Non-autoclosing tooltips will not be closed though. Default: false
+    */
+    onlyOne?: boolean;
+    /**
+    * Set the position of the tooltip. Default: 'top'
+    * right, left, top, top-right, top-left, bottom, bottom-right, bottom-left
+    */
+    position?: string;
+    /**
+    * Will reposition the tooltip if the origin moves. As this option may have an impact on performance, we suggest you enable it only if you need to. Default: false
+    */
+    positionTracker?: boolean;
+    /**
+    * Set the speed of the animation. Default: 350
+    */
+    speed?: number;
+    /**
+    * How long the tooltip should be allowed to live before closing. Default: 0 (disabled)
+    */
+    timer?: number;
+    /**
+    * Set the theme used for your tooltip. Default: 'tooltipster-default'
+    */
+    theme?: string;
+    /**
+    * If set to false, tooltips will not show on pure-touch devices, unless you open them yourself with the 'show' method. Touch gestures on devices which also have a mouse will still open the tooltips though. Default: true
+    */
+    touchDevices?: boolean;
+    /**
+    * Set how tooltips should be activated and closed. See the advanced section to learn how to build custom triggers. Default: 'hover'
+    * hover, click, custom
+    */
+    trigger?: string;
+    /**
+    * If a tooltip is open while its content is updated, play a subtle animation when the content changes. Default: true
+    */
+    updateAnimation?: boolean;
+}
+
+interface JQuery {
+    /**
+    * Initiate the Tooltipster plugin
+    */ 
+    tooltipster(): void;
+    /**
+    * Creates a new tooltip with the specified, or default, options.
+    * @param options The options
+    * @example
+    * $('.tooltip').tooltipster({
+    *   animation: 'fade',
+    *   delay: 200,
+    *   theme: 'tooltipster-default',
+    *   touchDevices: false,
+    *   trigger: 'hover'
+    * });
+    */
+    tooltipster(options?: JQueryTooltipsterOptions): JQuery;
+    /**
+    * Updates an existing tinyscrollbar with the specified, or default, options.
+    * @param options The options
+    * @param callback optional argument callback
+    * @example
+    * $(window).keypress(function() {
+    *     $('#example').tooltipster('hide', function() {
+    *         alert('The tooltip is now fully closed');
+    *      });
+    * });
+    */
+    tooltipster(method: string, callback?: Function): JQuery;
+    /**
+    * Call a method trigger with optional paramter
+    * @example $('#my-special-tooltip').tooltipster('content', 'My new content');
+    * @example
+    * $('#example').tooltipster('show', function() {
+    *   alert('The tooltip is now fully open. The content is: ' + this.tooltipster('content'));
+    * });
+    */
+    tooltipster(method: string, param?: string): any;
+
+}
+

jquery.tooltipster/jquery.tooltipster.d.ts.tscparams

@@ -0,0 +1 @@
+""