/
dom.clj
222 lines (194 loc) · 9.85 KB
/
dom.clj
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
(ns com.fulcrologic.fulcro.dom
"MACROS for generating CLJS code. See dom.cljs. There are both CLJ and CLJS versions of this file, but *both* are
form CLJS. The CLJ file is necessary because macros in CLJS are expanded at compile time in the JVM. There is
no way to get macros and functions that work properly for both CLJ and CLJS output, so in order to get
both a macro and function that is usable in CLJ and CLJS there need to be two namespaces. The DOM macros/functions
that work for CLJ are in `dom-server`.
Thus, if you are using these in a CLJC file, you MUST require them like this:
```
(ns my-thing.ui
(:require
#?(:clj [com.fulcrologic.fulcro.dom-server :as dom]
:cljs [com.fulcrologic.fulcro.dom :as dom])))
```
This is a limitation of the operation of the language itself (if you want both macros for performance in CLJ and CLJS
(expanded at compile time to optimal form) as well as function versions for use as lambdas).
"
(:refer-clojure :exclude [map meta time mask select use set symbol filter])
(:require
[clojure.spec.alpha :as s]
[com.fulcrologic.fulcro.algorithms.do-not-use :as util]
[com.fulcrologic.fulcro.components :as comp]
[com.fulcrologic.fulcro.dom-common :as cdom]
[clojure.string :as str]
[taoensso.timbre :as log]
[cljs.env :as cljs-env])
(:import
(cljs.tagged_literals JSValue)
(clojure.lang ExceptionInfo)))
(defn wrap-inputs? [] (not (false? (:wrap-inputs? (comp/current-config)))))
(defn- map-of-literals? [v]
(and (map? v) (not-any? symbol? (tree-seq #(or (map? %) (vector? %) (seq? %)) seq v))))
(s/def ::map-of-literals map-of-literals?)
(defn- map-with-expr? [v]
(and (map? v) (some #(or (symbol? %) (list? %)) (tree-seq #(or (map? %) (vector? %) (seq? %)) seq v))))
(s/def ::map-with-expr map-with-expr?)
(s/def ::dom-macro-args
(s/cat
:css (s/? keyword?)
:attrs (s/? (s/or :nil nil?
:map ::map-of-literals
:runtime-map ::map-with-expr
:js-object #(instance? JSValue %)
:expression list?
:symbol symbol?))
:children (s/* (s/or :string string?
:number number?
:symbol symbol?
:nil nil?
:list sequential?))))
(defn clj-map->js-object
"Recursively convert a map to a JS object. For use in macro expansion."
[m]
{:pre [(map? m)]}
(JSValue. (into {}
(clojure.core/map (fn [[k v]]
(cond
(map? v) [k (clj-map->js-object v)]
(vector? v) [k (mapv #(if (map? %) (clj-map->js-object %) %) v)]
(symbol? v) [k `(cljs.core/clj->js ~v)]
:else [k v])))
m)))
(defn emit-tag
"PRIVATE. DO NOT USE.
Helper function for generating CLJS DOM macros. is public for code gen problems."
[str-tag-name args]
(let [conformed-args (util/conform! ::dom-macro-args args)
{attrs :attrs
children :children
css :css} conformed-args
css-props (cdom/add-kwprops-to-props {} css)
raw-children (mapv second children)
children (mapv (fn [[_ c]]
(if (or (nil? c) (string? c))
c
`(comp/force-children ~c))) children)
attrs-type (or (first attrs) :nil) ; attrs omitted == nil
attrs-value (or (second attrs) {})
create-element (case str-tag-name
"input" 'com.fulcrologic.fulcro.dom/macro-create-wrapped-form-element
"textarea" 'com.fulcrologic.fulcro.dom/macro-create-wrapped-form-element
"select" 'com.fulcrologic.fulcro.dom/macro-create-wrapped-form-element
"option" 'com.fulcrologic.fulcro.dom/macro-create-wrapped-form-element
'com.fulcrologic.fulcro.dom/macro-create-element*)
classes-expression? (and (= attrs-type :map) (contains? attrs-value :classes))
attrs-type (if classes-expression? :runtime-map attrs-type)]
(case attrs-type
:js-object ; kw combos not supported
(if css
(let [attr-expr `(cdom/add-kwprops-to-props ~attrs-value ~css)]
`(~create-element ~(JSValue. (into [str-tag-name attr-expr] children))))
`(~create-element ~(JSValue. (into [str-tag-name attrs-value] children))))
:map
`(~create-element ~(JSValue. (into [str-tag-name (-> attrs-value
(cdom/add-kwprops-to-props css)
(clj-map->js-object))]
children)))
:runtime-map
`(com.fulcrologic.fulcro.dom/macro-create-element ~str-tag-name ~(into [attrs-value] raw-children) ~css)
(:symbol :expression)
`(com.fulcrologic.fulcro.dom/macro-create-element
~str-tag-name ~(into [attrs-value] raw-children) ~css)
:nil
`(~create-element
~(JSValue. (into [str-tag-name (JSValue. css-props)] children)))
;; pure children
`(com.fulcrologic.fulcro.dom/macro-create-element
~str-tag-name ~(JSValue. (into [attrs-value] raw-children)) ~css))))
(defn emit-tag-unwrapped
"PRIVATE. DO NOT USE. Same as emit-tag, but does no wrap inputs."
[str-tag-name args]
(let [conformed-args (util/conform! ::dom-macro-args args)
{attrs :attrs
children :children
css :css} conformed-args
css-props (cdom/add-kwprops-to-props {} css)
raw-children (mapv second children)
children (mapv (fn [[_ c]]
(if (or (nil? c) (string? c))
c
`(comp/force-children ~c))) children)
attrs-type (or (first attrs) :nil) ; attrs omitted == nil
attrs-value (or (second attrs) {})
raw-create-element 'com.fulcrologic.fulcro.dom/macro-create-element*
runtime-create-element 'com.fulcrologic.fulcro.dom/macro-create-unwrapped-element
classes-expression? (and (= attrs-type :map) (contains? attrs-value :classes))
attrs-type (if classes-expression? :runtime-map attrs-type)]
(case attrs-type
:js-object ; kw combos not supported
(if css
(let [attr-expr `(cdom/add-kwprops-to-props ~attrs-value ~css)]
`(~raw-create-element ~(JSValue. (into [str-tag-name attr-expr] children))))
`(~raw-create-element ~(JSValue. (into [str-tag-name attrs-value] children))))
:map
`(~raw-create-element ~(JSValue. (into [str-tag-name (-> attrs-value
(cdom/add-kwprops-to-props css)
(clj-map->js-object))]
children)))
:runtime-map
`(~runtime-create-element ~str-tag-name ~(into [attrs-value] raw-children) ~css)
(:symbol :expression)
`(~runtime-create-element
~str-tag-name ~(into [attrs-value] raw-children) ~css)
:nil
`(~raw-create-element
~(JSValue. (into [str-tag-name (JSValue. css-props)] children)))
;; pure children
`(~runtime-create-element
~str-tag-name ~(JSValue. (into [attrs-value] raw-children)) ~css))))
(defn syntax-error
"Format a DOM syntax error"
[and-form ex]
(let [location (clojure.core/meta and-form)
file (some-> (:file location) (str/replace #".*[/]" ""))
line (:line location)
unexpected-input (::s/value (ex-data ex))]
(str "Syntax error at " file ":" line ". Unexpected input " unexpected-input)))
(defn gen-dom-macro [emitter name]
`(defmacro ~name ~(cdom/gen-docstring name true)
[& ~'args]
(let [tag# ~(str name)]
(try
(~emitter tag# ~'args)
(catch ExceptionInfo e#
(throw (ex-info (syntax-error ~'&form e#) (ex-data e#))))))))
(defmacro gen-dom-macros
([emitter unwrapped-emitter]
(.println System/out (str "Using wrapped inputs? " (wrap-inputs?)))
(if (wrap-inputs?)
`(do ~@(clojure.core/map (partial gen-dom-macro emitter) cdom/tags))
`(do ~@(clojure.core/map (partial gen-dom-macro unwrapped-emitter) cdom/tags))))
([emitter]
`(do ~@(clojure.core/map (partial gen-dom-macro emitter) cdom/tags))))
(defn- gen-client-dom-fn [create-element-symbol tag]
`(defn ~tag ~(cdom/gen-docstring tag true)
[& ~'args]
(let [conformed-args# (com.fulcrologic.fulcro.dom/parse-args ~'args) ; see CLJS file for spec
{attrs# :attrs
children# :children
css# :css} conformed-args#
children# (mapv second children#)
attrs-value# (or (second attrs#) {})]
(~create-element-symbol ~(name tag) (into [attrs-value#] children#) css#))))
(defmacro gen-client-dom-fns
([create-element-sym]
`(do ~@(clojure.core/map (partial gen-client-dom-fn create-element-sym) cdom/tags)))
([create-element-sym create-unwrapped-element-sym]
(if (wrap-inputs?)
(do
(log/info "Using Wrapped inputs")
`(do ~@(clojure.core/map (partial gen-client-dom-fn create-element-sym) cdom/tags)))
(do
(log/info "Using RAW inputs. Remember to use `comp/transact!!` for sync updates on DOM events.")
`(do ~@(clojure.core/map (partial gen-client-dom-fn create-unwrapped-element-sym) cdom/tags))))))
(gen-dom-macros com.fulcrologic.fulcro.dom/emit-tag com.fulcrologic.fulcro.dom/emit-tag-unwrapped)