web-apps/apps/common/main/lib/component/Tooltip.js
Maxim Kadushkin 741b10515d webapps added
2016-03-10 21:48:53 -03:00

123 lines
3.3 KiB
JavaScript

/**
* Tooltip.js
*
* Created by Maxim Kadushkin on 14 March 2014
* Copyright (c) 2014 Ascensio System SIA. All rights reserved.
*
*/
/*
* Configuration
* =============
*
* @cfg {String} title
*
* @cfg {String} placement
* Default value is 'top'.
* Describes tooltips position relatively of the parent component
* acceptable values: 'top', 'bottom', 'right', 'left', 'top-right/left', 'bottom-right/left', 'cursor'
* If placement = 'cursor', tooltip doesn't arrange position relatively
* of the parent and shows relatively of the cursor position.
*
* @cfg {String} offset
* The number of pixels to offset the tooltip from the parent component
*
* @cfg {String} cls
* An extra CSS class that will be added to tooltip dom-element.
*
*
* Methods
* =======
*
* @method setTitle
*
* @method show
* @params {Array} at - set predefined position for the tooltip
*
*
* Events
* ======
*
* @event tooltip:show
* Fires after the tooltip is shown
*
* @event tooltip:hide
* Fires after the tooltip is hidden
*
* */
define([
'tip',
'backbone'
], function () {
'use strict';
var Tooltip = function(options) {
this.$element =
this.placement = undefined;
this.init.call(this, options);
};
_.extend(Tooltip.prototype, Backbone.Events, {
init: function(opts) {
this.$element = opts.owner instanceof Backbone.View ? opts.owner.$el : $(opts.owner);
this.placement = opts.placement;
if (this.$element.data('bs.tooltip'))
this.$element.removeData('bs.tooltip');
this.$element.tooltip({
title : opts.title,
trigger : 'manual',
placement : opts.placement,
offset : opts.offset,
cls : opts.cls,
html : opts.html,
hideonclick : opts.hideonclick
});
if (opts.hideonclick) {
var tip = this.$element.data('bs.tooltip');
if (tip) tip.tip().on('click', function() {tip.hide();});
}
this.$element.on('shown.bs.tooltip', _.bind(this.onTipShown, this));
this.$element.on('hidden.bs.tooltip', _.bind(this.onTipHidden, this));
},
show: function(at) {
this.getBSTip().show(at);
},
hide: function() {
this.getBSTip().hide();
},
setTitle: function(title) {
var tip = this.getBSTip();
if (tip) tip.options.title = title;
},
updateTitle: function() {
var tip = this.getBSTip();
tip.$tip.find('.tooltip-inner')[tip.options.html ? 'html' : 'text'](tip.options.title);
},
getBSTip: function() {
return this.$element.data('bs.tooltip');
},
onTipShown: function() {
this.trigger('tooltip:show', this);
},
onTipHidden: function() {
this.trigger('tooltip:hide', this);
},
isVisible: function() {
return this.getBSTip().tip().is(':visible');
}
});
Common.UI = Common.UI || {};
Common.UI.Tooltip = Tooltip;
});