1.1.1 • Published 7 months ago

hook-adapter v1.1.1

Weekly downloads
-
License
ISC
Repository
github
Last release
7 months ago

hook-adapter

A lightweight adapter pattern for using React hooks in class components.

Useful while transitioning from class components to functional components.

Allows you to wrap blocks of JSX within a class component with the result of a hook.

All hooks are supported, and all hook behaviors like re-renders, state updates, and side effects are preserved.

Installation

npm install hook-adapter

Usage

Hook without parameters

When the hook requires no parameters, you can simply pass the hook function itself to the hook prop of the HookAdapter component.

The result of the hook is then passed to the children of the HookAdapter component via a function children prop.

import React, { Component } from "react";
import { HookAdapter } from "hook-adapter";
import { useMyHook } from "./use-my-hook";

export class MyComponent extends Component {
  render() {
    return (
      <div>
        <HookAdapter hook={useMyHook}>
          {hookResult => <AComponentThatNeedsTheHookResult data={hookResult} />}
        </HookAdapter>
      </div>
    );
  }
}

Hooks with parameters

When the hook requires parameters, there are two approaches you can take:

  • Wrap the hook in a function that takes no parameters

    import React, { Component } from "react";
    import { HookAdapter } from "hook-adapter";
    import { useMyHook } from "./use-my-hook";
    
    export class MyComponent extends Component {
      render() {
        return (
          <div>
            <HookAdapter hook={() => useMyHook("param1", "param2")}>
              {hookResult => <AComponentThatNeedsTheHookResult data={hookResult} />}
            </HookAdapter>
          </div>
        );
      }
    }
  • Pass in the parameters to the HookAdapter component via the parameters prop

    import React, { Component } from "react";
    import { HookAdapter } from "hook-adapter";
    import { useMyHook } from "./use-my-hook";
    
    export class MyComponent extends Component {
      render() {
        return (
          <div>
            <HookAdapter hook={useMyHook} parameters={["param1", "param2"]}>
              {hookResult => <AComponentThatNeedsTheHookResult data={hookResult} />}
            </HookAdapter>
          </div>
        );
      }
    }

Both approaches are equivalent and are fully type-safe.

You may find that the latter approach works better with certain linting rules.

License

hook-adapter is licensed under the ISC license.

1.1.1

7 months ago

1.1.0

7 months ago

1.0.0

8 months ago