Do something when someone's probably going to click something.

ProbaClick fires a callback when a user hovers over an element for a specified length of time or, if specified, after a user hovers over a link a certain number of times. It's designed under the assumption that when a user spends a certain amount of time hovering over an item, it's likely that they're about click or interact with it in some way. By anticipating that click, you're able to perform an action before the user actually does it.

The use cases are wide, but perhaps the most common is to dynamically fetch resources when it's likely that a user will click on a link. For example, you might dynamically prefetch a page that a user is probably going to navigate to next.

To use, pass a NodeList, Node, or string selector, and define your options.

//-- Turn each button red when it's hovered over for a second.
ProbaClick(document.querySelectorAll("button"), {
  callback: function (element) {
    element.style.background = "red";
  },
  delay: 1000,
});

By default, ProbaClick will fire its callback method after a certain amount of total time hovered. For example, if delay is set to 1000, the callback will fire after a user hovers twice at 500ms each, once at 1000ms, or any other number of hovers whose durations add up to at least 1000ms.

However, it's also possible to trigger the callback based on the total number of hovers, regardless of the amount of time spent hovering. The following configuration will fire the callback after a total hover time of 1000ms OR when the user has hovered over the element 3 times.

ProbaClick(document.querySelectorAll("button"), {
  callback: function (element) {},
  delay: 1000,
  count: 3,
});

After the callback has fired, the total hover time and hover count will be reset to zero.

In some cases (like when using a framework like React), you may need to imperatively remove the event listeners registered by ProbaClick before it's had a chance to respond to any interactions. To remove listeners registered by an instance, use the provided remove() method. For example, in a React component, usage may look like this:

useEffect(() => {
  // Create an instance once the component mounts.
  const instance = ProbaClick("button", {
    // options
  });

  // When it unmounts, remove the listeners registered by ProbaClick.
  return () => {
    instance.remove();
  };
}, []);

Any of the following are valid:

ProbaClick(document.querySelectorAll("a.class")); // ...

ProbaClick(document.querySelector("a.class")); // ...

ProbaClick("a.class"); // ...