Socket
Socket
Sign inDemoInstall

use-mouse-action

Package Overview
Dependencies
8
Maintainers
1
Versions
4
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

use-mouse-action

React Hooks to listen to both mouse down or up and click events with a once called function.


Version published
Maintainers
1
Weekly downloads
1,163
decreased by-31.79%

Weekly downloads

Readme

Source

use-mouse-action Build Status

React Hooks to listen to both mouse down or up and click events with a once called function.

Example

This hook can be used to create fast usable drop-down buttons.

Installation

npm install use-mouse-action

Usage

import useMouseAction from 'use-mouse-action';

const Component = () => {
  const props = useMouseAction({
    onAction: () => console.log('You clicked or mouse downed me!'),
    down: true
  });

  return (
    <button type="button" {...props}>
      Click me fast!
    </button>
  );
};

Hooks

This library provides three React Hooks:

  • useMouseAction
  • useMouseDown
  • useMouseUp

They all want the same parameter: either the callback function or an options object with the callback function in the onAction parameter.

They all return an object of event listeners to add on the element.

import { useMouseDown } from 'use-mouse-action';

/** ... */

const props = useMouseDown(() => toggle);
return (<button type="button" {...props}>Click me</button>);

The useMouseDown and useMouseUp are both a shortcut to respectively set the down and up option to true.

Options

  • onAction (required): The function called on custom click triggered.
  • down (default: false): If the element should listen to mousedown event.
  • up (default: false): If the element should listen to mouseup event.
  • touch (default: false): If the element should listen to touch equivalent events.
  • timeout (default: 10): Short timeout in milliseconds to prevents multiple events.

You can provide functions that should listen to each event with theses options:

  • onClick
  • onMouseDown
  • onMouseUp
  • onTouchStart
  • onTouchEnd

Why

Sometimes, we would like to listen to mousedown or mouseup events on buttons, but these events are difficult to call by disabled peoples or by people that navigates with their keyboard.

We would like to listen both to mousedown/mouseup and click event, but we now must to make sure that our action is triggered only once.

Moreover, we would add on top of that the listening of touch events.

That's why I created this React Hooks library.

Build

npm run build

Test

npm test

License

This project is licensed under the MIT license.

FAQs

Last updated on 05 Apr 2019

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc