Repository navigation
Expand file tree
/
Copy pathindex.html
More file actions
188 lines (179 loc) · 33.4 KB
/
Copy pathindex.html
File metadata and controls
188 lines (179 loc) · 33.4 KB
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
<!doctype html>
<html><head><meta charSet="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><title>Reagent: Minimalistic React for ClojureScript</title><base/><link href="css/built.css?312b71" rel="stylesheet"/><script>try{var t=localStorage.getItem("theme");if(t)document.documentElement.dataset.theme=t}catch(e){}</script></head><body><div id="main-content"><div><div class="site"><header class="site-header"><div class="site-header-inner"><a href="./" class="brand"><span class="brand-logo"><svg xmlns="http://www.w3.org/2000/svg" width="64" height="64" viewBox="0 0 64 64">
<path stroke="#000" stroke-width="10.751" stroke-linejoin="round" paint-order="markers fill stroke" d="M5.375 5.375h53.249v53.249H5.375z"/>
<path d="M16.734 59.233h30.532c1.857 0 3.134-.5 3.714-1.4.58-1 .465-2.1-.58-3.5l-13.35-18.1v-9.1h1.741c.465 0 .813-.1 1.161-.4.348-.3.464-.6.464-1s-.116-.7-.464-1c-.348-.3-.696-.4-1.16-.4H25.208c-.465 0-.813.1-1.161.4-.348.3-.464.6-.464 1s.116.7.464 1c.348.3.696.4 1.16.4h1.742v9.1l-13.35 18.1c-1.045 1.4-1.16 2.5-.58 3.5.696.9 1.973 1.4 3.714 1.4zm13.118-21.5l.58-.7v-9.9H33.8v9.9l.58.7 13.467 18.6H16.502z" fill="#303c3c"/>
<path fill="#00d8ff" d="M35.889 42.633h-7.778l-9.055 12.6H45.06z"/>
<path d="M180 439.416a5.09 5.09 0 1 1-10.179 0 5.09 5.09 0 1 1 10.179 0z" transform="matrix(.56482 0 0 .5518 -69.11 -222.593)" fill="#00d8ff" stroke="#00d8ff"/>
<path d="M37.217 12.657a2.325 2.325 0 1 1-4.65 0 2.325 2.325 0 1 1 4.65 0z" fill="#00d8ff" stroke="#00d8ff" stroke-width=".457"/>
<path d="M31.676 6.053a1.17 1.17 0 1 0-2.341 0 1.17 1.17 0 1 0 2.341 0z" fill="#00d8ff" stroke="#00d8ff" stroke-width=".23"/>
</svg>
</span>Reagent</a><nav class="site-nav"><a href="doc/">Guide</a><a href="api/">API</a><a href="https://github.com/reagent-project/reagent/blob/master/CHANGELOG.md">Changelog</a><a href="https://github.com/reagent-project/reagent">GitHub</a></nav><div class="search"><input type="search" placeholder="Search docs & API" aria-label="Search" value=""/></div><button title="Switch to dark theme" aria-label="Toggle dark theme" class="theme-toggle"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 12.8A9 9 0 1 1 11.2 3a7 7 0 0 0 9.8 9.8z"></path></svg></button></div></header><main><div class="landing"><div class="hero-grid"><div class="hero"><h1>Reagent</h1><p class="tagline">A minimalistic ClojureScript interface to <a href="https://react.dev/">React</a>.</p><p class="hero-text">Define React components with plain ClojureScript functions
and data. Describe the UI with Hiccup, keep state in atoms, and Reagent
re-renders what changed.</p><div class="hero-actions"><a href="doc/" class="button primary">Read the guide</a><a href="doc/GettingStarted.html" class="button">Start a project</a><a href="api/" class="button">API reference</a></div><div class="install"><div class="install-label">deps.edn</div><pre><code>reagent/reagent {:mvn/version "<!-- -->2.1.0-SNAPSHOT<!-- -->"}</code></pre><div class="install-label">Leiningen</div><pre><code>[reagent "<!-- -->2.1.0-SNAPSHOT<!-- -->"]</code></pre><div class="install-label">npm</div><pre><code>npm install react react-dom</code></pre></div></div><div class="hero-demo"><div class="hero-demo-live"><span class="hero-demo-label">Live</span><div><button>Click me</button> Clicked <!-- -->0<!-- --> times</div></div><pre class="hl"><span class="hl-p0">(</span><span class="hl-builtin">defonce</span> <span class="hl-def">clicks</span> <span class="hl-p1">(</span><span class="hl-builtin">r/atom</span> <span class="hl-number">0</span><span class="hl-p1">)</span><span class="hl-p0">)</span>
<span class="hl-p0">(</span><span class="hl-builtin">r/defc</span> counter <span class="hl-p1">[</span><span class="hl-p1">]</span>
<span class="hl-p1">[</span><span class="hl-keyword">:div</span>
<span class="hl-p2">[</span><span class="hl-keyword">:button</span> <span class="hl-p0">{</span><span class="hl-keyword">:on-click</span> <span class="hl-p1">#(</span><span class="hl-builtin">swap!</span> clicks <span class="hl-builtin">inc</span><span class="hl-p1">)</span><span class="hl-p0">}</span> <span class="hl-string">"Click me"</span><span class="hl-p2">]</span>
<span class="hl-string">" Clicked "</span> @clicks <span class="hl-string">" times"</span><span class="hl-p1">]</span><span class="hl-p0">)</span>
</pre></div></div><div class="features"><div><h3>Functions and data</h3><p>Components are functions that return Hiccup vectors. No JSX, no
classes, no templates.</p></div><div><h3>Reactive atoms</h3><p>Deref a Reagent atom in a component and it re-renders when the
atom changes. Cursors and reactions build on the same idea.</p></div><div><h3>Plain React underneath</h3><p>Use React components, hooks and libraries directly, with React 18
or 19.</p></div></div><div class="reagent-demo"><div class="demo-text"><h2>Introduction to Reagent</h2><p><a href="https://github.com/reagent-project/reagent">Reagent</a> provides a minimalistic interface
between <a href="https://github.com/clojure/clojurescript">ClojureScript</a> and <a href="https://reactjs.org/">React</a>. It allows you to define efficient React
components using nothing but plain ClojureScript functions and
data, that describe your UI using a <a href="https://github.com/weavejester/hiccup">Hiccup</a>-like
syntax.</p><p>The goal of Reagent is to make it possible to define
arbitrarily complex UIs using just a couple of basic concepts,
and to be fast enough by default that you rarely have to think
about performance.</p><p>A very basic Reagent component may look something like this: </p><div><div class="demo-example clearfix"><a class="demo-example-hide">hide</a><h3 class="demo-heading">Example </h3><div class="simple-demo"><div><p>I am a component!</p><p class="someclass">I have <strong>bold</strong><span style="color:red"> and red </span>text.</p></div></div></div><div class="demo-source clearfix"><h3 class="demo-heading">Source</h3><pre class="hl"><span class="hl-p0">(</span><span class="hl-builtin">r/defc</span> simple-component <span class="hl-p1">[</span><span class="hl-p1">]</span>
<span class="hl-p1">[</span><span class="hl-keyword">:div</span>
<span class="hl-p2">[</span><span class="hl-keyword">:p</span> <span class="hl-string">"I am a component!"</span><span class="hl-p2">]</span>
<span class="hl-p2">[</span><span class="hl-keyword">:p.someclass</span>
<span class="hl-string">"I have "</span> <span class="hl-p0">[</span><span class="hl-keyword">:strong</span> <span class="hl-string">"bold"</span><span class="hl-p0">]</span>
<span class="hl-p0">[</span><span class="hl-keyword">:span</span> <span class="hl-p1">{</span><span class="hl-keyword">:style</span> <span class="hl-p2">{</span><span class="hl-keyword">:color</span> <span class="hl-string">"red"</span><span class="hl-p2">}</span><span class="hl-p1">}</span> <span class="hl-string">" and red "</span><span class="hl-p0">]</span> <span class="hl-string">"text."</span><span class="hl-p2">]</span><span class="hl-p1">]</span><span class="hl-p0">)</span>
</pre></div></div><p>You can build new components using other components as
building blocks. Like this:</p><div><div class="demo-example clearfix"><a class="demo-example-hide">hide</a><h3 class="demo-heading">Example </h3><div class="simple-demo"><div><p>I include simple-component.</p><div><p>I am a component!</p><p class="someclass">I have <strong>bold</strong><span style="color:red"> and red </span>text.</p></div></div></div></div><div class="demo-source clearfix"><h3 class="demo-heading">Source</h3><pre class="hl"><span class="hl-p0">(</span><span class="hl-builtin">r/defc</span> simple-parent <span class="hl-p1">[</span><span class="hl-p1">]</span>
<span class="hl-p1">[</span><span class="hl-keyword">:div</span>
<span class="hl-p2">[</span><span class="hl-keyword">:p</span> <span class="hl-string">"I include simple-component."</span><span class="hl-p2">]</span>
<span class="hl-p2">[</span>simple-component<span class="hl-p2">]</span><span class="hl-p1">]</span><span class="hl-p0">)</span>
</pre></div></div><p>Data is passed to child components using plain old Clojure
data types. Like this:</p><div><div class="demo-example clearfix"><a class="demo-example-hide">hide</a><h3 class="demo-heading">Example </h3><div class="simple-demo"><p>Hello, <!-- -->world<!-- -->!</p></div></div><div class="demo-source clearfix"><h3 class="demo-heading">Source</h3><pre class="hl"><span class="hl-p0">(</span><span class="hl-builtin">r/defc</span> hello-component <span class="hl-p1">[</span>name<span class="hl-p1">]</span>
<span class="hl-p1">[</span><span class="hl-keyword">:p</span> <span class="hl-string">"Hello, "</span> name <span class="hl-string">"!"</span><span class="hl-p1">]</span><span class="hl-p0">)</span>
<span class="hl-p0">(</span><span class="hl-builtin">r/defc</span> say-hello <span class="hl-p1">[</span><span class="hl-p1">]</span>
<span class="hl-p1">[</span>hello-component <span class="hl-string">"world"</span><span class="hl-p1">]</span><span class="hl-p0">)</span>
</pre></div></div><p><strong>Note: </strong>In the example above, <code>hello-component</code> might just
as well have been called as a normal Clojure function instead of
as a Reagent component, i.e with parenthesis instead of square
brackets. The only difference would have been performance, since
”real” Reagent components are only re-rendered when their data
have changed. More advanced components though (see below) must
be called with square brackets.</p><p>Here is another example that shows items in a <code>seq</code>:</p><div><div class="demo-example clearfix"><a class="demo-example-hide">hide</a><h3 class="demo-heading">Example </h3><div class="simple-demo"><div>Here is a list:<ul><li>Item <!-- -->0</li><li>Item <!-- -->1</li><li>Item <!-- -->2</li></ul></div></div></div><div class="demo-source clearfix"><h3 class="demo-heading">Source</h3><pre class="hl"><span class="hl-p0">(</span><span class="hl-builtin">r/defc</span> lister <span class="hl-p1">[</span>items<span class="hl-p1">]</span>
<span class="hl-p1">[</span><span class="hl-keyword">:ul</span>
<span class="hl-p2">(</span><span class="hl-builtin">for</span> <span class="hl-p0">[</span>item items<span class="hl-p0">]</span>
^<span class="hl-p0">{</span><span class="hl-keyword">:key</span> item<span class="hl-p0">}</span> <span class="hl-p0">[</span><span class="hl-keyword">:li</span> <span class="hl-string">"Item "</span> item<span class="hl-p0">]</span><span class="hl-p2">)</span><span class="hl-p1">]</span><span class="hl-p0">)</span>
<span class="hl-p0">(</span><span class="hl-builtin">r/defc</span> lister-user <span class="hl-p1">[</span><span class="hl-p1">]</span>
<span class="hl-p1">[</span><span class="hl-keyword">:div</span>
<span class="hl-string">"Here is a list:"</span>
<span class="hl-p2">[</span>lister <span class="hl-p0">(</span><span class="hl-builtin">range</span> <span class="hl-number">3</span><span class="hl-p0">)</span><span class="hl-p2">]</span><span class="hl-p1">]</span><span class="hl-p0">)</span>
</pre></div></div><p><strong>Note: </strong>The <code>^{:key item}</code> part above isn’t really necessary
in this simple example, but attaching a unique key to every item
in a dynamically generated list of components is good practice,
and helps React to improve performance for large lists. The key
can be given either (as in this example) as meta-data, or as a <code>:key</code> item in the first argument to a component (if it
is a map). See React’s <a href="https://reactjs.org/docs/lists-and-keys.html#keys">documentation</a>
for more info.</p></div><div class="demo-text"><h2>Managing state in Reagent</h2><p>The easiest way to manage state in Reagent is to use Reagent’s
own version of <code>atom</code>. It works exactly like the one in
clojure.core, except that it keeps track of every time it is
deref’ed. Any component that uses an <code>atom</code> is automagically
re-rendered when its value changes.</p><p>Let’s demonstrate that with a simple example:</p><div><div class="demo-example clearfix"><a class="demo-example-hide">hide</a><h3 class="demo-heading">Example </h3><div class="simple-demo"><div>The atom <code>click-count</code> has value: <!-- -->0<!-- -->. <input type="button" value="Click me!"/></div></div></div><div class="demo-source clearfix"><h3 class="demo-heading">Source</h3><pre><pre class="hl"><span class="hl-p0">(</span><span class="hl-builtin">ns</span> <span class="hl-def">example</span>
<span class="hl-p1">(</span><span class="hl-keyword">:require</span> <span class="hl-p2">[</span>reagent.core <span class="hl-keyword">:as</span> r<span class="hl-p2">]</span><span class="hl-p1">)</span><span class="hl-p0">)</span></pre><pre class="hl"><span class="hl-p0">(</span><span class="hl-builtin">def</span> <span class="hl-def">click-count</span> <span class="hl-p1">(</span><span class="hl-builtin">r/atom</span> <span class="hl-number">0</span><span class="hl-p1">)</span><span class="hl-p0">)</span>
<span class="hl-p0">(</span><span class="hl-builtin">r/defc</span> counting-component <span class="hl-p1">[</span><span class="hl-p1">]</span>
<span class="hl-p1">[</span><span class="hl-keyword">:div</span>
<span class="hl-string">"The atom "</span> <span class="hl-p2">[</span><span class="hl-keyword">:code</span> <span class="hl-string">"click-count"</span><span class="hl-p2">]</span> <span class="hl-string">" has value: "</span>
@click-count <span class="hl-string">". "</span>
<span class="hl-p2">[</span><span class="hl-keyword">:input</span> <span class="hl-p0">{</span><span class="hl-keyword">:type</span> <span class="hl-string">"button"</span> <span class="hl-keyword">:value</span> <span class="hl-string">"Click me!"</span>
<span class="hl-keyword">:on-click</span> <span class="hl-p1">#(</span><span class="hl-builtin">swap!</span> click-count <span class="hl-builtin">inc</span><span class="hl-p1">)</span><span class="hl-p0">}</span><span class="hl-p2">]</span><span class="hl-p1">]</span><span class="hl-p0">)</span>
</pre></pre></div></div><p>Sometimes you may want to maintain state locally in a
component. That is easy to do with an <code>atom</code> as well.</p><p>Here is an example of that, where we call <code>setTimeout</code> every time the component is rendered to
update a counter:</p><div><div class="demo-example clearfix"><a class="demo-example-hide">hide</a><h3 class="demo-heading">Example </h3><div class="simple-demo"><div>Seconds Elapsed: <!-- -->0</div></div></div><div class="demo-source clearfix"><h3 class="demo-heading">Source</h3><pre class="hl"><span class="hl-p0">(</span><span class="hl-builtin">defn</span> <span class="hl-def">timer-component</span> <span class="hl-p1">[</span><span class="hl-p1">]</span>
<span class="hl-p1">(</span><span class="hl-builtin">let</span> <span class="hl-p2">[</span>seconds-elapsed <span class="hl-p0">(</span><span class="hl-builtin">r/atom</span> <span class="hl-number">0</span><span class="hl-p0">)</span><span class="hl-p2">]</span>
<span class="hl-p2">(</span><span class="hl-builtin">fn</span> <span class="hl-p0">[</span><span class="hl-p0">]</span>
<span class="hl-p0">(</span><span class="hl-builtin">js/setTimeout</span> <span class="hl-p1">#(</span><span class="hl-builtin">swap!</span> seconds-elapsed <span class="hl-builtin">inc</span><span class="hl-p1">)</span> <span class="hl-number">1000</span><span class="hl-p0">)</span>
<span class="hl-p0">[</span><span class="hl-keyword">:div</span>
<span class="hl-string">"Seconds Elapsed: "</span> @seconds-elapsed<span class="hl-p0">]</span><span class="hl-p2">)</span><span class="hl-p1">)</span><span class="hl-p0">)</span>
</pre></div></div><p>The previous example also uses another feature of Reagent: a
component function can return another function, that is used to do
the actual rendering. This function is called with the same
arguments as the first one.</p><p>This allows you to perform some setup of newly created
components without resorting to React’s lifecycle events.</p><p>By simply passing an <code>atom</code> around you can share
state management between components, like this:</p><div><div class="demo-example clearfix"><a class="demo-example-hide">hide</a><h3 class="demo-heading">Example </h3><div class="simple-demo"><div><p>The value is now: <!-- -->foo</p><p>Change it here: <input type="text" value="foo"/></p></div></div></div><div class="demo-source clearfix"><h3 class="demo-heading">Source</h3><pre><pre class="hl"><span class="hl-p0">(</span><span class="hl-builtin">ns</span> <span class="hl-def">example</span>
<span class="hl-p1">(</span><span class="hl-keyword">:require</span> <span class="hl-p2">[</span>reagent.core <span class="hl-keyword">:as</span> r<span class="hl-p2">]</span><span class="hl-p1">)</span><span class="hl-p0">)</span></pre><pre class="hl"><span class="hl-p0">(</span><span class="hl-builtin">r/defc</span> atom-input <span class="hl-p1">[</span>value<span class="hl-p1">]</span>
<span class="hl-p1">[</span><span class="hl-keyword">:input</span> <span class="hl-p2">{</span><span class="hl-keyword">:type</span> <span class="hl-string">"text"</span>
<span class="hl-keyword">:value</span> @value
<span class="hl-keyword">:on-change</span> <span class="hl-p0">#(</span><span class="hl-builtin">reset!</span> value <span class="hl-p1">(</span><span class="hl-builtin">-></span> <span class="hl-builtin">%</span> .-target .-value<span class="hl-p1">)</span><span class="hl-p0">)</span><span class="hl-p2">}</span><span class="hl-p1">]</span><span class="hl-p0">)</span>
<span class="hl-p0">(</span><span class="hl-builtin">defn</span> <span class="hl-def">shared-state</span> <span class="hl-p1">[</span><span class="hl-p1">]</span>
<span class="hl-p1">(</span><span class="hl-builtin">let</span> <span class="hl-p2">[</span>val <span class="hl-p0">(</span><span class="hl-builtin">r/atom</span> <span class="hl-string">"foo"</span><span class="hl-p0">)</span><span class="hl-p2">]</span>
<span class="hl-p2">(</span><span class="hl-builtin">fn</span> <span class="hl-p0">[</span><span class="hl-p0">]</span>
<span class="hl-p0">[</span><span class="hl-keyword">:div</span>
<span class="hl-p1">[</span><span class="hl-keyword">:p</span> <span class="hl-string">"The value is now: "</span> @val<span class="hl-p1">]</span>
<span class="hl-p1">[</span><span class="hl-keyword">:p</span> <span class="hl-string">"Change it here: "</span> <span class="hl-p2">[</span>atom-input val<span class="hl-p2">]</span><span class="hl-p1">]</span><span class="hl-p0">]</span><span class="hl-p2">)</span><span class="hl-p1">)</span><span class="hl-p0">)</span>
</pre></pre></div></div><p><strong>Note: </strong>Component functions can be called with any
arguments – as long as they are immutable. You <em>could</em> use
mutable objects as well, but then you have to make sure that the
component is updated when your data changes. Reagent assumes by
default that two objects are equal if they are the same object.</p></div><div class="demo-text"><h2>Essential API</h2><p>Reagent supports most of React’s API, but there is really only
one entry-point that is necessary for most applications: <code>reagent.dom.client/render</code>.</p><p>Create a React root for a DOM node with <code>create-root</code>, then render a component into it. For
example, splashing the very first example all over the page would
look like this:</p><div><div class="demo-source clearfix"><h3 class="demo-heading">Source</h3><pre><pre class="hl"><span class="hl-p0">(</span><span class="hl-builtin">ns</span> <span class="hl-def">example</span>
<span class="hl-p1">(</span><span class="hl-keyword">:require</span> <span class="hl-p2">[</span>reagent.dom.client <span class="hl-keyword">:as</span> rdomc<span class="hl-p2">]</span><span class="hl-p1">)</span><span class="hl-p0">)</span></pre><pre class="hl"><span class="hl-p0">(</span><span class="hl-builtin">r/defc</span> simple-component <span class="hl-p1">[</span><span class="hl-p1">]</span>
<span class="hl-p1">[</span><span class="hl-keyword">:div</span>
<span class="hl-p2">[</span><span class="hl-keyword">:p</span> <span class="hl-string">"I am a component!"</span><span class="hl-p2">]</span>
<span class="hl-p2">[</span><span class="hl-keyword">:p.someclass</span>
<span class="hl-string">"I have "</span> <span class="hl-p0">[</span><span class="hl-keyword">:strong</span> <span class="hl-string">"bold"</span><span class="hl-p0">]</span>
<span class="hl-p0">[</span><span class="hl-keyword">:span</span> <span class="hl-p1">{</span><span class="hl-keyword">:style</span> <span class="hl-p2">{</span><span class="hl-keyword">:color</span> <span class="hl-string">"red"</span><span class="hl-p2">}</span><span class="hl-p1">}</span> <span class="hl-string">" and red "</span><span class="hl-p0">]</span> <span class="hl-string">"text."</span><span class="hl-p2">]</span><span class="hl-p1">]</span><span class="hl-p0">)</span>
<span class="hl-p0">(</span><span class="hl-builtin">defn</span> <span class="hl-def">render-simple</span> <span class="hl-p1">[</span><span class="hl-p1">]</span>
<span class="hl-p1">(</span><span class="hl-builtin">let</span> <span class="hl-p2">[</span>root <span class="hl-p0">(</span><span class="hl-builtin">rdomc/create-root</span> <span class="hl-p1">(</span><span class="hl-builtin">js/document.getElementById</span> <span class="hl-string">"app"</span><span class="hl-p1">)</span><span class="hl-p0">)</span><span class="hl-p2">]</span>
<span class="hl-p2">(</span><span class="hl-builtin">rdomc/render</span> root <span class="hl-p0">[</span>simple-component<span class="hl-p0">]</span><span class="hl-p2">)</span><span class="hl-p1">)</span><span class="hl-p0">)</span>
</pre></pre></div></div></div><div class="demo-text"><h2>Putting it all together</h2><p>Here is a slightly less contrived example: a simple BMI
calculator.</p><p>Data is kept in a single <code>reagent.core/atom</code>: a map
with height, weight and BMI as keys.</p><div><div class="demo-example clearfix"><a class="demo-example-hide">hide</a><h3 class="demo-heading">Example </h3><div class="simple-demo"><div><h3>BMI calculator</h3><div>Height: <!-- -->180<!-- -->cm<input type="range" min="100" max="220" style="width:100%" value="180"/></div><div>Weight: <!-- -->80<!-- -->kg<input type="range" min="30" max="150" style="width:100%" value="80"/></div><div>BMI: <!-- -->24<!-- --> <span style="color:inherit">normal</span><input type="range" min="10" max="50" style="width:100%" value="24.691358024691358"/></div></div></div></div><div class="demo-source clearfix"><h3 class="demo-heading">Source</h3><pre><pre class="hl"><span class="hl-p0">(</span><span class="hl-builtin">ns</span> <span class="hl-def">example</span>
<span class="hl-p1">(</span><span class="hl-keyword">:require</span> <span class="hl-p2">[</span>reagent.core <span class="hl-keyword">:as</span> r<span class="hl-p2">]</span><span class="hl-p1">)</span><span class="hl-p0">)</span></pre><pre class="hl"><span class="hl-p0">(</span><span class="hl-builtin">defn</span> <span class="hl-def">calc-bmi</span> <span class="hl-p1">[</span><span class="hl-p2">{</span><span class="hl-keyword">:keys</span> <span class="hl-p0">[</span>height weight bmi<span class="hl-p0">]</span> <span class="hl-keyword">:as</span> data<span class="hl-p2">}</span><span class="hl-p1">]</span>
<span class="hl-p1">(</span><span class="hl-builtin">let</span> <span class="hl-p2">[</span>h <span class="hl-p0">(</span>/ height <span class="hl-number">100</span><span class="hl-p0">)</span><span class="hl-p2">]</span>
<span class="hl-p2">(</span><span class="hl-builtin">if</span> <span class="hl-p0">(</span><span class="hl-builtin">nil?</span> bmi<span class="hl-p0">)</span>
<span class="hl-p0">(</span><span class="hl-builtin">assoc</span> data <span class="hl-keyword">:bmi</span> <span class="hl-p1">(</span>/ weight <span class="hl-p2">(</span>* h h<span class="hl-p2">)</span><span class="hl-p1">)</span><span class="hl-p0">)</span>
<span class="hl-p0">(</span><span class="hl-builtin">assoc</span> data <span class="hl-keyword">:weight</span> <span class="hl-p1">(</span>* bmi h h<span class="hl-p1">)</span><span class="hl-p0">)</span><span class="hl-p2">)</span><span class="hl-p1">)</span><span class="hl-p0">)</span>
<span class="hl-p0">(</span><span class="hl-builtin">def</span> <span class="hl-def">bmi-data</span> <span class="hl-p1">(</span><span class="hl-builtin">r/atom</span> <span class="hl-p2">(</span>calc-bmi <span class="hl-p0">{</span><span class="hl-keyword">:height</span> <span class="hl-number">180</span> <span class="hl-keyword">:weight</span> <span class="hl-number">80</span><span class="hl-p0">}</span><span class="hl-p2">)</span><span class="hl-p1">)</span><span class="hl-p0">)</span>
<span class="hl-p0">(</span><span class="hl-builtin">r/defc</span> slider <span class="hl-p1">[</span>param value min max invalidates<span class="hl-p1">]</span>
<span class="hl-p1">[</span><span class="hl-keyword">:input</span> <span class="hl-p2">{</span><span class="hl-keyword">:type</span> <span class="hl-string">"range"</span> <span class="hl-keyword">:value</span> value <span class="hl-keyword">:min</span> min <span class="hl-keyword">:max</span> max
<span class="hl-keyword">:style</span> <span class="hl-p0">{</span><span class="hl-keyword">:width</span> <span class="hl-string">"100%"</span><span class="hl-p0">}</span>
<span class="hl-keyword">:on-change</span> <span class="hl-p0">(</span><span class="hl-builtin">fn</span> <span class="hl-p1">[</span>e<span class="hl-p1">]</span>
<span class="hl-p1">(</span><span class="hl-builtin">let</span> <span class="hl-p2">[</span>new-value <span class="hl-p0">(</span><span class="hl-builtin">js/parseInt</span> <span class="hl-p1">(</span>.. e -target -value<span class="hl-p1">)</span><span class="hl-p0">)</span><span class="hl-p2">]</span>
<span class="hl-p2">(</span><span class="hl-builtin">swap!</span> bmi-data
<span class="hl-p0">(</span><span class="hl-builtin">fn</span> <span class="hl-p1">[</span>data<span class="hl-p1">]</span>
<span class="hl-p1">(</span><span class="hl-builtin">-></span> data
<span class="hl-p2">(</span><span class="hl-builtin">assoc</span> param new-value<span class="hl-p2">)</span>
<span class="hl-p2">(</span><span class="hl-builtin">dissoc</span> invalidates<span class="hl-p2">)</span>
calc-bmi<span class="hl-p1">)</span><span class="hl-p0">)</span><span class="hl-p2">)</span><span class="hl-p1">)</span><span class="hl-p0">)</span><span class="hl-p2">}</span><span class="hl-p1">]</span><span class="hl-p0">)</span>
<span class="hl-p0">(</span><span class="hl-builtin">r/defc</span> bmi-component <span class="hl-p1">[</span><span class="hl-p1">]</span>
<span class="hl-p1">(</span><span class="hl-builtin">let</span> <span class="hl-p2">[</span><span class="hl-p0">{</span><span class="hl-keyword">:keys</span> <span class="hl-p1">[</span>weight height bmi<span class="hl-p1">]</span><span class="hl-p0">}</span> @bmi-data
<span class="hl-p0">[</span>color diagnose<span class="hl-p0">]</span> <span class="hl-p0">(</span><span class="hl-builtin">cond</span>
<span class="hl-p1">(</span>< bmi <span class="hl-number">18.5</span><span class="hl-p1">)</span> <span class="hl-p1">[</span><span class="hl-string">"orange"</span> <span class="hl-string">"underweight"</span><span class="hl-p1">]</span>
<span class="hl-p1">(</span>< bmi <span class="hl-number">25</span><span class="hl-p1">)</span> <span class="hl-p1">[</span><span class="hl-string">"inherit"</span> <span class="hl-string">"normal"</span><span class="hl-p1">]</span>
<span class="hl-p1">(</span>< bmi <span class="hl-number">30</span><span class="hl-p1">)</span> <span class="hl-p1">[</span><span class="hl-string">"orange"</span> <span class="hl-string">"overweight"</span><span class="hl-p1">]</span>
<span class="hl-keyword">:else</span> <span class="hl-p1">[</span><span class="hl-string">"red"</span> <span class="hl-string">"obese"</span><span class="hl-p1">]</span><span class="hl-p0">)</span><span class="hl-p2">]</span>
<span class="hl-p2">[</span><span class="hl-keyword">:div</span>
<span class="hl-p0">[</span><span class="hl-keyword">:h3</span> <span class="hl-string">"BMI calculator"</span><span class="hl-p0">]</span>
<span class="hl-p0">[</span><span class="hl-keyword">:div</span>
<span class="hl-string">"Height: "</span> <span class="hl-p1">(</span><span class="hl-builtin">int</span> height<span class="hl-p1">)</span> <span class="hl-string">"cm"</span>
<span class="hl-p1">[</span>slider <span class="hl-keyword">:height</span> height <span class="hl-number">100</span> <span class="hl-number">220</span> <span class="hl-keyword">:bmi</span><span class="hl-p1">]</span><span class="hl-p0">]</span>
<span class="hl-p0">[</span><span class="hl-keyword">:div</span>
<span class="hl-string">"Weight: "</span> <span class="hl-p1">(</span><span class="hl-builtin">int</span> weight<span class="hl-p1">)</span> <span class="hl-string">"kg"</span>
<span class="hl-p1">[</span>slider <span class="hl-keyword">:weight</span> weight <span class="hl-number">30</span> <span class="hl-number">150</span> <span class="hl-keyword">:bmi</span><span class="hl-p1">]</span><span class="hl-p0">]</span>
<span class="hl-p0">[</span><span class="hl-keyword">:div</span>
<span class="hl-string">"BMI: "</span> <span class="hl-p1">(</span><span class="hl-builtin">int</span> bmi<span class="hl-p1">)</span> <span class="hl-string">" "</span>
<span class="hl-p1">[</span><span class="hl-keyword">:span</span> <span class="hl-p2">{</span><span class="hl-keyword">:style</span> <span class="hl-p0">{</span><span class="hl-keyword">:color</span> color<span class="hl-p0">}</span><span class="hl-p2">}</span> diagnose<span class="hl-p1">]</span>
<span class="hl-p1">[</span>slider <span class="hl-keyword">:bmi</span> bmi <span class="hl-number">10</span> <span class="hl-number">50</span> <span class="hl-keyword">:weight</span><span class="hl-p1">]</span><span class="hl-p0">]</span><span class="hl-p2">]</span><span class="hl-p1">)</span><span class="hl-p0">)</span>
</pre></pre></div></div></div><div class="demo-text"><h2>Performance</h2><p>React itself is very fast, and so is Reagent. In fact, Reagent
will be even faster than plain React a lot of the time, thanks to
optimizations made possible by ClojureScript.</p><p>Mounted components are only re-rendered when their parameters
have changed. The change could come from a deref’ed <code>atom</code>, the arguments passed to the component or
component state.</p><p>All of these are checked for changes with <code>identical?</code> which is basically only a pointer
comparison, so the overhead is very low. Maps passed as arguments
to components are compared the same way: they are considered equal
if all their entries are identical. This also applies to built-in
React components like <code>:div</code>, <code>:p</code>, etc.</p><p>All this means that you simply won’t have to care about
performance most of the time. Just define your UI however you like
– it will be fast enough.</p><p>There are a couple of situations that you might have to care
about, though. If you give Reagent a big <code>seq</code> of
components to render, you might have to supply all of them with a
unique <code>:key</code> attribute to speed up rendering (see
above). Also note that anonymous functions are not, in general,
equal to each other even if they represent the same code and
closure.</p><p>But again, in general you should just trust that React and
Reagent will be fast enough. This very page is composed of a single
Reagent component with thousands of child components (every single
parenthesis etc in the code examples is a separate component), and
yet the page can be updated many times every second without taxing
the browser the slightest.</p><p>Incidentally, this page also uses another React trick: the
entire page is pre-rendered using Node, and <code>reagent.dom.server/render-to-string</code>. When it is loaded
into the browser, React automatically attaches event-handlers to
the already present DOM tree.</p></div></div></div></main><footer class="site-footer"><a href="https://github.com/reagent-project/reagent">GitHub</a> · <a href="https://cljdoc.org/d/reagent/reagent/">cljdoc</a> · <a href="https://clojurians.slack.com/messages/reagent/">#reagent on Clojurians Slack</a> · <a href="news/">Archive</a></footer></div></div></div><script>var pageConfig = {"page-path":"/"}</script><script src="js/main.js?9eb1e3" type="text/javascript"></script></body></html>