').parent().appendTo( this.content ); } this.reposition(); }, /** * Repositions the pointer. * * Makes sure the pointer is the correct size for its content and makes sure it * is positioned to point to the right element. * * @since 3.3.0 */ reposition: function() { var position; if ( this.options.disabled ) return; position = this._processPosition( this.options.position ); // Reposition pointer. this.pointer.css({ top: 0, left: 0, zIndex: zindex++ // Increment the z-index so that it shows above other opened pointers. }).show().position($.extend({ of: this.element, collision: 'fit none' }, position )); // The object comes before this.options.position so the user can override position.of. this.repoint(); }, /** * Sets the arrow of the pointer to the correct side of the pointer element. * * @since 3.3.0 */ repoint: function() { var o = this.options, edge; if ( o.disabled ) return; edge = ( typeof o.position == 'string' ) ? o.position : o.position.edge; // Remove arrow classes. this.pointer[0].className = this.pointer[0].className.replace( /wp-pointer-[^\s'"]*/, '' ); // Add arrow class. this.pointer.addClass( 'wp-pointer-' + edge ); }, /** * Calculates the correct position based on a position in the settings. * * @since 3.3.0 * @private * * @param {string|Object} position Either a side of a pointer or an object * containing a pointer. * * @return {Object} result An object containing position related data. */ _processPosition: function( position ) { var opposite = { top: 'bottom', bottom: 'top', left: 'right', right: 'left' }, result; // If the position object is a string, it is shorthand for position.edge. if ( typeof position == 'string' ) { result = { edge: position + '' }; } else { result = $.extend( {}, position ); } if ( ! result.edge ) return result; if ( result.edge == 'top' || result.edge == 'bottom' ) { result.align = result.align || 'left'; result.at = result.at || result.align + ' ' + opposite[ result.edge ]; result.my = result.my || result.align + ' ' + result.edge; } else { result.align = result.align || 'top'; result.at = result.at || opposite[ result.edge ] + ' ' + result.align; result.my = result.my || result.edge + ' ' + result.align; } return result; }, /** * Opens the pointer. * * Only opens the pointer widget in case it is closed and not disabled, and * calls 'update' before doing so. Calling update makes sure that the pointer * is correctly sized and positioned. * * @since 3.3.0 * * @param {Object} event The event that triggered the opening of this pointer. */ open: function( event ) { var self = this, o = this.options; if ( this.active || o.disabled || this.element.is(':hidden') ) return; this.update().done( function() { self._open( event ); }); }, /** * Opens and shows the pointer element. * * @since 3.3.0 * @private * * @param {Object} event An event object. */ _open: function( event ) { var self = this, o = this.options; if ( this.active || o.disabled || this.element.is(':hidden') ) return; this.active = true; this._trigger( 'open', event, this._handoff() ); this._trigger( 'show', event, this._handoff({ opened: function() { self._trigger( 'opened', event, self._handoff() ); } })); }, /** * Closes and hides the pointer element. * * @since 3.3.0 * * @param {Object} event An event object. */ close: function( event ) { if ( !this.active || this.options.disabled ) return; var self = this; this.active = false; this._trigger( 'close', event, this._handoff() ); this._trigger( 'hide', event, this._handoff({ closed: function() { self._trigger( 'closed', event, self._handoff() ); } })); }, /** * Puts the pointer on top by increasing the z-index. * * @since 3.3.0 */ sendToTop: function() { if ( this.active ) this.pointer.css( 'z-index', zindex++ ); }, /** * Toggles the element between shown and hidden. * * @since 3.3.0 * * @param {Object} event An event object. */ toggle: function( event ) { if ( this.pointer.is(':hidden') ) this.open( event ); else this.close( event ); }, /** * Extends the pointer and the widget element with the supplied parameter, which * is either an element or a function. * * @since 3.3.0 * @private * * @param {Object} extend The object to be merged into the original object. * * @return {Object} The extended object. */ _handoff: function( extend ) { return $.extend({ pointer: this.pointer, element: this.element }, extend); } }); })(jQuery);