diff --git a/build/build-plugins.js b/build/build-plugins.js index 2995e638e0..d048157253 100644 --- a/build/build-plugins.js +++ b/build/build-plugins.js @@ -42,7 +42,7 @@ const bsPlugins = { ScrollSpy: path.resolve(__dirname, '../js/src/scrollspy.js'), Tab: path.resolve(__dirname, '../js/src/tab.js'), Toast: path.resolve(__dirname, '../js/src/toast/toast.js'), - Tooltip: path.resolve(__dirname, '../js/src/tooltip.js') + Tooltip: path.resolve(__dirname, '../js/src/tooltip/tooltip.js') } const rootPath = '../js/dist/' diff --git a/js/index.esm.js b/js/index.esm.js index 0f48d63b4e..82fd33fbbd 100644 --- a/js/index.esm.js +++ b/js/index.esm.js @@ -15,7 +15,7 @@ import Popover from './src/popover/popover' import ScrollSpy from './src/scrollspy' import Tab from './src/tab' import Toast from './src/toast/toast' -import Tooltip from './src/tooltip' +import Tooltip from './src/tooltip/tooltip' export { Alert, diff --git a/js/index.umd.js b/js/index.umd.js index 03b58715ef..812a300441 100644 --- a/js/index.umd.js +++ b/js/index.umd.js @@ -15,7 +15,7 @@ import Popover from './src/popover/popover' import ScrollSpy from './src/scrollspy' import Tab from './src/tab' import Toast from './src/toast/toast' -import Tooltip from './src/tooltip' +import Tooltip from './src/tooltip/tooltip' export default { Alert, diff --git a/js/src/popover/popover.js b/js/src/popover/popover.js index 3a55083c43..c357a6e526 100644 --- a/js/src/popover/popover.js +++ b/js/src/popover/popover.js @@ -8,7 +8,7 @@ import { jQuery as $ } from '../util/index' import Data from '../dom/data' import SelectorEngine from '../dom/selector-engine' -import Tooltip from '../tooltip' +import Tooltip from '../tooltip/tooltip' /** * ------------------------------------------------------------------------ diff --git a/js/src/popover/popover.spec.js b/js/src/popover/popover.spec.js index cb16bf271a..003c0168f6 100644 --- a/js/src/popover/popover.spec.js +++ b/js/src/popover/popover.spec.js @@ -16,8 +16,8 @@ describe('Popover', () => { const popoverList = makeArray(document.querySelectorAll('.popover')) - popoverList.forEach(backdrop => { - document.body.removeChild(backdrop) + popoverList.forEach(popoverEl => { + document.body.removeChild(popoverEl) }) }) diff --git a/js/src/tooltip.js b/js/src/tooltip/tooltip.js similarity index 97% rename from js/src/tooltip.js rename to js/src/tooltip/tooltip.js index 6cca7d75a4..1db233e798 100644 --- a/js/src/tooltip.js +++ b/js/src/tooltip/tooltip.js @@ -16,16 +16,16 @@ import { makeArray, noop, typeCheckConfig -} from './util/index' +} from '../util/index' import { DefaultWhitelist, sanitizeHtml -} from './util/sanitizer' -import Data from './dom/data' -import EventHandler from './dom/event-handler' -import Manipulator from './dom/manipulator' +} from '../util/sanitizer' +import Data from '../dom/data' +import EventHandler from '../dom/event-handler' +import Manipulator from '../dom/manipulator' import Popper from 'popper.js' -import SelectorEngine from './dom/selector-engine' +import SelectorEngine from '../dom/selector-engine' /** * ------------------------------------------------------------------------ @@ -290,7 +290,7 @@ class Tooltip { this.config.placement const attachment = this._getAttachment(placement) - this.addAttachmentClass(attachment) + this._addAttachmentClass(attachment) const container = this._getContainer() Data.setData(tip, this.constructor.DATA_KEY, this) @@ -360,7 +360,7 @@ class Tooltip { } } - hide(callback) { + hide() { const tip = this.getTipElement() const complete = () => { if (this._hoverState !== HoverState.SHOW && tip.parentNode) { @@ -370,13 +370,7 @@ class Tooltip { this._cleanTipClass() this.element.removeAttribute('aria-describedby') EventHandler.trigger(this.element, this.constructor.Event.HIDDEN) - if (this._popper !== null) { - this._popper.destroy() - } - - if (callback) { - callback() - } + this._popper.destroy() } const hideEvent = EventHandler.trigger(this.element, this.constructor.Event.HIDE) @@ -421,10 +415,6 @@ class Tooltip { return Boolean(this.getTitle()) } - addAttachmentClass(attachment) { - this.getTipElement().classList.add(`${CLASS_PREFIX}-${attachment}`) - } - getTipElement() { if (this.tip) { return this.tip @@ -449,7 +439,7 @@ class Tooltip { return } - if (typeof content === 'object' && (content.nodeType || content.jquery)) { + if (typeof content === 'object' && isElement(content)) { if (content.jquery) { content = content[0] } @@ -492,6 +482,10 @@ class Tooltip { // Private + _addAttachmentClass(attachment) { + this.getTipElement().classList.add(`${CLASS_PREFIX}-${attachment}`) + } + _getOffset() { const offset = {} @@ -757,7 +751,7 @@ class Tooltip { const popperInstance = popperData.instance this.tip = popperInstance.popper this._cleanTipClass() - this.addAttachmentClass(this._getAttachment(popperData.placement)) + this._addAttachmentClass(this._getAttachment(popperData.placement)) } _fixTransition() { @@ -810,7 +804,7 @@ class Tooltip { * ------------------------------------------------------------------------ * add .tooltip to jQuery only if jQuery is present */ - +/* istanbul ignore if */ if (typeof $ !== 'undefined') { const JQUERY_NO_CONFLICT = $.fn[NAME] $.fn[NAME] = Tooltip._jQueryInterface diff --git a/js/src/tooltip/tooltip.spec.js b/js/src/tooltip/tooltip.spec.js new file mode 100644 index 0000000000..6f02dfa9b7 --- /dev/null +++ b/js/src/tooltip/tooltip.spec.js @@ -0,0 +1,1005 @@ +import Tooltip from './tooltip' +import EventHandler from '../dom/event-handler' +import { makeArray, noop } from '../util/index' + +/** Test helpers */ +import { getFixture, clearFixture, jQueryMock, createEvent } from '../../tests/helpers/fixture' + +describe('Tooltip', () => { + let fixtureEl + + beforeAll(() => { + fixtureEl = getFixture() + }) + + afterEach(() => { + clearFixture() + + const tooltipList = makeArray(document.querySelectorAll('.tooltip')) + + tooltipList.forEach(tooltipEl => { + document.body.removeChild(tooltipEl) + }) + }) + + describe('VERSION', () => { + it('should return plugin version', () => { + expect(Tooltip.VERSION).toEqual(jasmine.any(String)) + }) + }) + + describe('Default', () => { + it('should return plugin default config', () => { + expect(Tooltip.Default).toEqual(jasmine.any(Object)) + }) + }) + + describe('NAME', () => { + it('should return plugin name', () => { + expect(Tooltip.NAME).toEqual(jasmine.any(String)) + }) + }) + + describe('DATA_KEY', () => { + it('should return plugin data key', () => { + expect(Tooltip.DATA_KEY).toEqual('bs.tooltip') + }) + }) + + describe('Event', () => { + it('should return plugin events', () => { + expect(Tooltip.Event).toEqual(jasmine.any(Object)) + }) + }) + + describe('EVENT_KEY', () => { + it('should return plugin event key', () => { + expect(Tooltip.EVENT_KEY).toEqual('.bs.tooltip') + }) + }) + + describe('DefaultType', () => { + it('should return plugin default type', () => { + expect(Tooltip.DefaultType).toEqual(jasmine.any(Object)) + }) + }) + + describe('constructor', () => { + it('should not take care of disallowed data attributes', () => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + expect(tooltip.config.sanitize).toEqual(true) + }) + + it('should convert title and content to string if numbers', () => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl, { + title: 1, + content: 7 + }) + + expect(tooltip.config.title).toEqual('1') + expect(tooltip.config.content).toEqual('7') + }) + + it('should enable selector delegation', done => { + fixtureEl.innerHTML = '
' + + const containerEl = fixtureEl.querySelector('div') + const tooltipContainer = new Tooltip(containerEl, { + selector: 'a[rel="tooltip"]', + trigger: 'click' + }) + + containerEl.innerHTML = '
' + + const tooltipInContainerEl = containerEl.querySelector('a') + + tooltipInContainerEl.addEventListener('shown.bs.tooltip', () => { + expect(document.querySelector('.tooltip')).not.toBeNull() + tooltipContainer.dispose() + done() + }) + + tooltipInContainerEl.click() + }) + }) + + describe('enable', () => { + it('should enable a tooltip', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + tooltip.enable() + + tooltipEl.addEventListener('shown.bs.tooltip', () => { + expect(document.querySelector('.tooltip')).toBeDefined() + done() + }) + + tooltip.show() + }) + }) + + describe('disable', () => { + it('should disable tooltip', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + tooltip.disable() + + tooltipEl.addEventListener('show.bs.tooltip', () => { + throw new Error('should not show a disabled tooltip') + }) + + tooltip.show() + + setTimeout(() => { + expect().nothing() + done() + }, 10) + }) + }) + + describe('toggleEnabled', () => { + it('should toggle enabled', () => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + expect(tooltip._isEnabled).toEqual(true) + + tooltip.toggleEnabled() + + expect(tooltip._isEnabled).toEqual(false) + }) + }) + + describe('toggle', () => { + it('should do nothing if disabled', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + tooltip.disable() + + tooltipEl.addEventListener('show.bs.tooltip', () => { + throw new Error('should not show a disabled tooltip') + }) + + tooltip.toggle() + + setTimeout(() => { + expect().nothing() + done() + }, 10) + }) + + it('should show a tooltip', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + tooltipEl.addEventListener('shown.bs.tooltip', () => { + expect(document.querySelector('.tooltip')).toBeDefined() + done() + }) + + tooltip.toggle() + }) + + it('should call toggle and show the tooltip when trigger is "click"', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl, { + trigger: 'click' + }) + + spyOn(tooltip, 'toggle').and.callThrough() + + tooltipEl.addEventListener('shown.bs.tooltip', () => { + expect(tooltip.toggle).toHaveBeenCalled() + done() + }) + + tooltipEl.click() + }) + + it('should hide a tooltip', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + tooltipEl.addEventListener('shown.bs.tooltip', () => { + tooltip.toggle() + }) + + tooltipEl.addEventListener('hidden.bs.tooltip', () => { + expect(document.querySelector('.tooltip')).toBeNull() + done() + }) + + tooltip.toggle() + }) + + it('should call toggle and hide the tooltip when trigger is "click"', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl, { + trigger: 'click' + }) + + spyOn(tooltip, 'toggle').and.callThrough() + + tooltipEl.addEventListener('shown.bs.tooltip', () => { + tooltipEl.click() + }) + + tooltipEl.addEventListener('hidden.bs.tooltip', () => { + expect(tooltip.toggle).toHaveBeenCalled() + done() + }) + + tooltipEl.click() + }) + }) + + describe('dispose', () => { + it('should destroy a tooltip', () => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + expect(Tooltip._getInstance(tooltipEl)).toEqual(tooltip) + + tooltip.dispose() + + expect(Tooltip._getInstance(tooltipEl)).toEqual(null) + }) + + it('should destroy a tooltip and remove it from the dom', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + tooltipEl.addEventListener('shown.bs.tooltip', () => { + expect(document.querySelector('.tooltip')).toBeDefined() + + tooltip.dispose() + + expect(document.querySelector('.tooltip')).toBeNull() + done() + }) + + tooltip.show() + }) + }) + + describe('show', () => { + it('should show a tooltip', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + tooltipEl.addEventListener('shown.bs.tooltip', () => { + const tooltipShown = document.querySelector('.tooltip') + + expect(tooltipShown).toBeDefined() + expect(tooltipEl.getAttribute('aria-describedby')).toEqual(tooltipShown.getAttribute('id')) + expect(tooltipShown.getAttribute('id').indexOf('tooltip') !== -1).toEqual(true) + done() + }) + + tooltip.show() + }) + + it('should show a tooltip on mobile', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + document.documentElement.ontouchstart = noop + + spyOn(EventHandler, 'on') + + tooltipEl.addEventListener('shown.bs.tooltip', () => { + expect(document.querySelector('.tooltip')).not.toBeNull() + expect(EventHandler.on).toHaveBeenCalled() + document.documentElement.ontouchstart = undefined + done() + }) + + tooltip.show() + }) + + it('should show a tooltip relative to placement option', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl, { + placement: 'bottom' + }) + + tooltipEl.addEventListener('inserted.bs.tooltip', () => { + expect(tooltip.getTipElement().classList.contains('bs-tooltip-bottom')).toEqual(true) + }) + + tooltipEl.addEventListener('shown.bs.tooltip', () => { + const tooltipShown = document.querySelector('.tooltip') + + expect(tooltipShown.classList.contains('bs-tooltip-bottom')).toEqual(true) + done() + }) + + tooltip.show() + }) + + it('should not error when trying to show a tooltip that has been removed from the dom', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + const firstCallback = () => { + tooltipEl.removeEventListener('shown.bs.tooltip', firstCallback) + let tooltipShown = document.querySelector('.tooltip') + + tooltipShown.parentNode.removeChild(tooltipShown) + + tooltipEl.addEventListener('shown.bs.tooltip', () => { + tooltipShown = document.querySelector('.tooltip') + + expect(tooltipShown).not.toBeNull() + done() + }) + + tooltip.show() + } + + tooltipEl.addEventListener('shown.bs.tooltip', firstCallback) + + tooltip.show() + }) + + it('should show a tooltip with a dom element container', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl, { + container: fixtureEl + }) + + tooltipEl.addEventListener('shown.bs.tooltip', () => { + expect(fixtureEl.querySelector('.tooltip')).toBeDefined() + done() + }) + + tooltip.show() + }) + + it('should show a tooltip with a jquery element container', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl, { + container: { + 0: fixtureEl, + jquery: 'jQuery' + } + }) + + tooltipEl.addEventListener('shown.bs.tooltip', () => { + expect(fixtureEl.querySelector('.tooltip')).toBeDefined() + done() + }) + + tooltip.show() + }) + + it('should show a tooltip with a selector in container', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl, { + container: '#fixture' + }) + + tooltipEl.addEventListener('shown.bs.tooltip', () => { + expect(fixtureEl.querySelector('.tooltip')).toBeDefined() + done() + }) + + tooltip.show() + }) + + it('should show a tooltip with placement as a function', done => { + fixtureEl.innerHTML = '' + + const spy = jasmine.createSpy('placement').and.returnValue('top') + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl, { + placement: spy + }) + + tooltipEl.addEventListener('shown.bs.tooltip', () => { + expect(document.querySelector('.tooltip')).toBeDefined() + expect(spy).toHaveBeenCalled() + done() + }) + + tooltip.show() + }) + + it('should show a tooltip with offset as a function', done => { + fixtureEl.innerHTML = '' + + const spy = jasmine.createSpy('offset').and.returnValue({}) + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl, { + offset: spy + }) + + tooltipEl.addEventListener('shown.bs.tooltip', () => { + expect(document.querySelector('.tooltip')).toBeDefined() + expect(spy).toHaveBeenCalled() + done() + }) + + tooltip.show() + }) + + it('should show a tooltip without the animation', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl, { + animation: false + }) + + tooltipEl.addEventListener('shown.bs.tooltip', () => { + const tip = document.querySelector('.tooltip') + + expect(tip).toBeDefined() + expect(tip.classList.contains('fade')).toEqual(false) + done() + }) + + tooltip.show() + }) + + it('should throw an error the element is not visible', () => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + try { + tooltip.show() + } catch (error) { + expect(error.message).toEqual('Please use show on visible elements') + } + }) + + it('should not show a tooltip if show.bs.tooltip is prevented', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + const expectedDone = () => { + setTimeout(() => { + expect(document.querySelector('.tooltip')).toBeNull() + done() + }, 10) + } + + tooltipEl.addEventListener('show.bs.tooltip', ev => { + ev.preventDefault() + expectedDone() + }) + + tooltipEl.addEventListener('shown.bs.tooltip', () => { + throw new Error('Tooltip should not be shown') + }) + + tooltip.show() + }) + + it('should show tooltip if leave event hasn\'t occurred before delay expires', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl, { + delay: 150 + }) + + spyOn(tooltip, 'show') + + setTimeout(() => { + expect(tooltip.show).not.toHaveBeenCalled() + }, 100) + + setTimeout(() => { + expect(tooltip.show).toHaveBeenCalled() + done() + }, 200) + + tooltipEl.dispatchEvent(createEvent('mouseover')) + }) + + it('should not show tooltip if leave event occurs before delay expires', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl, { + delay: 150 + }) + + spyOn(tooltip, 'show') + + setTimeout(() => { + expect(tooltip.show).not.toHaveBeenCalled() + tooltipEl.dispatchEvent(createEvent('mouseover')) + }, 100) + + setTimeout(() => { + expect(tooltip.show).toHaveBeenCalled() + expect(document.querySelectorAll('.tooltip').length).toEqual(0) + done() + }, 200) + + tooltipEl.dispatchEvent(createEvent('mouseover')) + }) + + it('should not hide tooltip if leave event occurs and enter event occurs within the hide delay', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl, { + delay: { + show: 0, + hide: 150 + } + }) + + setTimeout(() => { + expect(tooltip.getTipElement().classList.contains('show')).toEqual(true) + tooltipEl.dispatchEvent(createEvent('mouseout')) + + setTimeout(() => { + expect(tooltip.getTipElement().classList.contains('show')).toEqual(true) + tooltipEl.dispatchEvent(createEvent('mouseover')) + }, 100) + + setTimeout(() => { + expect(tooltip.getTipElement().classList.contains('show')).toEqual(true) + done() + }, 200) + }, 0) + + tooltipEl.dispatchEvent(createEvent('mouseover')) + }) + }) + + describe('hide', () => { + it('should hide a tooltip', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + tooltipEl.addEventListener('shown.bs.tooltip', () => tooltip.hide()) + tooltipEl.addEventListener('hidden.bs.tooltip', () => { + expect(document.querySelector('.tooltip')).toBeNull() + expect(tooltipEl.getAttribute('aria-describedby')).toBeNull() + done() + }) + + tooltip.show() + }) + + it('should hide a tooltip on mobile', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + tooltipEl.addEventListener('shown.bs.tooltip', () => { + document.documentElement.ontouchstart = noop + spyOn(EventHandler, 'off') + tooltip.hide() + }) + + tooltipEl.addEventListener('hidden.bs.tooltip', () => { + expect(document.querySelector('.tooltip')).toBeNull() + expect(EventHandler.off).toHaveBeenCalled() + document.documentElement.ontouchstart = undefined + done() + }) + + tooltip.show() + }) + + it('should hide a tooltip without animation', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl, { + animation: false + }) + + tooltipEl.addEventListener('shown.bs.tooltip', () => tooltip.hide()) + tooltipEl.addEventListener('hidden.bs.tooltip', () => { + expect(document.querySelector('.tooltip')).toBeNull() + expect(tooltipEl.getAttribute('aria-describedby')).toBeNull() + done() + }) + + tooltip.show() + }) + + it('should not hide a tooltip if hide event is prevented', done => { + fixtureEl.innerHTML = '' + + const assertDone = () => { + setTimeout(() => { + expect(document.querySelector('.tooltip')).not.toBeNull() + done() + }, 20) + } + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl, { + animation: false + }) + + tooltipEl.addEventListener('shown.bs.tooltip', () => tooltip.hide()) + tooltipEl.addEventListener('hide.bs.tooltip', event => { + event.preventDefault() + assertDone() + }) + tooltipEl.addEventListener('hidden.bs.tooltip', () => { + throw new Error('should not trigger hidden event') + }) + + tooltip.show() + }) + }) + + describe('update', () => { + it('should call popper schedule update', done => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + tooltipEl.addEventListener('shown.bs.tooltip', () => { + spyOn(tooltip._popper, 'scheduleUpdate') + + tooltip.update() + + expect(tooltip._popper.scheduleUpdate).toHaveBeenCalled() + done() + }) + + tooltip.show() + }) + + it('should do nothing if the tooltip is not shown', () => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + tooltip.update() + expect().nothing() + }) + }) + + describe('isWithContent', () => { + it('should return true if there is content', () => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + expect(tooltip.isWithContent()).toEqual(true) + }) + + it('should return false if there is no content', () => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + expect(tooltip.isWithContent()).toEqual(false) + }) + }) + + describe('getTipElement', () => { + it('should create the tip element and return it', () => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + spyOn(document, 'createElement').and.callThrough() + + expect(tooltip.getTipElement()).toBeDefined() + expect(document.createElement).toHaveBeenCalled() + }) + + it('should return the created tip element', () => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + const spy = spyOn(document, 'createElement').and.callThrough() + + expect(tooltip.getTipElement()).toBeDefined() + expect(spy).toHaveBeenCalled() + + spy.calls.reset() + + expect(tooltip.getTipElement()).toBeDefined() + expect(spy).not.toHaveBeenCalled() + }) + }) + + describe('setContent', () => { + it('should set tip content', () => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + tooltip.setContent() + + const tip = tooltip.getTipElement() + + expect(tip.classList.contains('show')).toEqual(false) + expect(tip.classList.contains('fade')).toEqual(false) + expect(tip.querySelector('.tooltip-inner').textContent).toEqual('Another tooltip') + }) + }) + + describe('setElementContent', () => { + it('should do nothing if the element is null', () => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + tooltip.setElementContent(null, null) + expect().nothing() + }) + + it('should add the content as a child of the element', () => { + fixtureEl.innerHTML = [ + '', + '
' + ].join('') + + const tooltipEl = fixtureEl.querySelector('a') + const childContent = fixtureEl.querySelector('div') + const tooltip = new Tooltip(tooltipEl, { + html: true + }) + + tooltip.setElementContent(tooltip.getTipElement(), childContent) + + expect(childContent.parentNode).toEqual(tooltip.getTipElement()) + }) + + it('should do nothing if the content is a child of the element', () => { + fixtureEl.innerHTML = [ + '
', + '
' + ].join('') + + const tooltipEl = fixtureEl.querySelector('a') + const childContent = fixtureEl.querySelector('div') + const tooltip = new Tooltip(tooltipEl, { + html: true + }) + + tooltip.getTipElement().appendChild(childContent) + tooltip.setElementContent(tooltip.getTipElement(), childContent) + + expect().nothing() + }) + + it('should add the content as a child of the element for jQuery elements', () => { + fixtureEl.innerHTML = [ + '
', + '
' + ].join('') + + const tooltipEl = fixtureEl.querySelector('a') + const childContent = fixtureEl.querySelector('div') + const tooltip = new Tooltip(tooltipEl, { + html: true + }) + + tooltip.setElementContent(tooltip.getTipElement(), { 0: childContent, jquery: 'jQuery' }) + + expect(childContent.parentNode).toEqual(tooltip.getTipElement()) + }) + + it('should add the child text content in the element', () => { + fixtureEl.innerHTML = [ + '
', + '
Tooltip
' + ].join('') + + const tooltipEl = fixtureEl.querySelector('a') + const childContent = fixtureEl.querySelector('div') + const tooltip = new Tooltip(tooltipEl) + + tooltip.setElementContent(tooltip.getTipElement(), childContent) + + expect(childContent.textContent).toEqual(tooltip.getTipElement().textContent) + }) + + it('should add html without sanitize it', () => { + fixtureEl.innerHTML = '
' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl, { + sanitize: false, + html: true + }) + + tooltip.setElementContent(tooltip.getTipElement(), '
Tooltip
') + + expect(tooltip.getTipElement().querySelector('div').id).toEqual('childContent') + }) + + it('should add html sanitized', () => { + fixtureEl.innerHTML = '
' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl, { + html: true + }) + + tooltip.setElementContent(tooltip.getTipElement(), [ + '
', + ' ', + '
' + ].join('')) + + expect(tooltip.getTipElement().querySelector('div').id).toEqual('childContent') + expect(tooltip.getTipElement().querySelector('button')).toEqual(null) + }) + + it('should add text content', () => { + fixtureEl.innerHTML = '
' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + tooltip.setElementContent(tooltip.getTipElement(), 'test') + + expect(tooltip.getTipElement().innerText).toEqual('test') + }) + }) + + describe('getTitle', () => { + it('should return the title', () => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl) + + expect(tooltip.getTitle()).toEqual('Another tooltip') + }) + + it('should call title function', () => { + fixtureEl.innerHTML = '' + + const tooltipEl = fixtureEl.querySelector('a') + const tooltip = new Tooltip(tooltipEl, { + title: () => 'test' + }) + + expect(tooltip.getTitle()).toEqual('test') + }) + }) + + describe('_jQueryInterface', () => { + it('should create a tooltip', () => { + fixtureEl.innerHTML = '
' + + const div = fixtureEl.querySelector('div') + + jQueryMock.fn.tooltip = Tooltip._jQueryInterface + jQueryMock.elements = [div] + + jQueryMock.fn.tooltip.call(jQueryMock) + + expect(Tooltip._getInstance(div)).toBeDefined() + }) + + it('should not re create a tooltip', () => { + fixtureEl.innerHTML = '
' + + const div = fixtureEl.querySelector('div') + const tooltip = new Tooltip(div) + + jQueryMock.fn.tooltip = Tooltip._jQueryInterface + jQueryMock.elements = [div] + + jQueryMock.fn.tooltip.call(jQueryMock) + + expect(Tooltip._getInstance(div)).toEqual(tooltip) + }) + + it('should call a tooltip method', () => { + fixtureEl.innerHTML = '
' + + const div = fixtureEl.querySelector('div') + const tooltip = new Tooltip(div) + + spyOn(tooltip, 'show') + + jQueryMock.fn.tooltip = Tooltip._jQueryInterface + jQueryMock.elements = [div] + + jQueryMock.fn.tooltip.call(jQueryMock, 'show') + + expect(Tooltip._getInstance(div)).toEqual(tooltip) + expect(tooltip.show).toHaveBeenCalled() + }) + + it('should do nothing when we call dispose or hide if there is no tooltip created', () => { + fixtureEl.innerHTML = '
' + + const div = fixtureEl.querySelector('div') + + spyOn(Tooltip.prototype, 'dispose') + + jQueryMock.fn.tooltip = Tooltip._jQueryInterface + jQueryMock.elements = [div] + + jQueryMock.fn.tooltip.call(jQueryMock, 'dispose') + + expect(Tooltip.prototype.dispose).not.toHaveBeenCalled() + }) + + it('should throw error on undefined method', () => { + fixtureEl.innerHTML = '
' + + const div = fixtureEl.querySelector('div') + const action = 'undefinedMethod' + + jQueryMock.fn.tooltip = Tooltip._jQueryInterface + jQueryMock.elements = [div] + + try { + jQueryMock.fn.tooltip.call(jQueryMock, action) + } catch (error) { + expect(error.message).toEqual(`No method named "${action}"`) + } + }) + }) +}) diff --git a/js/tests/unit/tooltip.js b/js/tests/unit/tooltip.js deleted file mode 100644 index c9cd2a10cd..0000000000 --- a/js/tests/unit/tooltip.js +++ /dev/null @@ -1,1257 +0,0 @@ -$(function () { - 'use strict' - - var Tooltip = typeof window.bootstrap === 'undefined' ? window.Tooltip : window.bootstrap.Tooltip - - QUnit.module('tooltip plugin') - - QUnit.test('should be defined on jquery object', function (assert) { - assert.expect(1) - assert.ok($(document.body).tooltip, 'tooltip method is defined') - }) - - QUnit.module('tooltip', { - beforeEach: function () { - // Run all tests in noConflict mode -- it's the only way to ensure that the plugin works in noConflict mode - $.fn.bootstrapTooltip = $.fn.tooltip.noConflict() - }, - afterEach: function () { - $.fn.tooltip = $.fn.bootstrapTooltip - delete $.fn.bootstrapTooltip - $('.tooltip').remove() - $('#qunit-fixture').html('') - } - }) - - QUnit.test('should provide no conflict', function (assert) { - assert.expect(1) - assert.strictEqual(typeof $.fn.tooltip, 'undefined', 'tooltip was set back to undefined (org value)') - }) - - QUnit.test('should throw explicit error on undefined method', function (assert) { - assert.expect(1) - var $el = $('
') - $el.bootstrapTooltip() - try { - $el.bootstrapTooltip('noMethod') - } catch (error) { - assert.strictEqual(error.message, 'No method named "noMethod"') - } - }) - - QUnit.test('should return jquery collection containing the element', function (assert) { - assert.expect(2) - var $el = $('
') - var $tooltip = $el.bootstrapTooltip() - assert.ok($tooltip instanceof $, 'returns jquery collection') - assert.strictEqual($tooltip[0], $el[0], 'collection contains element') - }) - - QUnit.test('should expose default settings', function (assert) { - assert.expect(1) - assert.ok($.fn.bootstrapTooltip.Constructor.Default, 'defaults is defined') - }) - - QUnit.test('should empty title attribute', function (assert) { - assert.expect(1) - var $trigger = $('').bootstrapTooltip() - assert.strictEqual($trigger.attr('title'), '', 'title attribute was emptied') - }) - - QUnit.test('should add data attribute for referencing original title', function (assert) { - assert.expect(1) - var $trigger = $('').bootstrapTooltip() - assert.strictEqual($trigger.attr('data-original-title'), 'Another tooltip', 'original title preserved in data attribute') - }) - - QUnit.test('should add aria-describedby to the trigger on show', function (assert) { - assert.expect(3) - var $trigger = $('') - .bootstrapTooltip() - .appendTo('#qunit-fixture') - .bootstrapTooltip('show') - - var id = $('.tooltip').attr('id') - - assert.strictEqual($('#' + id).length, 1, 'has a unique id') - assert.strictEqual($('.tooltip').attr('aria-describedby'), $trigger.attr('id'), 'tooltip id and aria-describedby on trigger match') - assert.ok($trigger[0].hasAttribute('aria-describedby'), 'trigger has aria-describedby') - }) - - QUnit.test('should remove aria-describedby from trigger on hide', function (assert) { - assert.expect(2) - var done = assert.async() - var $trigger = $('') - .bootstrapTooltip() - .appendTo('#qunit-fixture') - - $trigger - .one('shown.bs.tooltip', function () { - assert.ok($trigger[0].hasAttribute('aria-describedby'), 'trigger has aria-describedby') - $trigger.bootstrapTooltip('hide') - }) - .one('hidden.bs.tooltip', function () { - assert.ok(!$trigger[0].hasAttribute('aria-describedby'), 'trigger does not have aria-describedby') - done() - }) - .bootstrapTooltip('show') - }) - - QUnit.test('should assign a unique id tooltip element', function (assert) { - assert.expect(2) - $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip('show') - - var id = $('.tooltip').attr('id') - - assert.strictEqual($('#' + id).length, 1, 'tooltip has unique id') - assert.strictEqual(id.indexOf('tooltip'), 0, 'tooltip id has prefix') - }) - - QUnit.test('should place tooltips relative to placement option', function (assert) { - assert.expect(2) - var done = assert.async() - var $tooltip = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - placement: 'bottom' - }) - - $tooltip - .one('shown.bs.tooltip', function () { - assert.ok($('.tooltip').is('.fade.bs-tooltip-bottom.show'), 'has correct classes applied') - $tooltip.bootstrapTooltip('hide') - }) - .one('hidden.bs.tooltip', function () { - assert.strictEqual(Tooltip._getInstance($tooltip[0]).tip.parentNode, null, 'tooltip removed') - done() - }) - .bootstrapTooltip('show') - }) - - QUnit.test('should allow html entities', function (assert) { - assert.expect(2) - var done = assert.async() - var $tooltip = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - html: true - }) - - $tooltip - .one('shown.bs.tooltip', function () { - assert.notEqual($('.tooltip b').length, 0, 'b tag was inserted') - $tooltip.bootstrapTooltip('hide') - }) - .one('hidden.bs.tooltip', function () { - assert.strictEqual(Tooltip._getInstance($tooltip[0]).tip.parentNode, null, 'tooltip removed') - done() - }) - .bootstrapTooltip('show') - }) - - QUnit.test('should allow DOMElement title (html: false)', function (assert) { - assert.expect(3) - var done = assert.async() - var title = document.createTextNode('<3 writing tests') - var $tooltip = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - title: title - }) - - $tooltip - .one('shown.bs.tooltip', function () { - assert.notEqual($('.tooltip').length, 0, 'tooltip inserted') - assert.strictEqual($('.tooltip').text(), '<3 writing tests', 'title inserted') - assert.ok(!$.contains($('.tooltip').get(0), title), 'title node copied, not moved') - done() - }) - .bootstrapTooltip('show') - }) - - QUnit.test('should allow DOMElement title (html: true)', function (assert) { - assert.expect(3) - var done = assert.async() - var title = document.createTextNode('<3 writing tests') - var $tooltip = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - html: true, - title: title - }) - - $tooltip - .one('shown.bs.tooltip', function () { - assert.notEqual($('.tooltip').length, 0, 'tooltip inserted') - assert.strictEqual($('.tooltip').text(), '<3 writing tests', 'title inserted') - assert.ok($.contains($('.tooltip').get(0), title), 'title node moved, not copied') - done() - }) - .bootstrapTooltip('show') - }) - - QUnit.test('should respect custom classes', function (assert) { - assert.expect(2) - var done = assert.async() - var $tooltip = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - template: '
' - }) - - $tooltip - .one('shown.bs.tooltip', function () { - assert.ok($('.tooltip').hasClass('some-class'), 'custom class is present') - $tooltip.bootstrapTooltip('hide') - }) - .one('hidden.bs.tooltip', function () { - assert.strictEqual(Tooltip._getInstance($tooltip[0]).tip.parentNode, null, 'tooltip removed') - done() - }) - .bootstrapTooltip('show') - }) - - QUnit.test('should fire show event', function (assert) { - assert.expect(1) - var done = assert.async() - - $('
') - .on('show.bs.tooltip', function () { - assert.ok(true, 'show event fired') - done() - }) - .bootstrapTooltip('show') - }) - - QUnit.test('should throw an error when show is called on hidden elements', function (assert) { - assert.expect(1) - var done = assert.async() - - try { - $('
').bootstrapTooltip('show') - } catch (error) { - assert.strictEqual(error.message, 'Please use show on visible elements') - done() - } - }) - - QUnit.test('should fire inserted event', function (assert) { - assert.expect(2) - var done = assert.async() - - $('
') - .appendTo('#qunit-fixture') - .on('inserted.bs.tooltip', function () { - assert.notEqual($('.tooltip').length, 0, 'tooltip was inserted') - assert.ok(true, 'inserted event fired') - done() - }) - .bootstrapTooltip('show') - }) - - QUnit.test('should fire shown event', function (assert) { - assert.expect(1) - var done = assert.async() - - $('
') - .appendTo('#qunit-fixture') - .on('shown.bs.tooltip', function () { - assert.ok(true, 'shown was called') - done() - }) - .bootstrapTooltip('show') - }) - - QUnit.test('should not fire shown event when show was prevented', function (assert) { - assert.expect(1) - var done = assert.async() - - $('
') - .on('show.bs.tooltip', function (e) { - e.preventDefault() - assert.ok(true, 'show event fired') - done() - }) - .on('shown.bs.tooltip', function () { - assert.ok(false, 'shown event fired') - }) - .bootstrapTooltip('show') - }) - - QUnit.test('should fire hide event', function (assert) { - assert.expect(1) - var done = assert.async() - - $('
') - .appendTo('#qunit-fixture') - .on('shown.bs.tooltip', function () { - $(this).bootstrapTooltip('hide') - }) - .on('hide.bs.tooltip', function () { - assert.ok(true, 'hide event fired') - done() - }) - .bootstrapTooltip('show') - }) - - QUnit.test('should fire hidden event', function (assert) { - assert.expect(1) - var done = assert.async() - - $('
') - .appendTo('#qunit-fixture') - .on('shown.bs.tooltip', function () { - $(this).bootstrapTooltip('hide') - }) - .on('hidden.bs.tooltip', function () { - assert.ok(true, 'hidden event fired') - done() - }) - .bootstrapTooltip('show') - }) - - QUnit.test('should not fire hidden event when hide was prevented', function (assert) { - assert.expect(1) - var done = assert.async() - - $('
') - .appendTo('#qunit-fixture') - .on('shown.bs.tooltip', function () { - $(this).bootstrapTooltip('hide') - }) - .on('hide.bs.tooltip', function (e) { - e.preventDefault() - assert.ok(true, 'hide event fired') - done() - }) - .on('hidden.bs.tooltip', function () { - assert.ok(false, 'hidden event fired') - }) - .bootstrapTooltip('show') - }) - - QUnit.test('should destroy tooltip', function (assert) { - assert.expect(3) - var $tooltip = $('
') - .bootstrapTooltip() - .on('click.foo', function () {}) // eslint-disable-line no-empty-function - - assert.ok(Tooltip._getInstance($tooltip[0]), 'tooltip has data') - - $tooltip.bootstrapTooltip('show') - $tooltip.bootstrapTooltip('dispose') - - assert.ok(!$tooltip.hasClass('show'), 'tooltip is hidden') - assert.ok(!Tooltip._getInstance($tooltip[0]), 'tooltip does not have data') - }) - - // QUnit.test('should show tooltip with delegate selector on click', function (assert) { - // assert.expect(2) - // var $div = $('
') - // .appendTo('#qunit-fixture') - // .bootstrapTooltip({ - // selector: 'a[rel="tooltip"]', - // trigger: 'click' - // }) - - // $div.find('a').trigger('click') - // assert.ok($('.tooltip').is('.fade.in'), 'tooltip is faded in') - - // $div.find('a').trigger('click') - // assert.strictEqual($div.data('bs.tooltip').tip.parentNode, null, 'tooltip removed') - // }) - - QUnit.test('should show tooltip when toggle is called', function (assert) { - assert.expect(1) - $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - trigger: 'manual' - }) - .bootstrapTooltip('toggle') - - assert.ok($('.tooltip').is('.fade.show'), 'tooltip is faded active') - }) - - QUnit.test('should hide previously shown tooltip when toggle is called on tooltip', function (assert) { - assert.expect(1) - $('@ResentedHook') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - trigger: 'manual' - }) - .bootstrapTooltip('show') - - $('.tooltip').bootstrapTooltip('toggle') - assert.ok($('.tooltip').not('.fade.show'), 'tooltip was faded out') - }) - - QUnit.test('should place tooltips inside body when container is body', function (assert) { - assert.expect(3) - var done = assert.async() - var $tooltip = $('
') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - container: 'body' - }) - - $tooltip - .one('shown.bs.tooltip', function () { - assert.notEqual($('body > .tooltip').length, 0, 'tooltip is direct descendant of body') - assert.strictEqual($('#qunit-fixture > .tooltip').length, 0, 'tooltip is not in parent') - $tooltip.bootstrapTooltip('hide') - }) - .one('hidden.bs.tooltip', function () { - assert.strictEqual($('body > .tooltip').length, 0, 'tooltip was removed from dom') - done() - }) - .bootstrapTooltip('show') - }) - - QUnit.test('should place tooltips inside a specific container when container is an element', function (assert) { - assert.expect(3) - var done = assert.async() - var $container = $('
').appendTo('#qunit-fixture') - var $tooltip = $('
') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - container: $container[0] - }) - - $tooltip - .one('shown.bs.tooltip', function () { - assert.strictEqual($container.find('.tooltip').length, 1) - assert.strictEqual($('#qunit-fixture > .tooltip').length, 0, 'tooltip is not in parent') - $tooltip.bootstrapTooltip('hide') - }) - .one('hidden.bs.tooltip', function () { - assert.strictEqual($container.find('.tooltip').length, 0, 'tooltip was removed from dom') - done() - }) - .bootstrapTooltip('show') - }) - - QUnit.test('should place tooltips inside a specific container when container is a selector', function (assert) { - assert.expect(3) - var done = assert.async() - var $container = $('
').appendTo('#qunit-fixture') - var $tooltip = $('
') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - container: '#container' - }) - - $tooltip - .one('shown.bs.tooltip', function () { - assert.strictEqual($container.find('.tooltip').length, 1) - assert.strictEqual($('#qunit-fixture > .tooltip').length, 0, 'tooltip is not in parent') - $tooltip.bootstrapTooltip('hide') - }) - .one('hidden.bs.tooltip', function () { - assert.strictEqual($container.find('.tooltip').length, 0, 'tooltip was removed from dom') - done() - }) - .bootstrapTooltip('show') - }) - - QUnit.test('should add position class before positioning so that position-specific styles are taken into account', function (assert) { - assert.expect(2) - var done = assert.async() - var styles = '' - var $styles = $(styles).appendTo('head') - - var $container = $('
').appendTo('#qunit-fixture') - $('') - .appendTo($container) - .bootstrapTooltip({ - placement: 'right', - trigger: 'manual' - }) - .on('inserted.bs.tooltip', function () { - var $tooltip = $(Tooltip._getInstance(this).tip) - assert.ok($tooltip.hasClass('bs-tooltip-right')) - assert.ok(typeof $tooltip.attr('style') === 'undefined') - $styles.remove() - done() - }) - .bootstrapTooltip('show') - }) - - QUnit.test('should use title attribute for tooltip text', function (assert) { - assert.expect(2) - var done = assert.async() - var $tooltip = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip() - - $tooltip - .one('shown.bs.tooltip', function () { - assert.strictEqual($('.tooltip').children('.tooltip-inner').text(), 'Simple tooltip', 'title from title attribute is set') - $tooltip.bootstrapTooltip('hide') - }) - .one('hidden.bs.tooltip', function () { - assert.strictEqual($('.tooltip').length, 0, 'tooltip removed from dom') - done() - }) - .bootstrapTooltip('show') - }) - - QUnit.test('should prefer title attribute over title option', function (assert) { - assert.expect(2) - var done = assert.async() - var $tooltip = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - title: 'This is a tooltip with some content' - }) - - $tooltip - .one('shown.bs.tooltip', function () { - assert.strictEqual($('.tooltip').children('.tooltip-inner').text(), 'Simple tooltip', 'title is set from title attribute while preferred over title option') - $tooltip.bootstrapTooltip('hide') - }) - .one('hidden.bs.tooltip', function () { - assert.strictEqual($('.tooltip').length, 0, 'tooltip removed from dom') - done() - }) - .bootstrapTooltip('show') - }) - - QUnit.test('should use title option', function (assert) { - assert.expect(2) - var done = assert.async() - var $tooltip = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - title: 'This is a tooltip with some content' - }) - - $tooltip - .one('shown.bs.tooltip', function () { - assert.strictEqual($('.tooltip').children('.tooltip-inner').text(), 'This is a tooltip with some content', 'title from title option is set') - $tooltip.bootstrapTooltip('hide') - }) - .one('hidden.bs.tooltip', function () { - assert.strictEqual($('.tooltip').length, 0, 'tooltip removed from dom') - done() - }) - .bootstrapTooltip('show') - }) - - QUnit.test('should not error when trying to show an top-placed tooltip that has been removed from the dom', function (assert) { - assert.expect(1) - var passed = true - var $tooltip = $('') - .appendTo('#qunit-fixture') - .one('show.bs.tooltip', function () { - $(this).remove() - }) - .bootstrapTooltip({ - placement: 'top' - }) - - try { - $tooltip.bootstrapTooltip('show') - } catch (error) { - passed = false - } - - assert.ok(passed, '.tooltip(\'show\') should not throw an error if element no longer is in dom') - }) - - QUnit.test('should show tooltip if leave event hasn\'t occurred before delay expires', function (assert) { - assert.expect(2) - var done = assert.async() - - var $tooltip = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - delay: 150 - }) - - setTimeout(function () { - assert.ok(!$('.tooltip').is('.fade.show'), '100ms: tooltip is not faded active') - }, 100) - - setTimeout(function () { - assert.ok($('.tooltip').is('.fade.show'), '200ms: tooltip is faded active') - done() - }, 200) - - $tooltip[0].dispatchEvent(new Event('mouseover')) - }) - - QUnit.test('should not show tooltip if leave event occurs before delay expires', function (assert) { - assert.expect(2) - var done = assert.async() - - var $tooltip = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - delay: 150 - }) - - setTimeout(function () { - assert.ok(!$('.tooltip').is('.fade.show'), '100ms: tooltip not faded active') - $tooltip[0].dispatchEvent(new Event('mouseout')) - }, 100) - - setTimeout(function () { - assert.ok(!$('.tooltip').is('.fade.show'), '200ms: tooltip not faded active') - done() - }, 200) - - $tooltip[0].dispatchEvent(new Event('mouseover')) - }) - - QUnit.test('should not hide tooltip if leave event occurs and enter event occurs within the hide delay', function (assert) { - assert.expect(3) - var done = assert.async() - - var $tooltip = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - delay: { - show: 0, - hide: 150 - } - }) - - setTimeout(function () { - assert.ok($('.tooltip').is('.fade.show'), '1ms: tooltip faded active') - $tooltip[0].dispatchEvent(new Event('mouseout')) - - setTimeout(function () { - assert.ok($('.tooltip').is('.fade.show'), '100ms: tooltip still faded active') - $tooltip[0].dispatchEvent(new Event('mouseover')) - }, 100) - - setTimeout(function () { - assert.ok($('.tooltip').is('.fade.show'), '200ms: tooltip still faded active') - done() - }, 200) - }, 0) - - $tooltip[0].dispatchEvent(new Event('mouseover')) - }) - - QUnit.test('should not show tooltip if leave event occurs before delay expires', function (assert) { - assert.expect(2) - var done = assert.async() - - var $tooltip = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - delay: 150 - }) - - setTimeout(function () { - assert.ok(!$('.tooltip').is('.fade.show'), '100ms: tooltip not faded active') - $tooltip[0].dispatchEvent(new Event('mouseout')) - }, 100) - - setTimeout(function () { - assert.ok(!$('.tooltip').is('.fade.show'), '200ms: tooltip not faded active') - done() - }, 200) - - $tooltip[0].dispatchEvent(new Event('mouseover')) - }) - - QUnit.test('should not show tooltip if leave event occurs before delay expires, even if hide delay is 0', function (assert) { - assert.expect(2) - var done = assert.async() - - var $tooltip = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - delay: { - show: 150, - hide: 0 - } - }) - - setTimeout(function () { - assert.ok(!$('.tooltip').is('.fade.show'), '100ms: tooltip not faded active') - $tooltip[0].dispatchEvent(new Event('mouseout')) - }, 100) - - setTimeout(function () { - assert.ok(!$('.tooltip').is('.fade.show'), '250ms: tooltip not faded active') - done() - }, 250) - - $tooltip[0].dispatchEvent(new Event('mouseover')) - }) - - QUnit.test('should wait 200ms before hiding the tooltip', function (assert) { - assert.expect(3) - var done = assert.async() - - var $tooltip = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - delay: { - show: 0, - hide: 150 - } - }) - - setTimeout(function () { - assert.ok($(Tooltip._getInstance($tooltip[0]).tip).is('.fade.show'), '1ms: tooltip faded active') - - $tooltip[0].dispatchEvent(new Event('mouseout')) - - setTimeout(function () { - assert.ok($(Tooltip._getInstance($tooltip[0]).tip).is('.fade.show'), '100ms: tooltip still faded active') - }, 100) - - setTimeout(function () { - assert.ok(!$(Tooltip._getInstance($tooltip[0]).tip).is('.show'), '200ms: tooltip removed') - done() - }, 200) - }, 0) - - $tooltip[0].dispatchEvent(new Event('mouseover')) - }) - - QUnit.test('should not reload the tooltip on subsequent mouseenter events', function (assert) { - assert.expect(1) - var fakeId = 1 - var titleHtml = function () { - var uid = fakeId - fakeId++ - return '

' + uid + '

' + uid + '

' + uid + '

' - } - - var $tooltip = $('some text') - .appendTo('#qunit-fixture') - - $tooltip.bootstrapTooltip({ - html: true, - animation: false, - trigger: 'hover', - delay: { - show: 0, - hide: 500 - }, - container: $tooltip, - title: titleHtml - }) - - $('#tt-outer')[0].dispatchEvent(new Event('mouseover')) - - var currentUid = $('#tt-content').text() - - $('#tt-outer')[0].dispatchEvent(new Event('mouseover')) - assert.strictEqual(currentUid, $('#tt-content').text()) - }) - - QUnit.test('should not reload the tooltip if the mouse leaves and re-enters before hiding', function (assert) { - assert.expect(4) - - var fakeId = 1 - var titleHtml = function () { - var uid = 'tooltip' + fakeId - fakeId++ - return '

' + uid + '

' + uid + '

' + uid + '

' - } - - var $tooltip = $('some text') - .appendTo('#qunit-fixture') - - $tooltip.bootstrapTooltip({ - html: true, - animation: false, - trigger: 'hover', - delay: { - show: 0, - hide: 500 - }, - title: titleHtml - }) - - var obj = Tooltip._getInstance($tooltip[0]) - - $('#tt-outer')[0].dispatchEvent(new Event('mouseover')) - - var currentUid = $('#tt-content').text() - - $('#tt-outer')[0].dispatchEvent(new Event('mouseout')) - assert.strictEqual(currentUid, $('#tt-content').text()) - - assert.ok(obj._hoverState === 'out', 'the tooltip hoverState should be set to "out"') - - $('#tt-outer')[0].dispatchEvent(new Event('mouseover')) - assert.ok(obj._hoverState === 'show', 'the tooltip hoverState should be set to "show"') - - assert.strictEqual(currentUid, $('#tt-content').text()) - }) - - QUnit.test('should do nothing when an attempt is made to hide an uninitialized tooltip', function (assert) { - assert.expect(1) - - var $tooltip = $('some text') - .appendTo('#qunit-fixture') - .on('hidden.bs.tooltip shown.bs.tooltip', function () { - assert.ok(false, 'should not fire any tooltip events') - }) - .bootstrapTooltip('hide') - assert.ok(Tooltip._getInstance($tooltip[0]) === null, 'should not initialize the tooltip') - }) - - QUnit.test('should not remove tooltip if multiple triggers are set and one is still active', function (assert) { - assert.expect(41) - var $el = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - trigger: 'click hover focus', - animation: false - }) - - var tooltip = Tooltip._getInstance($el[0]) - var $tooltip = $(tooltip.getTipElement()) - - function showingTooltip() { - return $tooltip.hasClass('show') || tooltip._hoverState === 'show' - } - - var tests = [ - ['mouseover', 'mouseout'], - - ['focusin', 'focusout'], - - ['click', 'click'], - - ['mouseover', 'focusin', 'focusout', 'mouseout'], - ['mouseover', 'focusin', 'mouseout', 'focusout'], - - ['focusin', 'mouseover', 'mouseout', 'focusout'], - ['focusin', 'mouseover', 'focusout', 'mouseout'], - - ['click', 'focusin', 'mouseover', 'focusout', 'mouseout', 'click'], - ['mouseover', 'click', 'focusin', 'focusout', 'mouseout', 'click'], - ['mouseover', 'focusin', 'click', 'click', 'mouseout', 'focusout'] - ] - - assert.ok(!showingTooltip()) - - $.each(tests, function (idx, triggers) { - for (var i = 0, len = triggers.length; i < len; i++) { - $el[0].dispatchEvent(new Event(triggers[i])) - assert.equal(i < len - 1, showingTooltip()) - } - }) - }) - - QUnit.test('should show on first trigger after hide', function (assert) { - assert.expect(3) - var $el = $('
') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - trigger: 'click hover focus', - animation: false - }) - - var tooltip = Tooltip._getInstance($el[0]) - var $tooltip = $(tooltip.getTipElement()) - - function showingTooltip() { - return $tooltip.hasClass('show') || tooltip._hoverState === 'show' - } - - $el[0].click() - assert.ok(showingTooltip(), 'tooltip is faded in') - - $el.bootstrapTooltip('hide') - assert.ok(!showingTooltip(), 'tooltip was faded out') - - $el[0].click() - assert.ok(showingTooltip(), 'tooltip is faded in again') - }) - - QUnit.test('should hide tooltip when their containing modal is closed', function (assert) { - assert.expect(1) - var done = assert.async() - var templateHTML = '' - - $(templateHTML).appendTo('#qunit-fixture') - $('#tooltipTest') - .bootstrapTooltip({ - trigger: 'manuel' - }) - .on('shown.bs.tooltip', function () { - $('#modal-test').modal('hide') - }) - .on('hide.bs.tooltip', function () { - assert.ok(true, 'tooltip hide') - done() - }) - - $('#modal-test') - .on('shown.bs.modal', function () { - $('#tooltipTest').bootstrapTooltip('show') - }) - .modal('show') - }) - - QUnit.test('should allow to close modal if the tooltip element is detached', function (assert) { - assert.expect(1) - var done = assert.async() - var templateHTML = [ - '' - ].join('') - - $(templateHTML).appendTo('#qunit-fixture') - var $tooltip = $('#tooltipTest') - var $modal = $('#modal-test') - - $tooltip.on('shown.bs.tooltip', function () { - $tooltip.detach() - $tooltip.bootstrapTooltip('dispose') - $modal.modal('hide') - }) - - $modal.on('shown.bs.modal', function () { - $tooltip.bootstrapTooltip({ - trigger: 'manuel' - }) - .bootstrapTooltip('show') - }) - .on('hidden.bs.modal', function () { - assert.ok(true, 'modal hidden') - done() - }) - .modal('show') - }) - - QUnit.test('should reset tip classes when hidden event triggered', function (assert) { - assert.expect(2) - var done = assert.async() - var $el = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip('show') - .on('hidden.bs.tooltip', function () { - var tooltip = Tooltip._getInstance($el[0]) - var $tooltip = $(tooltip.getTipElement()) - assert.ok($tooltip.hasClass('tooltip')) - assert.ok($tooltip.hasClass('fade')) - done() - }) - - $el.bootstrapTooltip('hide') - }) - - QUnit.test('should convert number in title to string', function (assert) { - assert.expect(1) - var done = assert.async() - var $el = $('') - .appendTo('#qunit-fixture') - .on('shown.bs.tooltip', function () { - var tooltip = Tooltip._getInstance($el[0]) - var $tooltip = $(tooltip.getTipElement()) - assert.strictEqual($tooltip.children().text(), '7') - done() - }) - - $el.bootstrapTooltip('show') - }) - - QUnit.test('tooltip should be shown right away after the call of disable/enable', function (assert) { - assert.expect(2) - var done = assert.async() - - var $trigger = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip() - .on('shown.bs.tooltip', function () { - assert.strictEqual($('.tooltip').hasClass('show'), true) - done() - }) - - $trigger.bootstrapTooltip('disable') - $trigger[0].click() - setTimeout(function () { - assert.strictEqual($('.tooltip').length === 0, true) - $trigger.bootstrapTooltip('enable') - $trigger[0].click() - }, 200) - }) - - QUnit.test('should call Popper.js to update', function (assert) { - assert.expect(2) - - var $tooltip = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip() - - var tooltip = Tooltip._getInstance($tooltip[0]) - tooltip.show() - assert.ok(tooltip._popper) - - var spyPopper = sinon.spy(tooltip._popper, 'scheduleUpdate') - tooltip.update() - assert.ok(spyPopper.called) - }) - - QUnit.test('should not call Popper.js to update', function (assert) { - assert.expect(1) - - var $tooltip = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip() - - var tooltip = Tooltip._getInstance($tooltip[0]) - tooltip.update() - - assert.ok(tooltip._popper === null) - }) - - QUnit.test('should use Popper.js to get the tip on placement change', function (assert) { - assert.expect(1) - - var $tooltip = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip() - - var $tipTest = $('
') - .appendTo('#qunit-fixture') - - var tooltip = Tooltip._getInstance($tooltip[0]) - tooltip.tip = null - - tooltip._handlePopperPlacementChange({ - instance: { - popper: $tipTest[0] - }, - placement: 'auto' - }) - - assert.ok(tooltip.tip === $tipTest[0]) - }) - - QUnit.test('should toggle enabled', function (assert) { - assert.expect(3) - - var $tooltip = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip() - - var tooltip = Tooltip._getInstance($tooltip[0]) - - assert.strictEqual(tooltip._isEnabled, true) - - tooltip.toggleEnabled() - - assert.strictEqual(tooltip._isEnabled, false) - - tooltip.toggleEnabled() - - assert.strictEqual(tooltip._isEnabled, true) - }) - - QUnit.test('should create offset modifier correctly when offset option is a function', function (assert) { - assert.expect(2) - - var getOffset = function (offsets) { - return offsets - } - - var $trigger = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - offset: getOffset - }) - - var tooltip = Tooltip._getInstance($trigger[0]) - var offset = tooltip._getOffset() - - assert.ok(typeof offset.offset === 'undefined') - assert.ok(typeof offset.fn === 'function') - }) - - QUnit.test('should create offset modifier correctly when offset option is not a function', function (assert) { - assert.expect(2) - - var myOffset = 42 - var $trigger = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - offset: myOffset - }) - - var tooltip = Tooltip._getInstance($trigger[0]) - var offset = tooltip._getOffset() - - assert.strictEqual(offset.offset, myOffset) - assert.ok(typeof offset.fn === 'undefined') - }) - - QUnit.test('should disable sanitizer', function (assert) { - assert.expect(1) - - var $trigger = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - sanitize: false - }) - - var tooltip = Tooltip._getInstance($trigger[0]) - assert.strictEqual(tooltip.config.sanitize, false) - }) - - QUnit.test('should sanitize template by removing disallowed tags', function (assert) { - assert.expect(1) - - var $trigger = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - template: [ - '
', - ' ', - ' Some content', - '
' - ].join('') - }) - - var tooltip = Tooltip._getInstance($trigger[0]) - assert.strictEqual(tooltip.config.template.indexOf('script'), -1) - }) - - QUnit.test('should sanitize template by removing disallowed attributes', function (assert) { - assert.expect(1) - - var $trigger = $('
') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - template: [ - '
', - ' Some content', - '
' - ].join('') - }) - - var tooltip = Tooltip._getInstance($trigger[0]) - assert.strictEqual(tooltip.config.template.indexOf('onError'), -1) - }) - - QUnit.test('should allow custom sanitization rules', function (assert) { - assert.expect(2) - - var $trigger = $('
') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - template: [ - 'Click me', - 'Some content' - ].join(''), - whiteList: { - span: null - } - }) - - var tooltip = Tooltip._getInstance($trigger[0]) - - assert.strictEqual(tooltip.config.template.indexOf('') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - template: [ - 'Some content' - ].join(''), - sanitizeFn: function (input) { - return input - } - }) - - var tooltip = Tooltip._getInstance($trigger[0]) - - assert.ok(tooltip.config.template.indexOf('span') !== -1) - }) - - QUnit.test('should allow passing aria attributes', function (assert) { - assert.expect(1) - - var $trigger = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - template: [ - 'Some content' - ].join('') - }) - - var tooltip = Tooltip._getInstance($trigger[0]) - - assert.ok(tooltip.config.template.indexOf('aria-pressed') !== -1) - }) - - QUnit.test('should not sanitize element content', function (assert) { - assert.expect(1) - - var $element = $('
').appendTo('#qunit-fixture') - var content = '' - - var $trigger = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - template: [ - 'Some content' - ].join(''), - html: true, - sanitize: false - }) - - var tooltip = Tooltip._getInstance($trigger[0]) - tooltip.setElementContent($element[0], content) - - assert.strictEqual($element[0].innerHTML, content) - }) - - QUnit.test('should not take into account sanitize in data attributes', function (assert) { - assert.expect(1) - - var $trigger = $('') - .appendTo('#qunit-fixture') - .bootstrapTooltip({ - template: [ - 'Some content' - ].join('') - }) - - var tooltip = Tooltip._getInstance($trigger[0]) - - assert.strictEqual(tooltip.config.sanitize, true) - }) - - QUnit.test('should return the version', function (assert) { - assert.expect(1) - assert.strictEqual(typeof Tooltip.VERSION, 'string') - }) -})