State management

hx fully embraces vanilla React development; it does not provide any additional functionality than the core React library.

However, React already provides a rich API for doing state management and other common effects in a UI application: React Hooks.

React Hooks are a powerful system for representing side effects we want to occur while our application is operating such as changing state, firing network requests, subscribing to external sources, etc.

hx provides a small helper library called hx.hooks that offers a Clojure-first API to the React Hooks API.

You may also leverage any Hooks libraries that you may find, since hx components are pure React components that are compatible with all of the external React ecosystem.

Examples:

• workshop.sortable: An example using the "react-sortable-hoc" library and React Hooks.
• workshop.state: A few short examples of using React Hooks to handle a counter and a timer. Includes an example using Context and reducer pattern.

hx.hooks

The idiom that this library provides is: any Hook is named like useAbcXyz to provide at-a-glance recognition of what Hooks a component uses.

All of the Rules of Hooks apply.

useState: ([initial])

Takes an initial value. Returns a tuple [value set-value], where set-value is a function that can be used like swap!:

;; a raw value
(set-value {:this-is "new state"})

;; a function to apply
(set-value (fn [old-state] (conj old-state :updated)))

;; a function to apply and arguments to prepend
(set-value conj :update)

useIRef: ([initial])

Takes an initial value. Returns an atom that will NOT re-render component on change.

useReducer: ([reducer initialArg init])

Just react/useReducer.

useEffect: ([f deps])

Just react/useEffect. deps can be a CLJS collection.

useContext: ([context])

Just react/useContext.

useMemo: ([f deps])

Just react/useMemo. deps can be a CLJS collection.

useValue: ([x])

Caches x. When a new x is passed in, returns new x only if it is not equal to the previous x.

Useful for optimizing useEffect et. al. when you have two values that might be structurally equal by referentially different.

useCallback: ([f])

Just react/useCallback.

useImperativeHandle: ([ref createHandle deps])

Just react/useImperativeHandle. deps can be a CLJS collection.

useLayoutEffect: ([f deps])

Just react/useLayoutEffect. deps can be a CLJS collection.

useDebugValue: ([v formatter])

Just react/useDebugValue. deps can be a CLJS collection.