Install

Using your package manager of choice:

# npm
npm i @zmrl/tackle-box

# yarn
yarn add @zmrl/tackle-box

# pnpm
pnpm add @zmrl/tackle-box

Hooks

useEvent

Memoize a callback function that holds the same function reference on every render.

Use it anywhere you need a stable event handler

import { useEvent } from "@zmrl/tackle-box";

function App() {
  const stableFunction = useEvent(() => console.log("I am stable 🙂"));

  return <SomeMemoizedComponent doThing={stableFunction} />;
}

• This function is based on the upcoming react RFC. It isn't quite there yet but I need it right away.

useForkRef

Create a function that will set both passed refs. Useful as a way to merge refs and pass a single function to a child

import { type ReactNode, forwardRef, useRef } from 'react'
import { useForkRef } from "@zmrl/tackle-box";

interface Props {
  children: ReactNode
}

const Child = forwardRef<HTMLDivElement, Props>(function Child(props, ref) {
  const newRef = useRef<HTMLDivElement>()
  const handleRef = useForkRef(ref, newRef)

  return (
    <div ref={handleRef}>
      👍
    </div>
  )
})

function App() {
  const ref = useRef<HTMLDivElement>()

  return <Child ref={ref} />;
}

useIsoLayoutEffect

Isomorphic layout effect that falls back to useEffect when server rendering

use it as you would useEffect or useLayoutEffect

import { useIsoLayoutEffect } from "@zmrl/tackle-box";

function App() {
  useIsoLayoutEffect(() => {
    return subscribeToSomething();
  }, []);

  return <ChildrenComponents />;
}