Package

purescript-react-basic-hooks

Repository
spicydonuts/purescript-react-basic-hooks
License
Apache-2.0
Uploaded by
spicydonuts
Published on
2019-02-10

This is an experimental implementation of React hooks on react-basic.

Warning: This API is experimental and relies on alpha-release React versions. It's here to allow experimentation while we get feedback on the API and wait for an official React release which supports hooks. For more info on hooks, see React's documentation.

I recommend using PureScript's new "qualified do" syntax while using this library (it's used in the examples, the React.do bits). It's available in the 0.12.2 compiler release.

This library provides the React.Basic.Hooks module, which can completely replace the React.Basic module. It borrows a few types from the current React.Basic module like ReactComponent and JSX to make it easy to use both versions in the same project. If we prefer this API over the existing react-basic API, we may eventually replace React.Basic with this implementation.

Example

mkCounter :: CreateComponent {}
mkCounter = do
  component "Counter" \props -> React.do
    counter /\ setCounter <- useState 0

    React.pure $ R.button
      { onClick: handler_ $ setCounter (_ + 1)
      , children: [ R.text $ "Increment: " <> show counter ]
      }

More examples:

A note on Refs: The Ref type is useful for all kinds of state (anything which shouldn't trigger a render when changed), particularly references to DOM nodes as in the example. Unfortunately, while this module remains a small extension to the existing react-basic library it won't be possible to pass a ref prop to the native DOM components from React.Basic.DOM. In the meantime, use element (unsafeCreateDOMComponent "div") { ref: elementRef }.