🎁 A collection of Higher-Order Components for React
JavaScript

readme.md

@hocs

ci coverage

A collection of Higher-Order Components for React, especially useful with Recompose.

A Higher-Order Component is a function that takes a component and returns a new component.

Packages

🚱 omit-props

Helps to omit unnecessary context, state setters or anything else you don't want to propagate with {...spread}.

♻️ with-lifecycle

Provides a handy way to use some of React Component Lifecycle methods.

↔️ with-match-media-props

Dynamically map CSS Media Queries matches to boolean props using window.matchMedia() (Can I use?).

πŸ‘€ with-intersection-observer-props

Dynamically map visibility of a component to boolean props using Intersection Observer API (Can I use?).

πŸ™ˆ with-page-visibility-props

Dynamically map page visibility state to boolean props using Page Visibility API (Can I use?).

βŒ›οΈ debounce-handler

Helps to debounce handlers like onChange.

βŒ›οΈ throttle-handler

Helps to throttle handlers like onChange.

⛔️ prevent-handlers-default

Decouples e.preventDefault() side effect from handlers like form submitting or clicking a link.

⌚️ safe-timers

Provides safe versions of setTimeout, setInterval, requestAnimationFrame and requestIdleCallback which will be cleared/cancelled automatically before component is unmounted.

πŸ”” with-callback-on-change

Invokes a callback on prop change, useful to decouple side effects like onChange handler in a declarative way.

πŸ”” with-callback-on-change-while

Invokes a callback on prop change while condition is true, useful to decouple side effects like onChange handler in a declarative way and control loops.

πŸ”” with-callback-once

Invokes a callback once condition is true (while previous check was false), useful to decouple side effects like onSuccess or onError handlers in a declarative way.

πŸ” with-log

Injects console.log with props or any custom message into render.

πŸ” with-debugger

Injects debugger into render.

…and more to come

You can follow me on Twitter for updates.

Development

  1. Create a new folder in packages/, let's say with-foo.
  2. See package.json in already existing packages and create new with-foo/package.json.
  3. Put source code in with-foo/src/, it will be transpiled and bundled into with-foo/dist/, with-foo/lib/ and with-foo/es/.
  4. Put tests written with Jest in with-foo/test/.
  5. Put demo in with-foo/demo/, it will be rendered and wrapped with HMR.

Available scripts using Start:

yarn start build <package>
yarn start demo <package>
yarn start test
yarn start testWatch
yarn start lint