homebase.reagent — io.homebase/homebase-react 0.1.1

connect! cljs

(connect! db-conn)

Connects a db-conn to a homebase.cache. This is a prerequisite for any of the db read functions in this namespace (entity, q) to be reactive. Returns a homebase.cache connection.

(def db-conn (datascript/create-conn))
(hbr/connect! db-conn)

disconnect! cljs

(disconnect! db-conn)

Entity cljs

entity cljs

(entity db-conn lookup)

Returns a reactive homebase.reagent/Entity wrapped in a vector.

It offers a normalized subset of other entity APIs with the primary addition being that implemented protocols are reactive and trigger re-renders when related datoms change.

Usage:

(defn your-component []
  (let [[entity-1] (hbr/entity db-conn 1)
        [entity-2] (hbr/entity db-conn [:uniq-attr :value])]
    (fn []
      [:div
       (:attr @entity-1)
       (get-in @entity-2 [:ref-attr :attr])])))

Gotchas:

• This takes a conn, not a db.
• homebase.reagent/Entity only implements the ILookup and IFn protocols, i.e. only attribute lookups like (:attr hbr-entity).
  • Use non-reactive entities from your DB if you need to use other protocols.
    • E.g. (datascript/entity @db-conn 1)

q cljs

(q query db-conn & inputs)

Returns a reactive query result wrapped in a vector.

It will trigger a re-render when its result changes.

Usage:

(defn your-component []
  (let [[query-result] (hbr/q db-conn [:find [?e ...]
                                       :where [?e :attr]])]
    (fn []
      [:div
       (for [eid @query-result]
         ^{:key eid}[another-component eid])])))

Gotchas:

• This takes a conn, not a db.
• At the moment it's only possible to connect! to one DB at a time, so reactive query results are only supported on one DB. If you pass more DBs as args the query will only be rerun if the first DB changes.