[JavaScript] Tooltip with Close Delay

See demo first. Move the cursor (mouse pointer) to hover over the blue text with underline:

This is a tooltip example via JavaScript.

If the cursor leaves the blue text and does not enter the tooltip within 250ms, the tooltip will be closed. If the cursor leaves the blue text and is in the tooltip after 250ms, the tooltip will still be visible without being closed.

The demo here is not the same as the implementation of simple tooltip in my previous post [1]. In my previous post, the tooltip will be closed right after the cursor leaves the blue text without any delay.

To achieve the effect of the demo, first wrap the text with proper HTML tag. In the example of demo, we wrap the text tooltip and JavaScript with span tag. Then put the explanation of the text in the data-descr attribute of the tag, just like the following HTML code used in the demo:


This is a <span data-descr="hello, I am tooltip!">tooltip</span> example via
<span data-descr="programming language">JavaScript</span>.

Next, add the following rules to your CSS code:


*[data-descr] {
  text-decoration: underline;
  color: blue;
  cursor: help;

.invisible {
    display: none;

.tooltip {
    position: absolute;
    background-color: yellow;
    border: 1px gray solid;
    border-radius: 3px;
    padding: 3px;
  1. First rule says add underline to the text wrapped in the element with data-descr attribute, make the text blue, and make the mouse cursor become help icon on hover over.
  2. Second rule, as the name suggests, is used to make element invisible.
  3. Third rule is used to style the tooltip box that shows the description of the text.

Then add the following to your JavaScript code:


// indicate if the mouse cursor is in the tooltip
var isCursorInTooltip = false;

// when cursor leaves the text, the delay time to close the tooltip if the
// cursor is not in the tooltip. (milisecond)
var delay = 250;

// create and append invisible tooltip to DOM tree
var tooltip = document.createElement("div");
tooltip.addEventListener("mouseenter", function() {
  isCursorInTooltip = true;
tooltip.addEventListener("mouseleave", function() {
  isCursorInTooltip = false;

// event handler for mouseenter event of elements with data-descr attribute
function ShowTooltip(e) {
  var elm = e.target;
  tooltip.textContent = elm.dataset.descr;
  tooltip.style.left = elm.getBoundingClientRect().left + window.pageXOffset + 'px';
  tooltip.style.top = (elm.getBoundingClientRect().top + window.pageYOffset + elm.offsetHeight + 5) + 'px';

// event handler for mouseleave event of elements with data-descr attribute
function HideTooltip(e) {
  setTimeout(function() {
    if (!isCursorInTooltip) {
  }, delay);

// select all elements with data-descr attribute and attach mouseenter and mouseleave event handler
var els = document.querySelectorAll("*[data-descr]");
for (var i = 0; i < els.length; ++i) {
  var el = els[i];
  el.addEventListener("mouseenter", ShowTooltip);
  el.addEventListener("mouseleave", HideTooltip);

In the JavaScript code:

  1. Create and append a tooltip (div element) to the HTML body. The tooltip is used to show description on mouse hovering over the text. The tooltip is invisible in the beginning.
  2. Attach mouseenter and mouseleave event handler to the tooltip. In the event handler, set the variable isCursorInTooltip accordingly. Also close the tooltip if the cursor leaves the tooltip.
  3. Define mouseenter and mouseleave event handler to texts wrapped in the element with data-descr attribute. In mouseenter handler we show the description of the text in the tooltip, and in mouseleave handler we make the tooltip invisible if the cursor is not in the tooltip after 250ms.
  4. Use querySelectorAll to find all elements with data-descr attribute, and attach corresponding mouseenter/mouseleave event handlder to show/hide description of texts.

Tested on: Chromium Version 63.0.3239.84 (Official Build) Built on Ubuntu , running on Ubuntu 17.10 (64-bit)


[1][JavaScript] Tooltip