Origami Frontend Components & Services

JSDoc: o-tooltip

new Tooltip(tooltipEl, opts)

Represents a tooltip.

parameter type default description
tooltipEl HTMLElement The tooltip element in the DOM (Required)
opts object An options object for configuring the tooltip (Optional)

Methods

  • getOptions(tooltipEl) - (static) Get the data attributes from the tooltipEl. If the tooltip is being set up declaratively, this method is used to extract the data attributes from the DOM.
  • checkOptions(opts) - (static) Check the options passed in are valid, and that the required option (target) is present
  • render - (instance) Render the tooltip. Adds markup and attributes to this.tooltipEl in the DOM
  • show - (instance) Show the tooltip. Adds event handlers for clicks, touches, keypresses and viewport resizes. Uses FTDomDelegate to implement the event delegate pattern. Calls DrawTooltip.
  • toggle - (instance) Toggle the tooltip open and close
  • closeAfter(seconds) - (instance) Close the tooltip after set time
  • showAfter(seconds) - (instance) Show the tooltip after set time
  • destroy - (instance) Destroy the tooltip.
  • close(...) - (instance) Close the tooltip. (Visually hide it and remove event listeners)
  • closeOnKeyUp(ev)
  • resizeListener - (instance) Respond to resize events. Redraw the tooltip in case the target has moved.
  • drawTooltip - (instance) Calculates the best place to position the tooltip based on space around the target and a preference set by the app developer.
  • width
  • height

Links

Tooltip.getOptions(tooltipEl)

Static Method

Get the data attributes from the tooltipEl. If the tooltip is being set up declaratively, this method is used to extract the data attributes from the DOM.

parameter type default description
tooltipEl HTMLElement The tooltip element in the DOM (Required)

Returns

  • Object.<string, any> - a dictionary of options

Links

Tooltip.checkOptions(opts)

Static Method

Check the options passed in are valid, and that the required option (target) is present

parameter type default description
opts object An Object with configuration options for the tooltip

Returns

  • object - opts

Links

Tooltip#render

Instance Method

Render the tooltip. Adds markup and attributes to this.tooltipEl in the DOM

Links

Tooltip#show

Instance Method

Show the tooltip. Adds event handlers for clicks, touches, keypresses and viewport resizes. Uses FTDomDelegate to implement the event delegate pattern. Calls DrawTooltip.

Links

Tooltip#toggle

Instance Method

Toggle the tooltip open and close

Links

Tooltip#closeAfter(seconds)

Instance Method

Close the tooltip after set time

parameter type default description
seconds number how long to wait until closing

Links

Tooltip#showAfter(seconds)

Instance Method

Show the tooltip after set time

parameter type default description
seconds number how long to wait until showing

Links

Tooltip#destroy

Instance Method

Destroy the tooltip.

Links

Tooltip#close(...)

Instance Method

Close the tooltip. (Visually hide it and remove event listeners)

parameter type default description
_event any ignored
_target any ignored
fireCloseEvent boolean true should we fire the oTooltip.close event?

Returns

  • boolean - false

Links

Tooltip#closeOnKeyUp(ev)

Instance Method

parameter type default description
ev Event calls close on the tooltip if the key is Esc

Links

Tooltip#resizeListener

Instance Method

Respond to resize events. Redraw the tooltip in case the target has moved.

Links

Tooltip#drawTooltip

Instance Method

Calculates the best place to position the tooltip based on space around the target and a preference set by the app developer.

Returns

  • void - this function is recursive!

Links

Tooltip#width

Instance Method

Returns

  • number - the offset width of the tooltip element

Links

Tooltip#height

Instance Method

Returns

  • number - the offset height of the tooltip element

Links

new Tooltip(tooltipEl, opts)

Represents a tooltip.

parameter type default description
tooltipEl HTMLElement The tooltip element in the DOM (Required)
opts object An options object for configuring the tooltip (Optional)

Methods

  • getOptions(tooltipEl) - (static) Get the data attributes from the tooltipEl. If the tooltip is being set up declaratively, this method is used to extract the data attributes from the DOM.
  • checkOptions(opts) - (static) Check the options passed in are valid, and that the required option (target) is present
  • render - (instance) Render the tooltip. Adds markup and attributes to this.tooltipEl in the DOM
  • show - (instance) Show the tooltip. Adds event handlers for clicks, touches, keypresses and viewport resizes. Uses FTDomDelegate to implement the event delegate pattern. Calls DrawTooltip.
  • toggle - (instance) Toggle the tooltip open and close
  • closeAfter(seconds) - (instance) Close the tooltip after set time
  • showAfter(seconds) - (instance) Show the tooltip after set time
  • destroy - (instance) Destroy the tooltip.
  • close(...) - (instance) Close the tooltip. (Visually hide it and remove event listeners)
  • closeOnKeyUp(ev)
  • resizeListener - (instance) Respond to resize events. Redraw the tooltip in case the target has moved.
  • drawTooltip - (instance) Calculates the best place to position the tooltip based on space around the target and a preference set by the app developer.
  • width
  • height

Links

Status
active
Switch component view

GitHub: o-tooltip@5.3.0

Install o-tooltip

If using the Build Service, add o-tooltip@^5.3.0 to your script and link tags.

If using the npm package manager for a Manual Build, run npm install --save-peer "@financial-times/o-tooltip@^5.3.0".

Help & Support

o-tooltip is maintained directly by the Origami team. If you have any questions about o-tooltip or Origami in general, we are happy to help. 😊

Slack: #origami-support
Email: origami.support@ft.com

Feedback / Issues

To report a bug or request features please create an issue on Github. For support or general feedback please get in touch 😊

Slack: #origami-support
Email: origami.support@ft.com