react-basic-hooks
This is library adds React hooks to react-basic.
Warning: This API relies on recent React versions (>= 16.8.0). 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 became 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:
- Counter with an effect
- Reducer/action-style
- Controlled inputs
- Components: Parent and Child
- Refs to DOM nodes (and extracting hook logic from a component for reuse)
- A Todo App (components, inputs, state)
- Context (creating and consuming React context)
- Aff helper (async state management)
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 }
.