tooltip-documentation.md 5.01 KB

Tooltip

Kind: global class

new Tooltip(reference, options)

Create a new Tooltip.js instance

Returns: Object - instance - The generated tooltip instance

Param Type Default Description
reference HTMLElement The DOM node used as reference of the tooltip (it can be a jQuery element).
options Object
options.placement String bottom Placement of the popper accepted values: top(-start, -end), right(-start, -end), bottom(-start, -end), left(-start, -end)
options.container HTMLElement \ String \ false
options.delay Number \ Object 0
options.html Boolean false Insert HTML into the tooltip. If false, the content will inserted with innerText.
options.placement String \ PlacementFunction 'top'
[options.template] String '<div class="tooltip" role="tooltip"><div class="tooltip-arrow"></div><div class="tooltip-inner"></div></div>' Base HTML to used when creating the tooltip. The tooltip's title will be injected into the .tooltip-inner or .tooltip__inner. .tooltip-arrow or .tooltip__arrow will become the tooltip's arrow. The outermost wrapper element should have the .tooltip class.
options.title String \ HTMLElement \ TitleFunction
[options.trigger] String 'hover focus' How tooltip is triggered - click, hover, focus, manual. You may pass multiple triggers; separate them with a space. manual cannot be combined with any other trigger.
options.boundariesElement HTMLElement The element used as boundaries for the tooltip. For more information refer to Popper.js' boundariesElement docs
options.offset Number \ String 0
options.popperOptions Object {} Popper options, will be passed directly to popper instance. For more information refer to Popper.js' options docs

tooltip.show()

Reveals an element's tooltip. This is considered a "manual" triggering of the tooltip. Tooltips with zero-length titles are never displayed.

Kind: instance method of Tooltip

tooltip.hide()

Hides an element’s tooltip. This is considered a “manual” triggering of the tooltip.

Kind: instance method of Tooltip

tooltip.dispose()

Hides and destroys an element’s tooltip.

Kind: instance method of Tooltip

tooltip.toggle()

Toggles an element’s tooltip. This is considered a “manual” triggering of the tooltip.

Kind: instance method of Tooltip

Tooltip.PlacementFunction ⇒ String

Placement function, its context is the Tooltip instance.

Kind: static typedef of Tooltip
Returns: String - placement - One of the allowed placement options.

Param Type Description
tooltip HTMLElement tooltip DOM node.
reference HTMLElement reference DOM node.

Tooltip.TitleFunction ⇒ String

Title function, its context is the Tooltip instance.

Kind: static typedef of Tooltip
Returns: String - placement - The desired title.