@react-hookz/web

What is @react-hookz/web?

@react-hookz/web is a collection of React hooks designed to simplify common web development tasks. It provides a wide range of hooks for state management, side effects, DOM interactions, and more, making it easier to build complex web applications with React.

What are @react-hookz/web's main functionalities?

State Management

The useToggle hook provides a simple way to manage boolean state. It returns the current state and a function to toggle the state.

import { useToggle } from '@react-hookz/web';

function ToggleComponent() {
  const [value, toggle] = useToggle();

  return (
    <div>
      <p>{value ? 'ON' : 'OFF'}</p>
      <button onClick={toggle}>Toggle</button>
    </div>
  );
}

Side Effects

The useDebounce hook delays the update of a value until after a specified delay. This is useful for scenarios like search input where you want to wait for the user to stop typing before performing an action.

import { useDebounce } from '@react-hookz/web';

function SearchComponent() {
  const [query, setQuery] = useState('');
  const debouncedQuery = useDebounce(query, 500);

  useEffect(() => {
    if (debouncedQuery) {
      // Perform search
    }
  }, [debouncedQuery]);

  return (
    <input
      type="text"
      value={query}
      onChange={(e) => setQuery(e.target.value)}
    />
  );
}

DOM Interactions

The useEventListener hook allows you to easily add and clean up event listeners. In this example, a click event listener is added to the window object.

import { useEventListener } from '@react-hookz/web';

function ClickLogger() {
  useEventListener(window, 'click', () => {
    console.log('Window clicked');
  });

  return <div>Click anywhere to log a message</div>;
}

Other packages similar to @react-hookz/web

react-use

react-use is a collection of essential React hooks. It offers a wide range of hooks for state management, side effects, lifecycle events, and more. Compared to @react-hookz/web, react-use has a larger community and more extensive documentation.

ahooks

ahooks is a React hooks library that provides a set of high-quality and reliable hooks. It focuses on performance and ease of use. ahooks offers similar functionalities to @react-hookz/web but also includes some unique hooks for advanced use cases.

usehooks-ts

usehooks-ts is a collection of React hooks written in TypeScript. It provides type-safe hooks for common tasks in React applications. Compared to @react-hookz/web, usehooks-ts is more focused on TypeScript users and offers type safety out of the box.

README

React hooks done right, for browser and SSR.

@react-hookz/web is a library of general-purpose React hooks built with care and SSR compatibility in mind.

Install

This one is pretty simple, everyone knows what to do:

npm i @react-hookz/web
# or
yarn add @react-hookz/web

As hooks been introduced to the world in React 16.8 @react-hookz/web has requires, you gessed it, react and react-dom 16.8+.
Also, as React does not support IE, @react-hookz/web does not do that either. You'll have to transpile your node-modules in order to run in IE.

Usage

This package provides three levels of compilation:

1. Main, the /cjs folder — CommonJS modules, with ES5 lang level.
2. ESM, the /esm folder — it is ES modules, with ES5 lang level.
3. ESNext, the /esnext folder — it is ES modules, with ESNext lang level.

So, if you need useMountEffect hook, depending on your needs, you can import in three ways ( actually there is more, but in common it is three):

// in case you need cjs modules
import { useMountEffect } from "@react-hookz/web";
// in case you need esm modules
import { useMountEffect } from "@react-hookz/web/esm";
// in case you want all the recent ES features
import { useMountEffect } from "@react-hookz/web/esnext";

Hooks list

• Lifecycle hooks

  • useFirstMountState — Return boolean that is true only on first render.
  • useUpdateEffect — Effect hook that ignores the first render (not invoked on mount).

Changelog

1.7.1 (2021-04-23)

Bug Fixes

• add ci yarn caching layer (5aa8ae1)