jQuery: 使用插件Tipsy将工具提示附加到鼠标指针位置

3
我一直在使用一个名为Tipsy的旧版jQuery插件。我喜欢工具提示的外观,并且大部分时间我都很喜欢这个插件。不幸的是,它只显示相对于检索工具提示的元素的工具提示。我想将工具提示显示在鼠标光标的位置。有没有办法做到这一点?如果可能的话,我个人愿意使用这个工具提示插件。
我尝试过玩弄这个插件一段时间,但是代码超出了我目前对jQuery的了解范围。我认为捕获“show”函数触发事件时会让我获取事件被触发的坐标,但这并没有起作用。非常感谢任何帮助。我将在下面显示源JS文件:
// tipsy, facebook style tooltips for jquery
// version 1.0.0a
// (c) 2008-2010 jason frame [jason@onehackoranother.com]
// releated under the MIT license

(function($) {

function fixTitle($ele) {
    if ($ele.attr('title') || typeof($ele.attr('original-title')) != 'string') {
        $ele.attr('original-title', $ele.attr('title') || '').removeAttr('title');
    }
}

function Tipsy(element, options) {
    this.$element = $(element);
    this.options = options;
    this.enabled = true;
    fixTitle(this.$element);
}

Tipsy.prototype = {
    show: function() {
        var title = this.getTitle();
        if (title && this.enabled) {
            var $tip = this.tip();

            $tip.find('.tipsy-inner')[this.options.html ? 'html' : 'text'](title);
            $tip[0].className = 'tipsy'; // reset classname in case of dynamic gravity
            $tip.remove().css({top: 0, left: 0, visibility: 'hidden', display: 'block'}).appendTo(document.body);

            var pos = $.extend({}, this.$element.offset(), {
                width: this.$element[0].offsetWidth,
                height: this.$element[0].offsetHeight
            });

            var actualWidth = $tip[0].offsetWidth, actualHeight = $tip[0].offsetHeight;
            var gravity = (typeof this.options.gravity == 'function')
                            ? this.options.gravity.call(this.$element[0])
                            : this.options.gravity;

            var tp;
            switch (gravity.charAt(0)) {
                case 'n':
                    tp = {top: pos.top + pos.height + this.options.offset, left: pos.left + pos.width / 2 - actualWidth / 2};
                    break;
                case 's':
                    tp = {top: pos.top - actualHeight - this.options.offset, left: pos.left + pos.width / 2 - actualWidth / 2};
                    break;
                case 'e':
                    tp = {top: pos.top + pos.height / 2 - actualHeight / 2, left: pos.left - actualWidth - this.options.offset};
                    break;
                case 'w':
                    tp = {top: pos.top + pos.height / 2 - actualHeight / 2, left: pos.left + pos.width + this.options.offset};
                    break;
            }

            if (gravity.length == 2) {
                if (gravity.charAt(1) == 'w') {
                    tp.left = pos.left + pos.width / 2 - 15;
                } else {
                    tp.left = pos.left + pos.width / 2 - actualWidth + 15;
                }
            }

            $tip.css(tp).addClass('tipsy-' + gravity);

            if (this.options.fade) {
                $tip.stop().css({opacity: 0, display: 'block', visibility: 'visible'}).animate({opacity: this.options.opacity});
            } else {
                $tip.css({visibility: 'visible', opacity: this.options.opacity});
            }
        }
    },

    hide: function() {
        if (this.options.fade) {
            this.tip().stop().fadeOut(function() { $(this).remove(); });
        } else {
            this.tip().remove();
        }
    },

    getTitle: function() {
        var title, $e = this.$element, o = this.options;
        fixTitle($e);
        var title, o = this.options;
        if (typeof o.title == 'string') {
            title = $e.attr(o.title == 'title' ? 'original-title' : o.title);
        } else if (typeof o.title == 'function') {
            title = o.title.call($e[0]);
        }
        title = ('' + title).replace(/(^\s*|\s*$)/, "");
        return title || o.fallback;
    },

    tip: function() {
        if (!this.$tip) {
            this.$tip = $('<div class="tipsy"></div>').html('<div class="tipsy-arrow"></div><div class="tipsy-inner"/></div>');
        }
        return this.$tip;
    },

    validate: function() {
        if (!this.$element[0].parentNode) {
            this.hide();
            this.$element = null;
            this.options = null;
        }
    },

    enable: function() { this.enabled = true; },
    disable: function() { this.enabled = false; },
    toggleEnabled: function() { this.enabled = !this.enabled; }
};

$.fn.tipsy = function(options) {

    if (options === true) {
        return this.data('tipsy');
    } else if (typeof options == 'string') {
        return this.data('tipsy')[options]();
    }

    options = $.extend({}, $.fn.tipsy.defaults, options);

    function get(ele) {
        var tipsy = $.data(ele, 'tipsy');
        if (!tipsy) {
            tipsy = new Tipsy(ele, $.fn.tipsy.elementOptions(ele, options));
            $.data(ele, 'tipsy', tipsy);
        }
        return tipsy;
    }

    function enter() {
        var tipsy = get(this);
        tipsy.hoverState = 'in';
        if (options.delayIn == 0) {
            tipsy.show();
        } else {
            setTimeout(function() { if (tipsy.hoverState == 'in') tipsy.show(); }, options.delayIn);
        }
    };

    function leave() {
        var tipsy = get(this);
        tipsy.hoverState = 'out';
        if (options.delayOut == 0) {
            tipsy.hide();
        } else {
            setTimeout(function() { if (tipsy.hoverState == 'out') tipsy.hide(); }, options.delayOut);
        }
    };

    if (!options.live) this.each(function() { get(this); });

    if (options.trigger != 'manual') {
        var binder   = options.live ? 'live' : 'bind',
            eventIn  = options.trigger == 'hover' ? 'mouseenter' : 'focus',
            eventOut = options.trigger == 'hover' ? 'mouseleave' : 'blur';
        this[binder](eventIn, enter)[binder](eventOut, leave);
    }

    return this;

};

$.fn.tipsy.defaults = {
    delayIn: 0,
    delayOut: 0,
    fade: false,
    fallback: '',
    gravity: 'n',
    html: false,
    live: false,
    offset: 0,
    opacity: 0.8,
    title: 'title',
    trigger: 'hover'
};

// Overwrite this method to provide options on a per-element basis.
// For example, you could store the gravity in a 'tipsy-gravity' attribute:
// return $.extend({}, options, {gravity: $(ele).attr('tipsy-gravity') || 'n' });
// (remember - do not modify 'options' in place!)
$.fn.tipsy.elementOptions = function(ele, options) {
    return $.metadata ? $.extend({}, options, $(ele).metadata()) : options;
};

$.fn.tipsy.autoNS = function() {
    return $(this).offset().top > ($(document).scrollTop() + $(window).height() / 2) ? 's' : 'n';
};

$.fn.tipsy.autoWE = function() {
    return $(this).offset().left > ($(document).scrollLeft() + $(window).width() / 2) ? 'e' : 'w';
};

})(jQuery);
1个回答

1

我之前不知道Tipsy,也找不到一个可以下载完整包的地方。所以我使用了你的代码,并从网站上找到了CSS和箭头图标来制作这个演示 -> http://jsfiddle.net/df108obx/

我在添加了一些代码的地方做了//ANSWER注释。我认为最好的方法是创建一个新的gravity样式"x",当激活Tipsy时,它会根据鼠标的位置放置工具提示。所以:

  1. mouse: {x:0, y:0}对象添加到默认选项中
  2. 现在在enter()函数中存储(e)鼠标位置
  3. show()函数的重力开关中添加了一个case 'x':

肯定还有改进的空间,但这可能是扩展Tipsy以新方式显示自己的良好框架。


这太棒了!非常感谢。现在唯一的问题是,如果我将鼠标悬停在屏幕边缘附近的项目上,则会使工具提示显示得太小。有没有办法解决这个问题?也许将工具提示放在光标下方会有所帮助? - Phillip
1
@Phillip,很高兴听到它对您有用。谢谢您接受答案。是的,还有许多缺少的东西。现在没有时间,但将在今晚或明天早上返回。与此同时,请考虑从bootstrap 2.3.x中提取提示工具-> http://getbootstrap.com/2.3.2/ 它像魅力一样工作,并且第三个代码(如果仅提取tooltipcode)几乎与tipsy相似。如果不是,建立一个针对tipsy的github将是一个好主意。正如我所说,我找不到可行的下载。 - davidkonrad
谢谢。这不是太大的问题,目前我只是使用了普通的重力设置。我也会在业余时间尝试调整一些东西。 - Phillip

网页内容由stack overflow 提供, 点击上面的
可以查看英文原文,
原文链接