com.fulcrologic.rad.picker-options — com.fulcrologic/fulcro-rad 0.0.14-alpha

Utilities to help support entity/enumeration pickers in the UI, along with loading/normalizing/caching the options.

Pickers are commonly used for things like autocomplete fields and (cascading) dropdowns where the list of options must be loaded dynamically due to some event in the UI.

cache-key clj/s

A keyword or (fn [cls props] keyword?) under which the normalized picker options will be saved.

cache-time-ms clj/s

How long the options can be cached. This allows multiple uses of the same options load to be used over time. Caching is done under ::cache-key.

load-options! clj/s

(load-options! app-ish form-class props attribute)

(load-options! app-ish
               form-class
               props
               {:com.fulcrologic.rad.attributes/keys [qualified-key]
                :as attribute}
               load-options)

Load picker options into the options cache for a form field.

load-picker-options! clj/s

(load-picker-options! app-ish component-class props picker-options)

(load-picker-options! app-ish component-class props picker-options load-options)

Load picker options based on raw picker options

options-xform clj/s

A (fn [normalized-result raw-result] [{:text t :value v} ...]). This generates the options to show the user. If not provided then it is assumed that the query result itself is a vector of these text/value pair maps.

query-component clj/s

A Fulcro defsc with the subquery to use for pulling options.

query-key clj/s

The top-level query keyword to use when pulling the options.

query-parameters clj/s

A map of query parameters to include in the option load, or a (fn [app cls props] map?) that can generate those props on demand.

remote clj/s

The keyword name of the remote that the picker options are loaded from. Defaults to :remote.

transform-options clj/s

INTERNAL MUTATION. Do not use.