<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:media="http://search.yahoo.com/mrss/">
<channel>
<title><![CDATA[Data Visualization - Rafael Quintanilha]]></title>
<description><![CDATA[Essays about software engineering, web development, artificial intelligence, quantitative analysis, financial markets, books and tradition.]]></description>
<link>https://rafaelquintanilha.com/topic/data-visualization/</link>
<image><url>https://rafaelquintanilha.com/content/images/2022/12/Logo-Design--2-.png</url><title>Data Visualization - Rafael Quintanilha</title><link>https://rafaelquintanilha.com/topic/data-visualization/</link></image>
<lastBuildDate>Mon, 14 Oct 2024 22:45:27 GMT</lastBuildDate>
<atom:link href="https://rafaelquintanilha.com/topic/data-visualization/rss/" rel="self" type="application/rss+xml"/>
<ttl>60</ttl>
<item>
<title><![CDATA[Introducing React Line Chart]]></title>
<description><![CDATA[Easily visualize your data with a customizable line chart.]]></description>
<link>https://rafaelquintanilha.com/introducing-react-line-chart/</link>
<guid isPermaLink="false">63702d7742a473003d9dc81f</guid>
<category><![CDATA[React]]></category><category><![CDATA[Data Visualization]]></category>
<dc:creator><![CDATA[Rafael Quintanilha]]></dc:creator>
<pubDate>Tue, 25 Oct 2016 03:00:00 GMT</pubDate>

<content:encoded><![CDATA[<p>Data Visualization is an important concept in nowadays applications and line charts are often chosen as representation. This is no coincidence: studies show that position is the most efficient way for humans to perceive differences in data. The following image is a slide extracted from the <a href="https://www.coursera.org/learn/datavisualization" rel="noopener noreferrer" target="_blank">amazing Data Visualization course offered by Coursera</a>.</p>
<figure class="image"><img alt="Data visualization" loading="lazy" decoding="async" width="625" height="357" src="https://rafaelquintanilha.com/_astro/slide.DrZWMR7q_ZFUW5u.webp"><figcaption>Data visualization</figcaption></figure>
<p>The above slide ranks (from top to bottom) which kind of representation is best applied given the type of data (Quantitative, Ordinal, or Nominal). An easy takeaway is that you can’t go wrong with Position, which turns out to be exactly what we measure with Line Charts.</p>
<p>The thing is, knowing or not the theory behind Data Visualization, line charts are ubiquitous and an important abstraction for any developer. That said, I always felt frustrated about the many libraries out there to implement this simple visualization. Many would lack basic features (such as adding multi lines or changing line colors) or would be extremely low-level (think d3).</p>
<p>Of course, wouldn’t be fair to state that every library that implements this is bad. In the React realm, I am particularly fond of <a href="https://github.com/uber/react-vis" rel="noopener noreferrer" target="_blank">Uber’s React Vis</a>. Again I would fail to tweak it (maybe because of my own inability).</p>
<p>I have been working with React for a long time, so I knew I would have to solve this problem often. Then I went the natural path and tried to make my own, simple yet highly customizable, library: <strong>React LineChart</strong> – and that’s what we gonna learn today.</p>
<p>In order to learn how to use this tool and to explain some of the design decisions I made, let’s build an app from scratch. Enough of talking, let’s get into it!</p>
<h2 id="getting-started">Getting Started</h2>
<p>We gonna take advantage of the <a href="https://reactjs.org/blog/2016/07/22/create-apps-with-no-configuration.html" rel="noopener noreferrer" target="_blank">awesome Create React App</a> command. If you don’t know it, it’s time to visit the link and give it a head’s up. In any case, there isn’t much to learn: all you need to do is run the following commands:</p>
<figure class="code"><figcaption>bash</figcaption><pre class="astro-code linha" style="background-color:#1b1814;color:#ecebe8; overflow-x: auto;" tabindex="0" data-language="bash"><code><span class="line"><span style="color:#EDCC95">npm</span><span style="color:#97CCAE"> install</span><span style="color:#97CCAE"> -g</span><span style="color:#97CCAE"> create-react-app</span></span>
<span class="line"><span style="color:#EDCC95">create-react-app</span><span style="color:#97CCAE"> linechart-example</span></span></code></pre></figure>
<p>It is pleasantly easy – forget about minding Babel, Webpack, or CDN scripts. You can test the boilerplate app React right away:</p>
<figure class="code"><figcaption>bash</figcaption><pre class="astro-code linha" style="background-color:#1b1814;color:#ecebe8; overflow-x: auto;" tabindex="0" data-language="bash"><code><span class="line"><span style="color:#EDCC95">cd</span><span style="color:#97CCAE"> linechart-example</span></span>
<span class="line"><span style="color:#EDCC95">npm</span><span style="color:#97CCAE"> start</span></span></code></pre></figure>
<p>You can now check the few dependencies CRA has introduced for you by looking at <em>package.json</em>. Not many really. Once we are already talking about that, time to install the lib:</p>
<figure class="code"><figcaption>bash</figcaption><pre class="astro-code linha" style="background-color:#1b1814;color:#ecebe8; overflow-x: auto;" tabindex="0" data-language="bash"><code><span class="line"><span style="color:#EDCC95">npm</span><span style="color:#97CCAE"> install</span><span style="color:#97CCAE"> --save</span><span style="color:#97CCAE"> react-linechart</span></span></code></pre></figure>
<p>This will pull the latest version published on NPM. <a href="https://www.npmjs.com/package/react-linechart" rel="noopener noreferrer" target="_blank">You can check it online</a>. A note of caution: this was my first ever NPM package, so I cannot say to have avoided possible mistakes during the course of creating the library (versioning is weird too, I know).</p>
<p>Great! You have all the tooling ready to start (it’s beautiful how easy this section has become…)</p>
<h2 id="the-basics">The Basics</h2>
<p>You can now navigate to <em>src/App.js</em> and get rid of everything in there. Replace it with:</p>
<figure class="code"><figcaption>jsx</figcaption><pre class="astro-code linha" style="background-color:#1b1814;color:#ecebe8; overflow-x: auto;" tabindex="0" data-language="jsx"><code><span class="line"><span style="color:#A1C1E4">import</span><span style="color:#ECEBE8"> React, { Component } </span><span style="color:#A1C1E4">from</span><span style="color:#97CCAE"> 'react'</span><span style="color:#ECEBE8">;</span></span>
<span class="line"><span style="color:#A1C1E4">import</span><span style="color:#ECEBE8"> LineChart </span><span style="color:#A1C1E4">from</span><span style="color:#97CCAE"> 'react-linechart'</span><span style="color:#ECEBE8">;</span></span>
<span class="line"><span style="color:#A1C1E4">import</span><span style="color:#97CCAE"> '../node_modules/react-linechart/dist/styles.css'</span><span style="color:#ECEBE8">;</span></span>
<span class="line"></span>
<span class="line"><span style="color:#A1C1E4">export</span><span style="color:#A1C1E4"> default</span><span style="color:#A1C1E4"> class</span><span style="color:#EDCC95"> App</span><span style="color:#A1C1E4"> extends</span><span style="color:#ECEBE8"> Component {</span></span>
<span class="line"><span style="color:#EDCC95">	render</span><span style="color:#ECEBE8">() {</span></span>
<span class="line"><span style="color:#A1C1E4">		const</span><span style="color:#ECEBE8"> data </span><span style="color:#A1C1E4">=</span><span style="color:#ECEBE8"> [</span></span>
<span class="line"><span style="color:#ECEBE8">			{									</span></span>
<span class="line"><span style="color:#ECEBE8">				color: </span><span style="color:#97CCAE">"steelblue"</span><span style="color:#ECEBE8">, </span></span>
<span class="line"><span style="color:#ECEBE8">				points: [{x: </span><span style="color:#97CCAE">1</span><span style="color:#ECEBE8">, y: </span><span style="color:#97CCAE">2</span><span style="color:#ECEBE8">}, {x: </span><span style="color:#97CCAE">3</span><span style="color:#ECEBE8">, y: </span><span style="color:#97CCAE">5</span><span style="color:#ECEBE8">}, {x: </span><span style="color:#97CCAE">7</span><span style="color:#ECEBE8">, y: </span><span style="color:#A1C1E4">-</span><span style="color:#97CCAE">3</span><span style="color:#ECEBE8">}] </span></span>
<span class="line"><span style="color:#ECEBE8">			}</span></span>
<span class="line"><span style="color:#ECEBE8">		];</span></span>
<span class="line"><span style="color:#A1C1E4">		return</span><span style="color:#ECEBE8"> (</span></span>
<span class="line"><span style="color:#ECEBE8">			&#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">				&#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"App"</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">					&#x3C;</span><span style="color:#A1C1E4">h1</span><span style="color:#ECEBE8">>My First LineChart&#x3C;/</span><span style="color:#A1C1E4">h1</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">					&#x3C;</span><span style="color:#A1C1E4">LineChart</span><span style="color:#ECEBE8"> </span></span>
<span class="line"><span style="color:#EDCC95">						width</span><span style="color:#A1C1E4">=</span><span style="color:#ECEBE8">{</span><span style="color:#97CCAE">600</span><span style="color:#ECEBE8">}</span></span>
<span class="line"><span style="color:#EDCC95">						height</span><span style="color:#A1C1E4">=</span><span style="color:#ECEBE8">{</span><span style="color:#97CCAE">400</span><span style="color:#ECEBE8">}</span></span>
<span class="line"><span style="color:#EDCC95">						data</span><span style="color:#A1C1E4">=</span><span style="color:#ECEBE8">{data}</span></span>
<span class="line"><span style="color:#ECEBE8">					/></span></span>
<span class="line"><span style="color:#ECEBE8">				&#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">>				</span></span>
<span class="line"><span style="color:#ECEBE8">			&#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">		);</span></span>
<span class="line"><span style="color:#ECEBE8">	}</span></span>
<span class="line"><span style="color:#ECEBE8">}</span></span></code></pre></figure>
<p>Save it and done – you have a nice chart just hanging on your screen!</p>
<p>Now it’s time for some explanation. First thing, the only mandatory prop is data (the complete list of properties <a href="https://github.com/rafaelquintanilha/react-linechart#properties-table" rel="noopener noreferrer" target="_blank">can be found on GitHub</a>) and it is an array of objects that describes lines. Each line must have at least a property called <em>points</em> – which is also an array of objects, this time <em>{ x, y }</em> coordinates. You can style your line by adding additional parameters, such as <em>color</em> and <em>name</em>.</p>
<p>This structure has advantages and disadvantages (really?). It’s nice because it’s declarative, so no problems in adding another line with different properties (go on and add a new object with different coordinates to the chart). But also has the disadvantage of being opinionated and likely to be different from formats of data you might encounter out there.</p>
<p>With that in mind, I exposed different parsers to fit the data in this structure. It is common to find data in a “flat” JSON format, where we may want to plot properties against others. So consider the following snippet:</p>
<figure class="code"><figcaption>jsx</figcaption><pre class="astro-code linha" style="background-color:#1b1814;color:#ecebe8; overflow-x: auto;" tabindex="0" data-language="jsx"><code><span class="line"><span style="color:#A1C1E4">import</span><span style="color:#ECEBE8"> React, { Component } </span><span style="color:#A1C1E4">from</span><span style="color:#97CCAE"> 'react'</span><span style="color:#ECEBE8">;</span></span>
<span class="line"><span style="color:#A1C1E4">import</span><span style="color:#ECEBE8"> LineChart, { parseFlatArray } </span><span style="color:#A1C1E4">from</span><span style="color:#97CCAE"> 'react-linechart'</span><span style="color:#ECEBE8">;</span></span>
<span class="line"><span style="color:#A1C1E4">import</span><span style="color:#97CCAE"> '../node_modules/react-linechart/dist/styles.css'</span><span style="color:#ECEBE8">;</span></span>
<span class="line"></span>
<span class="line"><span style="color:#A1C1E4">export</span><span style="color:#A1C1E4"> default</span><span style="color:#A1C1E4"> class</span><span style="color:#EDCC95"> App</span><span style="color:#A1C1E4"> extends</span><span style="color:#ECEBE8"> Component {</span></span>
<span class="line"><span style="color:#EDCC95">	render</span><span style="color:#ECEBE8">() {</span></span>
<span class="line"><span style="color:#A1C1E4">		const</span><span style="color:#ECEBE8"> gsmData </span><span style="color:#A1C1E4">=</span><span style="color:#ECEBE8"> [</span></span>
<span class="line"><span style="color:#ECEBE8">			{</span></span>
<span class="line"><span style="color:#97CCAE">				"Year"</span><span style="color:#ECEBE8">: </span><span style="color:#97CCAE">1880</span><span style="color:#ECEBE8">,</span></span>
<span class="line"><span style="color:#97CCAE">				"Glob"</span><span style="color:#ECEBE8">: </span><span style="color:#A1C1E4">-</span><span style="color:#97CCAE">19</span><span style="color:#ECEBE8">,</span></span>
<span class="line"><span style="color:#97CCAE">				"NHem"</span><span style="color:#ECEBE8">: </span><span style="color:#A1C1E4">-</span><span style="color:#97CCAE">33</span><span style="color:#ECEBE8">,</span></span>
<span class="line"><span style="color:#97CCAE">				"SHem"</span><span style="color:#ECEBE8">: </span><span style="color:#A1C1E4">-</span><span style="color:#97CCAE">5</span></span>
<span class="line"><span style="color:#ECEBE8">			},</span></span>
<span class="line"><span style="color:#ECEBE8">			{</span></span>
<span class="line"><span style="color:#97CCAE">				"Year"</span><span style="color:#ECEBE8">: </span><span style="color:#97CCAE">1881</span><span style="color:#ECEBE8">,</span></span>
<span class="line"><span style="color:#97CCAE">				"Glob"</span><span style="color:#ECEBE8">: </span><span style="color:#A1C1E4">-</span><span style="color:#97CCAE">10</span><span style="color:#ECEBE8">,</span></span>
<span class="line"><span style="color:#97CCAE">				"NHem"</span><span style="color:#ECEBE8">: </span><span style="color:#A1C1E4">-</span><span style="color:#97CCAE">18</span><span style="color:#ECEBE8">,</span></span>
<span class="line"><span style="color:#97CCAE">				"SHem"</span><span style="color:#ECEBE8">: </span><span style="color:#A1C1E4">-</span><span style="color:#97CCAE">2</span></span>
<span class="line"><span style="color:#ECEBE8">			},</span></span>
<span class="line"><span style="color:#ECEBE8">			{</span></span>
<span class="line"><span style="color:#97CCAE">				"Year"</span><span style="color:#ECEBE8">: </span><span style="color:#97CCAE">1882</span><span style="color:#ECEBE8">,</span></span>
<span class="line"><span style="color:#97CCAE">				"Glob"</span><span style="color:#ECEBE8">: </span><span style="color:#A1C1E4">-</span><span style="color:#97CCAE">15</span><span style="color:#ECEBE8">,</span></span>
<span class="line"><span style="color:#97CCAE">				"NHem"</span><span style="color:#ECEBE8">: </span><span style="color:#A1C1E4">-</span><span style="color:#97CCAE">12</span><span style="color:#ECEBE8">,</span></span>
<span class="line"><span style="color:#97CCAE">				"SHem"</span><span style="color:#ECEBE8">: </span><span style="color:#A1C1E4">-</span><span style="color:#97CCAE">4</span></span>
<span class="line"><span style="color:#ECEBE8">			}</span></span>
<span class="line"><span style="color:#ECEBE8">		];</span></span>
<span class="line"><span style="color:#A1C1E4">		const</span><span style="color:#ECEBE8"> gsmFlat </span><span style="color:#A1C1E4">=</span><span style="color:#EDCC95"> parseFlatArray</span><span style="color:#ECEBE8">(gsmData, </span><span style="color:#97CCAE">"Year"</span><span style="color:#ECEBE8">, [</span><span style="color:#97CCAE">"Glob"</span><span style="color:#ECEBE8">, </span><span style="color:#97CCAE">"NHem"</span><span style="color:#ECEBE8">, </span><span style="color:#97CCAE">"SHem"</span><span style="color:#ECEBE8">]);</span></span>
<span class="line"><span style="color:#A1C1E4">		return</span><span style="color:#ECEBE8"> (</span></span>
<span class="line"><span style="color:#ECEBE8">			&#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">				&#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"App"</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">					&#x3C;</span><span style="color:#A1C1E4">h1</span><span style="color:#ECEBE8">>My first LineChart&#x3C;/</span><span style="color:#A1C1E4">h1</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">					&#x3C;</span><span style="color:#A1C1E4">LineChart</span><span style="color:#ECEBE8"> 						</span></span>
<span class="line"><span style="color:#EDCC95">						width</span><span style="color:#A1C1E4">=</span><span style="color:#ECEBE8">{</span><span style="color:#97CCAE">600</span><span style="color:#ECEBE8">} </span></span>
<span class="line"><span style="color:#EDCC95">						height</span><span style="color:#A1C1E4">=</span><span style="color:#ECEBE8">{</span><span style="color:#97CCAE">400</span><span style="color:#ECEBE8">}</span></span>
<span class="line"><span style="color:#EDCC95">						data</span><span style="color:#A1C1E4">=</span><span style="color:#ECEBE8">{gsmFlat}</span></span>
<span class="line"><span style="color:#ECEBE8">					/></span></span>
<span class="line"><span style="color:#ECEBE8">				&#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">>				</span></span>
<span class="line"><span style="color:#ECEBE8">			&#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">		);</span></span>
<span class="line"><span style="color:#ECEBE8">	}</span></span>
<span class="line"><span style="color:#ECEBE8">}</span></span></code></pre></figure>
<p>We are taking a slice of a dataset and feeding it into the <code>parseFlatArray</code> function. It will take one dimension for the X-axis and an array of dimensions for the Y-axis (thus yielding a multi-line chart).</p>
<p>With this basic functionality, we are able to draw multi-line charts pretty easily. Don’t forget to follow the <a href="https://github.com/rafaelquintanilha/react-linechart#parsers" rel="noopener noreferrer" target="_blank">official documentation</a> to know every option you can take.</p>
<h2 id="adding-legends">Adding Legends</h2>
<p>Now that we have this chart it is time to customize it better. Notice there are three lines and we are unable to distinguish them. Would be nice to add a legend to help the viewer understand, huh? With React LineChart this is pretty easy – just add the <code>showLegends</code> prop to the component. Isn’t that great?</p>
<p>There are still changes to be made. Our chart is just over the legend. Fortunately a <code>legendPosition</code> prop is available with 6 different spots: top-right, top-center, top-left, bottom-right, bottom-center, and bottom-left.</p>
<p>Change the component to:</p>
<figure class="code"><figcaption>jsx</figcaption><pre class="astro-code linha" style="background-color:#1b1814;color:#ecebe8; overflow-x: auto;" tabindex="0" data-language="jsx"><code><span class="line"><span style="color:#A1C1E4">...</span></span>
<span class="line"><span style="color:#ECEBE8">&#x3C;</span><span style="color:#A1C1E4">LineChart</span><span style="color:#ECEBE8"> 						</span></span>
<span class="line"><span style="color:#EDCC95">	width</span><span style="color:#A1C1E4">=</span><span style="color:#ECEBE8">{</span><span style="color:#97CCAE">600</span><span style="color:#ECEBE8">} </span></span>
<span class="line"><span style="color:#EDCC95">	height</span><span style="color:#A1C1E4">=</span><span style="color:#ECEBE8">{</span><span style="color:#97CCAE">400</span><span style="color:#ECEBE8">}</span></span>
<span class="line"><span style="color:#EDCC95">	showLegends</span></span>
<span class="line"><span style="color:#EDCC95">	legendPosition</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"bottom-right"</span></span>
<span class="line"><span style="color:#EDCC95">	data</span><span style="color:#A1C1E4">=</span><span style="color:#ECEBE8">{gsmFlat}</span></span>
<span class="line"><span style="color:#ECEBE8">/></span></span>
<span class="line"><span style="color:#A1C1E4">...</span></span></code></pre></figure>
<p>And check how easy is to place it somewhere it won’t bother the visualization. Again, follow the documentation to see how to change colors and names for each line.</p>
<h2 id="adding-tooltips">Adding Tooltips</h2>
<p>Tooltips are an important part of a line chart – they can provide additional information about a specific point. In order to make it easy, React LineChart comes with a default style for your tooltip and all you have to do is pass around the value you want to render.</p>
<p>Let’s go ahead and add a new prop called <code>onPointHover</code>. As you might imagine it will be called when the user hovers on any point. This function receives an object ({x, y} pair) and returns some string inside the tooltip (can be an HTML too). Test this by adding the new prop:</p>
<figure class="code"><figcaption>jsx</figcaption><pre class="astro-code linha" style="background-color:#1b1814;color:#ecebe8; overflow-x: auto;" tabindex="0" data-language="jsx"><code><span class="line"><span style="color:#A1C1E4">...</span></span>
<span class="line"><span style="color:#ECEBE8">onPointHover</span><span style="color:#A1C1E4">=</span><span style="color:#ECEBE8">{(obj) => </span><span style="color:#97CCAE">`x: ${</span><span style="color:#97CCAE">obj.x</span><span style="color:#97CCAE">}&#x3C;br />y: ${</span><span style="color:#97CCAE">obj.y</span><span style="color:#97CCAE">}`</span><span style="color:#ECEBE8">}</span></span>
<span class="line"><span style="color:#A1C1E4">...</span></span></code></pre></figure>
<p>And it works! Now, while this is nice I admit the styling could be better (never got along with CSS to be fair). So I recommend you have a look at <em>styles.css</em> and search for <code>svg-line-chart-tooltip</code> to use as inspiration to create your own class and pass it as a prop called <code>tooltipClass</code>. Goes without saying that the class should be available in the file you are importing the LineChart component. In fact, don’t take any of my classes for granted – you can pass <code>labelClass</code> and <code>pointClass</code> as props as well.</p>
<h2 id="using-dates">Using Dates</h2>
<p>Numeric charts are great, right, but it’s also common to plot values against time. Turns out a date can be written as a timestamp, which ultimately is… a numeric value. With that in mind, I created a special boolean <code>isDate</code> which will take your date input and plot right away!</p>
<p>Ok, not so fast. First you need to say how your date is structured and then how you want to present it. The library defaults to YYYY-MM-DD as input and %b %d as output (if you are not comfortable with this notation, <a href="https://github.com/d3/d3-3.x-api-reference/blob/master/Time-Formatting.md" rel="noopener noreferrer" target="_blank">check the d3 time.format reference</a>). Warning: you are responsible for the consistency of your data: if you flag it as <code>isDate</code> but passes a numeric value, the lib will crash (as of today, not so gracious I admit).</p>
<p>After you have checked that this actually works, here is how this works: you can specify two functions, <code>xParser</code> and <code>xDisplay</code>, as properties of the component. The first should take whatever data format you have specified as x dimension and parse it in a numeric value. The latter will then receive this parsed value and display in the format best suits your visualization. Again, mind the consistency between your data and how you want to play with it.</p>
<h2 id="final-thoughts">Final Thoughts</h2>
<p>I am aware the lib is still lacking features, tests, and error handling. I hope you can help me improve it by <a href="https://github.com/rafaelquintanilha/react-linechart" rel="noopener noreferrer" target="_blank">contributing to the repo in GitHub</a>. Nonetheless, I can say this tool has saved me a lot of time when displaying dynamic data in my projects. Don’t forget this is an experimental and really early release, so expect things to break (fork your own version if you want).</p>
<p>Join me in discussing better design principles and happy visualizations!</p>]]></content:encoded>
</item>
<item>
<title><![CDATA[Real-Time Charts with Meteor, React and D3]]></title>
<description><![CDATA[Because we already have PNG for static graphs.]]></description>
<link>https://rafaelquintanilha.com/real-time-charts-with-meteor-react-and-d3-2/</link>
<guid isPermaLink="false">63701f6942a473003d9dc746</guid>
<category><![CDATA[React]]></category><category><![CDATA[MeteorJS]]></category><category><![CDATA[Data Visualization]]></category>
<dc:creator><![CDATA[Rafael Quintanilha]]></dc:creator>
<pubDate>Thu, 13 Aug 2015 03:00:00 GMT</pubDate>

<content:encoded><![CDATA[<p>Meteor has recently <a href="https://blog.meteor.com/meteor-the-missing-infrastructure-for-building-great-react-apps-b770ef788fd6" rel="noopener noreferrer" target="_blank">announced official support for React</a> as its rendering engine (together with Blaze). This is great news, once React is becoming more and more popular and brings improvements in many aspects of your code (reusability, unit-testing, no spaghetti code…).</p>
<p>Since the React fever, many tutorials explain how to integrate it with the most popular libraries outside. The perspective of a reactive chart using React components and <a href="https://d3js.org/" rel="noopener noreferrer" target="_blank">D3.js</a> is pretty exciting and in fact, there are many guides out there exploring this subject. <a href="http://nicolashery.com/integrating-d3js-visualizations-in-a-react-app/" rel="noopener noreferrer" target="_blank">This one correlates D3 and React lifecycles</a> and <a href="http://busypeoples.github.io/post/d3-with-react-js/" rel="noopener noreferrer" target="_blank">this other explores SVG components</a>.</p>
<p>The aim of this tutorial is to take a step further and show how to build reactive charts with React and D3, but using the Meteor ecosystem.</p>
<p>If you are not familiar at all with <a href="https://reactjs.org/" rel="noopener noreferrer" target="_blank">React</a> and <a href="https://d3js.org/" rel="noopener noreferrer" target="_blank">D3</a> I suggest you take a break and read about them before continuing.</p>
<p>In order to make things nicer, we will develop a fully-functional web application that will keep track of how many beers you drink on each day of the week. More than detecting if you are an alcoholic, the aim of this app is to show how we can take advantage of React power to build reactive components that comprise D3 elements and receive data from Meteor.</p>
<p>You might want to follow the code in <a href="https://github.com/rafaelquintanilha/meteor-react-d3" rel="noopener noreferrer" target="_blank">GitHub</a>. Time to start!</p>
<h2 id="designing-the-app">Designing the App</h2>
<p>As React is component-based this step is important and may save you a lot of time in the future. The plan is to have two columns:</p>
<ul>
<li>The leftmost will have a form to insert data and a list of all data previously inserted when one will be able to remove it by clicking.</li>
<li>The rightmost will render a bar chart.</li>
</ul>
<p>Let’s breakdown our app into components:</p>
<figure class="image"><img alt="Dashboard preview" loading="lazy" decoding="async" width="1024" height="582" src="https://rafaelquintanilha.com/_astro/preview.DCY0wtKG_Z1KLTXC.webp"><figcaption>Dashboard preview</figcaption></figure>
<p>The <code>App</code> component encompasses all components and will be responsible for gathering data from MongoDB and passing it accordingly.</p>
<p>The black rectangle is the <code>BeerForm</code> component. It’s a basic form where we will add the number of beers and the day that event happened.</p>
<p>The red rectangle is the <code>BeerList</code> component, which encapsulates the data and renders a BeerItem component (in pink), formatting the data nicely and allowing us to click in any record to delete it.</p>
<p>Finally, the blue rectangle is our star – the <code>BarChart</code> component. It will receive data from Meteor and render this nice bar chart. This component was designed to be reusable, so the only thing you will need to do is to pass the correspondent data and it will be able to render the chart (with a horizontal label and a top label informing quantity).</p>
<p>Now time to dig into some code!</p>
<h2 id="setting-up-the-environment">Setting up the environment</h2>
<p>This is the default step. In your console, type:</p>
<figure class="code"><pre class="astro-code linha" style="background-color:#1b1814;color:#ecebe8; overflow-x: auto;" tabindex="0" data-language="plaintext"><code><span class="line"><span>$ meteor create beer-dashboard</span></span>
<span class="line"><span>$ cd beer-dashboard</span></span></code></pre></figure>
<p>You will note that three files were automatically generated. Get rid of them. Time for adding packages:</p>
<figure class="code"><pre class="astro-code linha" style="background-color:#1b1814;color:#ecebe8; overflow-x: auto;" tabindex="0" data-language="plaintext"><code><span class="line"><span>$ meteor add react</span></span>
<span class="line"><span>$ meteor add d3js:d3</span></span>
<span class="line"><span>$ meteor add momentjs:moment</span></span>
<span class="line"><span>$ meteor add twbs:bootstrap</span></span>
<span class="line"><span>$ meteor add fortawesome:fontawesome</span></span></code></pre></figure>
<p>The first is the official react package bundled by the Meteor Development Group. The second is <a href="https://atmospherejs.com/d3js/d3" rel="noopener noreferrer" target="_blank">the official D3.js package for Meteor</a>. We are doing some date manipulation, so <a href="http://momentjs.com/" rel="noopener noreferrer" target="_blank">MomentJS</a> is a good choice. Fourth and fifth are Bootstrap and FontAwesome, just for styling purposes.</p>
<h2 id="defining-the-collection">Defining the Collection</h2>
<p>Let’s begin defining the only server-side piece of our app (although it is also client-side in order to achieve <a href="https://blog.meteor.com/optimistic-ui-with-meteor-67b5a78c3fcf" rel="noopener noreferrer" target="_blank">latency compensation</a>). In the top-level directory of your app, create a <strong>collections.js</strong> file and add the following:</p>
<figure class="code"><figcaption>js</figcaption><pre class="astro-code linha" style="background-color:#1b1814;color:#ecebe8; overflow-x: auto;" tabindex="0" data-language="js"><code><span class="line"><span style="color:#ECEBE8">Beers </span><span style="color:#A1C1E4">=</span><span style="color:#A1C1E4"> new</span><span style="color:#EDCC95"> Meteor.Collection</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"Beers"</span><span style="color:#ECEBE8">);</span></span>
<span class="line"></span>
<span class="line"><span style="color:#EDCC95">Meteor.methods</span><span style="color:#ECEBE8">({</span></span>
<span class="line"><span style="color:#97CCAE">	"insertBeer"</span><span style="color:#ECEBE8">: </span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">(numBeers, date) {</span></span>
<span class="line"><span style="color:#ECEBE8">		numBeers </span><span style="color:#A1C1E4">=</span><span style="color:#EDCC95"> parseInt</span><span style="color:#ECEBE8">(numBeers);		</span></span>
<span class="line"></span>
<span class="line"><span style="color:#EDCC95">		check</span><span style="color:#ECEBE8">(numBeers, Number);</span></span>
<span class="line"><span style="color:#EDCC95">		check</span><span style="color:#ECEBE8">(date, Date);</span></span>
<span class="line"></span>
<span class="line"><span style="color:#A1C1E4">		return</span><span style="color:#EDCC95"> Beers.insert</span><span style="color:#ECEBE8">({beers: numBeers, date: date});</span></span>
<span class="line"><span style="color:#ECEBE8">	},</span></span>
<span class="line"></span>
<span class="line"><span style="color:#97CCAE">	"removeBeer"</span><span style="color:#ECEBE8">: </span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">(id) {		</span></span>
<span class="line"><span style="color:#EDCC95">		check</span><span style="color:#ECEBE8">(id, String);		</span></span>
<span class="line"><span style="color:#A1C1E4">		return</span><span style="color:#EDCC95"> Beers.remove</span><span style="color:#ECEBE8">(id);</span></span>
<span class="line"><span style="color:#ECEBE8">	}</span></span>
<span class="line"><span style="color:#ECEBE8">})</span></span></code></pre></figure>
<p>We are defining our collection (Beers) and two methods which will be called in our components. Here, <code>insertBeers</code> takes the number of beers and the date, checks for inconsistencies and saves it into the DB. On the other hand, <code>removeBeer</code> takes an id and removes the entry.</p>
<h2 id="beerform-component">BeerForm Component</h2>
<p>This is the top panel of the left-side column and should be straightforward. Create a <em>client/</em> folder and <strong>beerform.jsx</strong> inside it. Then add the code:</p>
<figure class="code"><figcaption>js</figcaption><pre class="astro-code linha" style="background-color:#1b1814;color:#ecebe8; overflow-x: auto;" tabindex="0" data-language="js"><code><span class="line"><span style="color:#ECEBE8">BeerForm </span><span style="color:#A1C1E4">=</span><span style="color:#EDCC95"> React.createClass</span><span style="color:#ECEBE8">({</span></span>
<span class="line"><span style="color:#EDCC95">	handleSubmit</span><span style="color:#ECEBE8">: </span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">(e) {</span></span>
<span class="line"><span style="color:#EDCC95">		e.preventDefault</span><span style="color:#ECEBE8">();</span></span>
<span class="line"><span style="color:#A1C1E4">		var</span><span style="color:#ECEBE8"> numBeers </span><span style="color:#A1C1E4">=</span><span style="color:#EDCC95"> React.findDOMNode</span><span style="color:#ECEBE8">(</span><span style="color:#A1C1E4">this</span><span style="color:#ECEBE8">.refs.numBeers);</span></span>
<span class="line"><span style="color:#A1C1E4">		var</span><span style="color:#ECEBE8"> beerDate </span><span style="color:#A1C1E4">=</span><span style="color:#EDCC95"> React.findDOMNode</span><span style="color:#ECEBE8">(</span><span style="color:#A1C1E4">this</span><span style="color:#ECEBE8">.refs.beerDate);</span></span>
<span class="line"><span style="color:#ECEBE8">		</span></span>
<span class="line"><span style="color:#EDCC95">		Meteor.call</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"insertBeer"</span><span style="color:#ECEBE8">, numBeers.value, </span><span style="color:#EDCC95">moment</span><span style="color:#ECEBE8">(beerDate.value)</span><span style="color:#EDCC95">.toDate</span><span style="color:#ECEBE8">(), </span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">(e, r) {</span></span>
<span class="line"><span style="color:#A1C1E4">			if</span><span style="color:#ECEBE8"> (e) </span><span style="color:#EDCC95">alert</span><span style="color:#ECEBE8">(e.reason)			</span></span>
<span class="line"><span style="color:#ECEBE8">		});</span></span>
<span class="line"></span>
<span class="line"><span style="color:#ECEBE8">		numBeers.value </span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE"> ""</span><span style="color:#ECEBE8">;</span></span>
<span class="line"><span style="color:#ECEBE8">		beerDate.value </span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE"> ""</span><span style="color:#ECEBE8">;</span></span>
<span class="line"><span style="color:#ECEBE8">	},</span></span>
<span class="line"></span>
<span class="line"><span style="color:#EDCC95">	render</span><span style="color:#ECEBE8">: </span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">() {		</span></span>
<span class="line"><span style="color:#A1C1E4">		return</span><span style="color:#ECEBE8"> (</span></span>
<span class="line"><span style="color:#ECEBE8">			&#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"panel panel-default"</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">			  &#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"panel-heading"</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">			    &#x3C;</span><span style="color:#A1C1E4">h3</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"panel-title"</span><span style="color:#ECEBE8">>Beer Consumption&#x3C;/</span><span style="color:#A1C1E4">h3</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">			  &#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">			  &#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"panel-body"</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">			    &#x3C;</span><span style="color:#A1C1E4">form</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"form-horizontal"</span><span style="color:#EDCC95"> onSubmit</span><span style="color:#A1C1E4">=</span><span style="color:#ECEBE8">{</span><span style="color:#A1C1E4">this</span><span style="color:#ECEBE8">.handleSubmit}></span></span>
<span class="line"><span style="color:#ECEBE8">				  &#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"form-group"</span><span style="color:#ECEBE8">>				    </span></span>
<span class="line"><span style="color:#ECEBE8">				    &#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"col-sm-10"</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">				      &#x3C;</span><span style="color:#A1C1E4">input</span><span style="color:#EDCC95"> type</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"number"</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"form-control"</span><span style="color:#ECEBE8"> </span></span>
<span class="line"><span style="color:#EDCC95">				      		placeholder</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"How many beers?"</span><span style="color:#EDCC95"> ref</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"numBeers"</span><span style="color:#ECEBE8"> /></span></span>
<span class="line"><span style="color:#ECEBE8">				    &#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">				  &#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">				  &#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"form-group"</span><span style="color:#ECEBE8">>				    </span></span>
<span class="line"><span style="color:#ECEBE8">				    &#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"col-sm-10"</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">				      &#x3C;</span><span style="color:#A1C1E4">input</span><span style="color:#EDCC95"> type</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"date"</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"form-control"</span><span style="color:#EDCC95"> ref</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"beerDate"</span><span style="color:#ECEBE8">/></span></span>
<span class="line"><span style="color:#ECEBE8">				    &#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">				  &#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">				  </span></span>
<span class="line"><span style="color:#ECEBE8">				  &#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"form-group"</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">				    &#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"col-sm-10"</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">				      &#x3C;</span><span style="color:#A1C1E4">button</span><span style="color:#EDCC95"> type</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"submit"</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"btn btn-primary btn-block"</span><span style="color:#ECEBE8">>Add&#x3C;/</span><span style="color:#A1C1E4">button</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">				    &#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">				  &#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">				&#x3C;/</span><span style="color:#A1C1E4">form</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">			  &#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">			&#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">		);</span></span>
<span class="line"><span style="color:#ECEBE8">	}</span></span>
<span class="line"><span style="color:#ECEBE8">})</span></span></code></pre></figure>
<p>If you are familiar with React, there’s no news in there. For those that are not so much, let me explain a little bit.</p>
<p><code>React.createClass()</code> is where you create your components. The only mandatory function every component must have is the render function, the place you will actually render something into the DOM.</p>
<p>Lines 17-42 are just Bootstrap markups. Two important points:</p>
<p>When writing JSX files (which React will take care of translating to pure JavaScript for you) you write className instead of class.</p>
<p>Line 22 handles the submission calling <code>handleSubmit</code> defined previously.</p>
<p>From lines 2-13, our custom function <code>handleSubmit</code> will take care of any event it was attached to (in this case, <code>onSubmit</code> as you can guess). Notes on this code:</p>
<p>Line 3 prevents the form to be actually sent.</p>
<p>Lines 4-5 get the DOM nodes of the fields through the ref attribute, passing in Lines 7-9 their correspondent value to the Meteor method we defined before. Note this call is asynchronous.</p>
<p>Lines 11-12 we just clean the form up.</p>
<p>Great! Our first component is done and we are able to insert data into our collection. Go to your browser console and type <code>Beers.find().fetch()</code> to see if it’s working. The only missing point is we haven’t defined where <code>BeerForm</code> will be rendered.</p>
<h2 id="meteor-powered-react">Meteor-powered React</h2>
<p>It’s time for starting sketching our <code>App</code> component – which will render all components together. But before that we need to render the component, so create the files <strong>client/index.html</strong> and <strong>client/init.jsx</strong> and put the following:</p>
<figure class="code"><figcaption>html</figcaption><pre class="astro-code linha" style="background-color:#1b1814;color:#ecebe8; overflow-x: auto;" tabindex="0" data-language="html"><code><span class="line"><span style="color:#ECEBE8">&#x3C;</span><span style="color:#A1C1E4">head</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">  &#x3C;</span><span style="color:#A1C1E4">title</span><span style="color:#ECEBE8">>React + d3 + Meteor&#x3C;/</span><span style="color:#A1C1E4">title</span><span style="color:#ECEBE8">>  </span></span>
<span class="line"><span style="color:#ECEBE8">&#x3C;/</span><span style="color:#A1C1E4">head</span><span style="color:#ECEBE8">></span></span>
<span class="line"></span>
<span class="line"><span style="color:#ECEBE8">&#x3C;</span><span style="color:#A1C1E4">body</span><span style="color:#ECEBE8">>&#x3C;/</span><span style="color:#A1C1E4">body</span><span style="color:#ECEBE8">></span></span></code></pre></figure>
<figure class="code"><figcaption>jsx</figcaption><pre class="astro-code linha" style="background-color:#1b1814;color:#ecebe8; overflow-x: auto;" tabindex="0" data-language="jsx"><code><span class="line"><span style="color:#EDCC95">Meteor.startup</span><span style="color:#ECEBE8">(</span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">() {</span></span>
<span class="line"><span style="color:#EDCC95">	React.render</span><span style="color:#ECEBE8">(&#x3C;</span><span style="color:#A1C1E4">App</span><span style="color:#ECEBE8"> />,  document.body);	</span></span>
<span class="line"><span style="color:#ECEBE8">});</span></span></code></pre></figure>
<p>Here we are instructing React to render the <code>App</code> component into <code>document.body</code> when the client starts.</p>
<p>Now create <strong>client/app.jsx</strong>:</p>
<figure class="code"><figcaption>jsx</figcaption><pre class="astro-code linha" style="background-color:#1b1814;color:#ecebe8; overflow-x: auto;" tabindex="0" data-language="jsx"><code><span class="line"><span style="color:#ECEBE8">App </span><span style="color:#A1C1E4">=</span><span style="color:#EDCC95"> React.createClass</span><span style="color:#ECEBE8">({</span></span>
<span class="line"><span style="color:#ECEBE8">	mixins: [ReactMeteorData],</span></span>
<span class="line"></span>
<span class="line"><span style="color:#EDCC95">	getMeteorData</span><span style="color:#ECEBE8">() {</span></span>
<span class="line"><span style="color:#A1C1E4">	    return</span><span style="color:#ECEBE8"> {</span></span>
<span class="line"><span style="color:#ECEBE8">	      beers: </span><span style="color:#EDCC95">Beers.find</span><span style="color:#ECEBE8">({})</span><span style="color:#EDCC95">.fetch</span><span style="color:#ECEBE8">()</span></span>
<span class="line"><span style="color:#ECEBE8">	    }</span></span>
<span class="line"><span style="color:#ECEBE8">  	},</span></span>
<span class="line"></span>
<span class="line"><span style="color:#EDCC95">	render</span><span style="color:#ECEBE8">: </span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">() {		</span></span>
<span class="line"><span style="color:#A1C1E4">		return</span><span style="color:#ECEBE8"> (</span></span>
<span class="line"><span style="color:#ECEBE8">		  &#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">		  	&#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"page-header"</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">					&#x3C;</span><span style="color:#A1C1E4">center</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">						&#x3C;</span><span style="color:#A1C1E4">h1</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">						&#x3C;</span><span style="color:#A1C1E4">i</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"fa fa-beer"</span><span style="color:#ECEBE8">>&#x3C;/</span><span style="color:#A1C1E4">i</span><span style="color:#ECEBE8">> Beer </span></span>
<span class="line"><span style="color:#ECEBE8">						&#x3C;</span><span style="color:#A1C1E4">small</span><span style="color:#ECEBE8">> Dashboard&#x3C;/</span><span style="color:#A1C1E4">small</span><span style="color:#ECEBE8">>&#x3C;/</span><span style="color:#A1C1E4">h1</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">					&#x3C;/</span><span style="color:#A1C1E4">center</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">			&#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"></span>
<span class="line"><span style="color:#ECEBE8">			&#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"container"</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">				&#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"row"</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">					&#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"col-md-4"</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">						&#x3C;</span><span style="color:#A1C1E4">BeerForm</span><span style="color:#ECEBE8"> />		</span></span>
<span class="line"><span style="color:#ECEBE8">					&#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"></span>
<span class="line"><span style="color:#ECEBE8">					&#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"col-md-offset-2 col-md-6"</span><span style="color:#ECEBE8">>					</span></span>
<span class="line"><span style="color:#ECEBE8">					&#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">				&#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">			&#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">>        </span></span>
<span class="line"><span style="color:#ECEBE8">		  &#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">		);</span></span>
<span class="line"><span style="color:#ECEBE8">	}</span></span>
<span class="line"><span style="color:#ECEBE8">});</span></span></code></pre></figure>
<p>Try to run your code now to see if everything is working. It should display the <code>BeerForm</code> component and the header. The only tricky thing here is Lines 2-8. There is where Meteor shines and really empowers React.</p>
<p>While in Line 2 you tell React you are going to fetch data from your Meteor database, the function <code>getMeteorData()</code> says you are storing the object beers in <code>this.data</code>. Better still, it’s reactive! You now can pass it via props to children components, so you can add that to your code:</p>
<figure class="code"><figcaption>jsx</figcaption><pre class="astro-code linha" style="background-color:#1b1814;color:#ecebe8; overflow-x: auto;" tabindex="0" data-language="jsx"><code><span class="line"><span style="color:#A1C1E4">...</span></span>
<span class="line"><span style="color:#ECEBE8">&#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"row"</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">  &#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"col-md-4"</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">    &#x3C;</span><span style="color:#A1C1E4">BeerForm</span><span style="color:#ECEBE8"> /></span></span>
<span class="line"><span style="color:#ECEBE8">    &#x3C;</span><span style="color:#A1C1E4">BeerList</span><span style="color:#EDCC95"> data</span><span style="color:#A1C1E4">=</span><span style="color:#ECEBE8">{</span><span style="color:#A1C1E4">this</span><span style="color:#ECEBE8">.data.beers}/></span></span>
<span class="line"><span style="color:#ECEBE8">  &#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">  ...</span></span></code></pre></figure>
<p>The <code>BeerList</code> component is receiving whatever you have in <code>this.data.beers</code>, which in our case is the recently-fetched data from the <code>Beers</code> collection. Everything's nice, let’s move forward.</p>
<h2 id="beerlist-and-beeritem-components">BeerList and BeerItem Components</h2>
<p>In <strong>client/beerlist.jsx</strong>:</p>
<figure class="code"><figcaption>jsx</figcaption><pre class="astro-code linha" style="background-color:#1b1814;color:#ecebe8; overflow-x: auto;" tabindex="0" data-language="jsx"><code><span class="line"><span style="color:#ECEBE8">BeerList </span><span style="color:#A1C1E4">=</span><span style="color:#EDCC95"> React.createClass</span><span style="color:#ECEBE8">({	</span></span>
<span class="line"></span>
<span class="line"><span style="color:#EDCC95">  	renderBeers</span><span style="color:#ECEBE8">() {		</span></span>
<span class="line"><span style="color:#A1C1E4">		return</span><span style="color:#A1C1E4"> this</span><span style="color:#EDCC95">.props.data.map</span><span style="color:#ECEBE8">((beer) </span><span style="color:#A1C1E4">=></span><span style="color:#ECEBE8"> {			</span></span>
<span class="line"><span style="color:#A1C1E4">		  return</span><span style="color:#ECEBE8"> &#x3C;</span><span style="color:#A1C1E4">BeerItem</span><span style="color:#EDCC95"> beer</span><span style="color:#A1C1E4">=</span><span style="color:#ECEBE8">{beer} />;</span></span>
<span class="line"><span style="color:#ECEBE8">		});</span></span>
<span class="line"><span style="color:#ECEBE8">	},</span></span>
<span class="line"></span>
<span class="line"><span style="color:#EDCC95">	render</span><span style="color:#ECEBE8">: </span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">() {		</span></span>
<span class="line"><span style="color:#A1C1E4">		return</span><span style="color:#ECEBE8"> (</span></span>
<span class="line"><span style="color:#ECEBE8">			&#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"panel panel-default"</span><span style="color:#ECEBE8">>			  </span></span>
<span class="line"><span style="color:#ECEBE8">			  &#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"panel-heading"</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">			    &#x3C;</span><span style="color:#A1C1E4">h3</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"panel-title"</span><span style="color:#ECEBE8">>History</span></span>
<span class="line"><span style="color:#ECEBE8">			    &#x3C;</span><span style="color:#A1C1E4">small</span><span style="color:#ECEBE8">> click to remove&#x3C;/</span><span style="color:#A1C1E4">small</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">			    &#x3C;/</span><span style="color:#A1C1E4">h3</span><span style="color:#ECEBE8">>			    </span></span>
<span class="line"><span style="color:#ECEBE8">			  &#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">			  &#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"panel-body"</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">			    &#x3C;</span><span style="color:#A1C1E4">ul</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">			    	{</span><span style="color:#A1C1E4">this</span><span style="color:#EDCC95">.renderBeers</span><span style="color:#ECEBE8">()}</span></span>
<span class="line"><span style="color:#ECEBE8">			    &#x3C;/</span><span style="color:#A1C1E4">ul</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">			  &#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">			&#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">		);</span></span>
<span class="line"><span style="color:#ECEBE8">	}</span></span>
<span class="line"><span style="color:#ECEBE8">})</span></span></code></pre></figure>
<p>Because it makes sense to handle the logic in every individual component, we define <code>BeerItem</code>, which receives the beer object. Note the data fetched from Meteor is now accessible in <code>this.props.data</code>.</p>
<p>Let’s end this part by creating <strong>client/beeritem.jsx</strong>:</p>
<figure class="code"><figcaption>jsx</figcaption><pre class="astro-code linha" style="background-color:#1b1814;color:#ecebe8; overflow-x: auto;" tabindex="0" data-language="jsx"><code><span class="line"><span style="color:#ECEBE8">BeerItem </span><span style="color:#A1C1E4">=</span><span style="color:#EDCC95"> React.createClass</span><span style="color:#ECEBE8">({</span></span>
<span class="line"><span style="color:#EDCC95">  	handleClick</span><span style="color:#ECEBE8">() {</span></span>
<span class="line"><span style="color:#A1C1E4">  		var</span><span style="color:#ECEBE8"> id </span><span style="color:#A1C1E4">=</span><span style="color:#A1C1E4"> this</span><span style="color:#ECEBE8">.props.beer._id;</span></span>
<span class="line"><span style="color:#EDCC95">  		Meteor.call</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"removeBeer"</span><span style="color:#ECEBE8">, id, </span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">(e) {</span></span>
<span class="line"><span style="color:#A1C1E4">  			if</span><span style="color:#ECEBE8"> (e) </span><span style="color:#EDCC95">alert</span><span style="color:#ECEBE8">(e.reason);</span></span>
<span class="line"><span style="color:#ECEBE8">  		});</span></span>
<span class="line"><span style="color:#ECEBE8">  	},</span></span>
<span class="line"></span>
<span class="line"><span style="color:#EDCC95">	render</span><span style="color:#ECEBE8">: </span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">() {</span></span>
<span class="line"><span style="color:#A1C1E4">		var</span><span style="color:#ECEBE8"> date </span><span style="color:#A1C1E4">=</span><span style="color:#EDCC95"> moment</span><span style="color:#ECEBE8">(</span><span style="color:#A1C1E4">this</span><span style="color:#ECEBE8">.props.beer.date)</span><span style="color:#EDCC95">.format</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"DD/MM/YYYY"</span><span style="color:#ECEBE8">);	</span></span>
<span class="line"><span style="color:#A1C1E4">		var</span><span style="color:#ECEBE8"> tail </span><span style="color:#A1C1E4">=</span><span style="color:#A1C1E4"> this</span><span style="color:#ECEBE8">.props.beer.beers </span><span style="color:#A1C1E4">></span><span style="color:#97CCAE"> 1</span><span style="color:#A1C1E4"> ?</span><span style="color:#97CCAE"> "beers"</span><span style="color:#A1C1E4"> :</span><span style="color:#97CCAE"> "beer"</span><span style="color:#ECEBE8">;</span></span>
<span class="line"></span>
<span class="line"><span style="color:#A1C1E4">		return</span><span style="color:#ECEBE8"> (</span></span>
<span class="line"><span style="color:#ECEBE8">			&#x3C;</span><span style="color:#A1C1E4">li</span><span style="color:#EDCC95"> onClick</span><span style="color:#A1C1E4">=</span><span style="color:#ECEBE8">{</span><span style="color:#A1C1E4">this</span><span style="color:#ECEBE8">.handleClick}>On &#x3C;</span><span style="color:#A1C1E4">strong</span><span style="color:#ECEBE8">>{date}&#x3C;/</span><span style="color:#A1C1E4">strong</span><span style="color:#ECEBE8">> grabbed &#x3C;</span><span style="color:#A1C1E4">strong</span><span style="color:#ECEBE8">>{</span><span style="color:#A1C1E4">this</span><span style="color:#ECEBE8">.props.beer.beers}&#x3C;/</span><span style="color:#A1C1E4">strong</span><span style="color:#ECEBE8">> {tail}&#x3C;/</span><span style="color:#A1C1E4">li</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">		);</span></span>
<span class="line"><span style="color:#ECEBE8">	}</span></span>
<span class="line"><span style="color:#ECEBE8">})</span></span></code></pre></figure>
<p>Comments:</p>
<ul>
<li>Be careful: data now is in <code>this.props.beer</code> in spite of what happened on the parent component.</li>
<li>We do some formatting to display things nicer.</li>
<li>Remember the <code>removeBeer</code> method we created at first? Here is when it’s invoked.</li>
</ul>
<p>See your work now on the browser. Our left column is done and you are able to insert elements through the form and delete any record simply by clicking on each item in the bottom panel.</p>
<h2 id="mapping-data">Mapping Data</h2>
<p>Before coding the <code>BarChart</code> component, it’s worth sparing a couple of minutes to think about its functionality and how we could reuse it in a future project. That’s what I thought for this case:</p>
<ul>
<li>It must have a label indicating the quantity of each bar.</li>
<li>It must have a label grouping each bar in some concept (e.g.: weekday, month, country, brand…).</li>
<li>It must have flexible width and height.</li>
</ul>
<p>You can think of many more functionalities (bar colors and transition effects for example) but we are sticking to the aforementioned.</p>
<p>Our goal is to receive the data in a specific format and then render the chart “agnostically”. This will allow you to reuse this component in any other module or even a project that is not Meteor-based! All you need is to ensure the data is passed in the correct format.</p>
<p>That being said, let’s define the data parameter will be an array of objects, each object comprising two parameters: <code>qty</code> and <code>xLabel</code>. Our component will iterate over every object and draw a bar associated with it, labeling it horizontally with the <code>xLabel</code> value and defining its height based on the <code>qty</code> value.</p>
<p>More specifically, go back to <strong>app.jsx</strong> and add the function:</p>
<figure class="code"><figcaption>jsx</figcaption><pre class="astro-code linha" style="background-color:#1b1814;color:#ecebe8; overflow-x: auto;" tabindex="0" data-language="jsx"><code><span class="line"><span style="color:#A1C1E4">...</span></span>
<span class="line"><span style="color:#EDCC95">getMeteorData</span><span style="color:#ECEBE8">() {</span></span>
<span class="line"><span style="color:#A1C1E4">  return</span><span style="color:#ECEBE8"> {</span></span>
<span class="line"><span style="color:#ECEBE8">      beers: </span><span style="color:#EDCC95">Beers.find</span><span style="color:#ECEBE8">({})</span><span style="color:#EDCC95">.fetch</span><span style="color:#ECEBE8">()</span></span>
<span class="line"><span style="color:#ECEBE8">    }</span></span>
<span class="line"><span style="color:#ECEBE8">  },</span></span>
<span class="line"></span>
<span class="line"><span style="color:#ECEBE8">  mapData: </span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">() {  		</span></span>
<span class="line"><span style="color:#A1C1E4">    var</span><span style="color:#ECEBE8"> data </span><span style="color:#A1C1E4">=</span><span style="color:#ECEBE8"> [</span></span>
<span class="line"><span style="color:#ECEBE8">      { qty: </span><span style="color:#97CCAE">0</span><span style="color:#ECEBE8">, xLabel: </span><span style="color:#97CCAE">"Sun"</span><span style="color:#ECEBE8"> }, </span></span>
<span class="line"><span style="color:#ECEBE8">      { qty: </span><span style="color:#97CCAE">0</span><span style="color:#ECEBE8">, xLabel: </span><span style="color:#97CCAE">"Mon"</span><span style="color:#ECEBE8"> },</span></span>
<span class="line"><span style="color:#ECEBE8">      { qty: </span><span style="color:#97CCAE">0</span><span style="color:#ECEBE8">, xLabel: </span><span style="color:#97CCAE">"Tue"</span><span style="color:#ECEBE8"> },</span></span>
<span class="line"><span style="color:#ECEBE8">      { qty: </span><span style="color:#97CCAE">0</span><span style="color:#ECEBE8">, xLabel: </span><span style="color:#97CCAE">"Wed"</span><span style="color:#ECEBE8"> },</span></span>
<span class="line"><span style="color:#ECEBE8">      { qty: </span><span style="color:#97CCAE">0</span><span style="color:#ECEBE8">, xLabel: </span><span style="color:#97CCAE">"Thu"</span><span style="color:#ECEBE8"> },</span></span>
<span class="line"><span style="color:#ECEBE8">      { qty: </span><span style="color:#97CCAE">0</span><span style="color:#ECEBE8">, xLabel: </span><span style="color:#97CCAE">"Fri"</span><span style="color:#ECEBE8"> },</span></span>
<span class="line"><span style="color:#ECEBE8">      { qty: </span><span style="color:#97CCAE">0</span><span style="color:#ECEBE8">, xLabel: </span><span style="color:#97CCAE">"Sat"</span><span style="color:#ECEBE8"> },</span></span>
<span class="line"><span style="color:#ECEBE8">    ];</span></span>
<span class="line"><span style="color:#A1C1E4">    this</span><span style="color:#EDCC95">.data.beers.map</span><span style="color:#ECEBE8">(</span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">(d) {</span></span>
<span class="line"><span style="color:#ECEBE8">      data[</span><span style="color:#EDCC95">moment</span><span style="color:#ECEBE8">(d.date)</span><span style="color:#EDCC95">.weekday</span><span style="color:#ECEBE8">()].qty </span><span style="color:#A1C1E4">+=</span><span style="color:#ECEBE8"> d.beers;</span></span>
<span class="line"><span style="color:#ECEBE8">    });</span></span>
<span class="line"><span style="color:#ECEBE8">    </span></span>
<span class="line"><span style="color:#A1C1E4">    return</span><span style="color:#ECEBE8"> data;</span></span>
<span class="line"><span style="color:#ECEBE8">  },</span></span>
<span class="line"><span style="color:#A1C1E4">...</span></span></code></pre></figure>
<p>Check the <code>mapData</code> function. It initializes the array of objects with no quantities but previously defined labels. Next, we map the beers object (returned from our collection) with the aid of MomentJS to add the number of beers to the <code>qty</code> property. The code might seem weird but it’s just JavaScript.</p>
<p>Our last change in this file is to render the <code>BarChart</code> component with mapped data. So go the <code>render</code> function and add in the second column:</p>
<figure class="code"><figcaption>jsx</figcaption><pre class="astro-code linha" style="background-color:#1b1814;color:#ecebe8; overflow-x: auto;" tabindex="0" data-language="jsx"><code><span class="line"><span style="color:#A1C1E4">...</span></span>
<span class="line"><span style="color:#ECEBE8">&#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"container"</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">  &#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"row"</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">    &#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"col-md-4"</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">      &#x3C;</span><span style="color:#A1C1E4">BeerForm</span><span style="color:#ECEBE8"> /></span></span>
<span class="line"><span style="color:#ECEBE8">      &#x3C;</span><span style="color:#A1C1E4">BeerList</span><span style="color:#EDCC95"> data</span><span style="color:#A1C1E4">=</span><span style="color:#ECEBE8">{</span><span style="color:#A1C1E4">this</span><span style="color:#ECEBE8">.data.beers}/></span></span>
<span class="line"><span style="color:#ECEBE8">    &#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"></span>
<span class="line"><span style="color:#ECEBE8">    &#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"col-md-offset-2 col-md-6"</span><span style="color:#ECEBE8">>					</span></span>
<span class="line"><span style="color:#ECEBE8">      &#x3C;</span><span style="color:#A1C1E4">BarChart</span><span style="color:#EDCC95"> data</span><span style="color:#A1C1E4">=</span><span style="color:#ECEBE8">{</span><span style="color:#A1C1E4">this</span><span style="color:#EDCC95">.mapData</span><span style="color:#ECEBE8">()} </span><span style="color:#EDCC95">width</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"480"</span><span style="color:#EDCC95"> height</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"320"</span><span style="color:#ECEBE8">/></span></span>
<span class="line"><span style="color:#ECEBE8">    &#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">  &#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">></span></span>
<span class="line"><span style="color:#ECEBE8">&#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">> </span></span>
<span class="line"><span style="color:#A1C1E4">...</span></span></code></pre></figure>
<p>Differently from the <code>BeerList</code> component, here the data object is coming through <code>mapData</code> function.</p>
<p>Everything is set, let’s bring D3 to the show.</p>
<h2 id="barchart-component">BarChart Component</h2>
<p>Let’s code the state-of-art of reactive chart rendering. Create <strong>client/barchart.jsx</strong> and add:</p>
<figure class="code"><figcaption>jsx</figcaption><pre class="astro-code linha" style="background-color:#1b1814;color:#ecebe8; overflow-x: auto;" tabindex="0" data-language="jsx"><code><span class="line"><span style="color:#ECEBE8">BarChart </span><span style="color:#A1C1E4">=</span><span style="color:#EDCC95"> React.createClass</span><span style="color:#ECEBE8">({</span></span>
<span class="line"></span>
<span class="line"><span style="color:#EDCC95">	componentDidMount</span><span style="color:#ECEBE8">: </span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">() {		</span></span>
<span class="line"><span style="color:#A1C1E4">  		var</span><span style="color:#ECEBE8"> el </span><span style="color:#A1C1E4">=</span><span style="color:#A1C1E4"> this</span><span style="color:#EDCC95">.getDOMNode</span><span style="color:#ECEBE8">(); </span><span style="color:#A7A49E;font-style:italic">// This is de div we are rendering</span></span>
<span class="line"><span style="color:#A1C1E4">  		var</span><span style="color:#ECEBE8"> svg </span><span style="color:#A1C1E4">=</span><span style="color:#EDCC95"> d3.select</span><span style="color:#ECEBE8">(el)</span></span>
<span class="line"><span style="color:#EDCC95">  				.append</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"svg"</span><span style="color:#ECEBE8">)</span></span>
<span class="line"><span style="color:#EDCC95">  				.attr</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"width"</span><span style="color:#ECEBE8">, </span><span style="color:#A1C1E4">this</span><span style="color:#ECEBE8">.props.width)</span></span>
<span class="line"><span style="color:#EDCC95">  				.attr</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"height"</span><span style="color:#ECEBE8">, </span><span style="color:#A1C1E4">this</span><span style="color:#ECEBE8">.props.height);</span></span>
<span class="line"><span style="color:#ECEBE8">  		  		</span></span>
<span class="line"><span style="color:#A1C1E4">  		this</span><span style="color:#EDCC95">.updateChart</span><span style="color:#ECEBE8">(</span><span style="color:#A1C1E4">this</span><span style="color:#ECEBE8">.props);</span></span>
<span class="line"><span style="color:#ECEBE8">  	},</span></span>
<span class="line"></span>
<span class="line"><span style="color:#EDCC95">  	componentWillUpdate</span><span style="color:#ECEBE8">: </span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">(nextProps) {  		</span></span>
<span class="line"><span style="color:#A1C1E4">  		this</span><span style="color:#EDCC95">.updateChart</span><span style="color:#ECEBE8">(nextProps);</span></span>
<span class="line"><span style="color:#ECEBE8">  	},</span></span>
<span class="line"></span>
<span class="line"><span style="color:#EDCC95">	getDefaultProps</span><span style="color:#ECEBE8">: </span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">() {</span></span>
<span class="line"><span style="color:#A1C1E4">		return</span><span style="color:#ECEBE8"> {</span></span>
<span class="line"><span style="color:#ECEBE8">		  width: </span><span style="color:#97CCAE">640</span><span style="color:#ECEBE8">,</span></span>
<span class="line"><span style="color:#ECEBE8">		  height: </span><span style="color:#97CCAE">480</span></span>
<span class="line"><span style="color:#ECEBE8">		}</span></span>
<span class="line"><span style="color:#ECEBE8">	},</span></span>
<span class="line"></span>
<span class="line"><span style="color:#EDCC95">    render</span><span style="color:#ECEBE8">: </span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">() {</span></span>
<span class="line"><span style="color:#A1C1E4">        return</span><span style="color:#ECEBE8"> (</span></span>
<span class="line"><span style="color:#ECEBE8">        	&#x3C;</span><span style="color:#A1C1E4">div</span><span style="color:#EDCC95"> className</span><span style="color:#A1C1E4">=</span><span style="color:#97CCAE">"chart"</span><span style="color:#ECEBE8">>&#x3C;/</span><span style="color:#A1C1E4">div</span><span style="color:#ECEBE8">>            </span></span>
<span class="line"><span style="color:#ECEBE8">        );</span></span>
<span class="line"><span style="color:#ECEBE8">    }</span></span>
<span class="line"><span style="color:#ECEBE8">});</span></span></code></pre></figure>
<p>Let’s start easy. React has a well-defined <a href="https://reactjs.org/docs/react-component.html" rel="noopener noreferrer" target="_blank">component lifecycle</a>, some of which we will use now. Starting from the bottom:</p>
<ul>
<li><code>render</code> returns an empty div. In a while, we will render our SVG into it.</li>
<li><code>getDefaultProps</code> is a protection for the case not all props are passed. In this case, we are setting the default values for width and height.</li>
<li><code>componentWillUpdate</code> is invoked every time the props change. This means that as our data is reactive, any change will trigger the custom <code>updateChart(props)</code> function (which we will define soon). Note the function takes a <code>nextProps</code> parameter, which is exactly what we need – whenever the props change, pass the new props to the rendering function.</li>
<li><code>componentDidMount</code> is invoked once when the component is first rendered. Here we create our SVG tag inside the div the component is rendering (returned by the <code>this.getDOMNode</code> function) with the sizing properties we established. After that, we call the rendering function to draw the bars in case there are any data.</li>
</ul>
<p>It’s worth noting that our <code>App</code> component might take a while to fetch all information, so the component might be initialized without any data. The guard for this is to update accordingly in response to the <code>componentWillUpdate</code> callback.</p>
<p>Canvas set, but we are not rendering anything! Let’s fix that by adding the following:</p>
<figure class="code"><figcaption>jsx</figcaption><pre class="astro-code linha" style="background-color:#1b1814;color:#ecebe8; overflow-x: auto;" tabindex="0" data-language="jsx"><code><span class="line"><span style="color:#ECEBE8">updateChart: </span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">(props) {</span></span>
<span class="line"><span style="color:#A1C1E4">    var</span><span style="color:#ECEBE8"> data </span><span style="color:#A1C1E4">=</span><span style="color:#ECEBE8"> props.data;</span></span>
<span class="line"></span>
<span class="line"><span style="color:#A1C1E4">    var</span><span style="color:#ECEBE8"> max </span><span style="color:#A1C1E4">=</span><span style="color:#EDCC95"> _.max</span><span style="color:#ECEBE8">(</span><span style="color:#EDCC95">_.pluck</span><span style="color:#ECEBE8">(data, </span><span style="color:#97CCAE">"qty"</span><span style="color:#ECEBE8">));</span></span>
<span class="line"><span style="color:#A1C1E4">    var</span><span style="color:#ECEBE8"> yScale </span><span style="color:#A1C1E4">=</span><span style="color:#EDCC95"> d3.scale.linear</span><span style="color:#ECEBE8">()</span></span>
<span class="line"><span style="color:#EDCC95">      .domain</span><span style="color:#ECEBE8">([</span><span style="color:#97CCAE">0</span><span style="color:#ECEBE8">, max])</span></span>
<span class="line"><span style="color:#EDCC95">      .range</span><span style="color:#ECEBE8">([</span><span style="color:#97CCAE">0</span><span style="color:#ECEBE8">, props.height </span><span style="color:#A1C1E4">-</span><span style="color:#97CCAE"> 35</span><span style="color:#ECEBE8">]);</span></span>
<span class="line"></span>
<span class="line"><span style="color:#A1C1E4">    var</span><span style="color:#ECEBE8"> xScale </span><span style="color:#A1C1E4">=</span><span style="color:#EDCC95"> d3.scale.ordinal</span><span style="color:#ECEBE8">()</span></span>
<span class="line"><span style="color:#EDCC95">      .domain</span><span style="color:#ECEBE8">(</span><span style="color:#EDCC95">d3.range</span><span style="color:#ECEBE8">(data.length))</span></span>
<span class="line"><span style="color:#EDCC95">      .rangeRoundBands</span><span style="color:#ECEBE8">([</span><span style="color:#97CCAE">0</span><span style="color:#ECEBE8">, props.width], </span><span style="color:#97CCAE">0.05</span><span style="color:#ECEBE8">);</span></span>
<span class="line"></span>
<span class="line"><span style="color:#A1C1E4">    var</span><span style="color:#ECEBE8"> svg </span><span style="color:#A1C1E4">=</span><span style="color:#EDCC95"> d3.select</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"svg"</span><span style="color:#ECEBE8">);</span></span>
<span class="line"></span>
<span class="line"><span style="color:#A1C1E4">    var</span><span style="color:#ECEBE8"> bars </span><span style="color:#A1C1E4">=</span><span style="color:#EDCC95"> svg.selectAll</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"rect"</span><span style="color:#ECEBE8">)</span><span style="color:#EDCC95">.data</span><span style="color:#ECEBE8">(data);</span></span>
<span class="line"><span style="color:#EDCC95">    bars.enter</span><span style="color:#ECEBE8">()</span></span>
<span class="line"><span style="color:#EDCC95">        .append</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"rect"</span><span style="color:#ECEBE8">)</span></span>
<span class="line"><span style="color:#EDCC95">        .attr</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"fill"</span><span style="color:#ECEBE8">, </span><span style="color:#97CCAE">"orange"</span><span style="color:#ECEBE8">)	        </span></span>
<span class="line"></span>
<span class="line"><span style="color:#EDCC95">    bars.transition</span><span style="color:#ECEBE8">()</span></span>
<span class="line"><span style="color:#EDCC95">      .duration</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">1000</span><span style="color:#ECEBE8">)</span></span>
<span class="line"><span style="color:#EDCC95">      .attr</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"x"</span><span style="color:#ECEBE8">, </span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">(d, i) {	    		</span></span>
<span class="line"><span style="color:#A1C1E4">          return</span><span style="color:#EDCC95"> xScale</span><span style="color:#ECEBE8">(i);</span></span>
<span class="line"><span style="color:#ECEBE8">        })</span></span>
<span class="line"><span style="color:#EDCC95">        .attr</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"y"</span><span style="color:#ECEBE8">, </span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">(d, i) {</span></span>
<span class="line"><span style="color:#A1C1E4">          return</span><span style="color:#ECEBE8"> props.height </span><span style="color:#A1C1E4">-</span><span style="color:#EDCC95"> yScale</span><span style="color:#ECEBE8">(d.qty) </span><span style="color:#A1C1E4">-</span><span style="color:#97CCAE"> 20</span><span style="color:#ECEBE8">;</span></span>
<span class="line"><span style="color:#ECEBE8">        })</span></span>
<span class="line"><span style="color:#EDCC95">        .attr</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"width"</span><span style="color:#ECEBE8">, </span><span style="color:#EDCC95">xScale.rangeBand</span><span style="color:#ECEBE8">())</span></span>
<span class="line"><span style="color:#EDCC95">        .attr</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"height"</span><span style="color:#ECEBE8">, </span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">(d, i) {</span></span>
<span class="line"><span style="color:#A1C1E4">          return</span><span style="color:#EDCC95"> yScale</span><span style="color:#ECEBE8">(d.qty)</span></span>
<span class="line"><span style="color:#ECEBE8">        });</span></span>
<span class="line"></span>
<span class="line"><span style="color:#EDCC95">    bars.exit</span><span style="color:#ECEBE8">()</span></span>
<span class="line"><span style="color:#EDCC95">        .remove</span><span style="color:#ECEBE8">();</span></span>
<span class="line"></span>
<span class="line"><span style="color:#A1C1E4">    var</span><span style="color:#ECEBE8"> qtyLabel </span><span style="color:#A1C1E4">=</span><span style="color:#EDCC95"> svg.selectAll</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">".qtyLabel"</span><span style="color:#ECEBE8">)</span><span style="color:#EDCC95">.data</span><span style="color:#ECEBE8">(data);</span></span>
<span class="line"><span style="color:#EDCC95">    qtyLabel.enter</span><span style="color:#ECEBE8">()</span></span>
<span class="line"><span style="color:#EDCC95">        .append</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"text"</span><span style="color:#ECEBE8">)</span></span>
<span class="line"><span style="color:#EDCC95">        .attr</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"class"</span><span style="color:#ECEBE8">, </span><span style="color:#97CCAE">"qtyLabel"</span><span style="color:#ECEBE8">)</span></span>
<span class="line"><span style="color:#EDCC95">        .style</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"font-weight"</span><span style="color:#ECEBE8">, </span><span style="color:#97CCAE">"bold"</span><span style="color:#ECEBE8">)</span></span>
<span class="line"><span style="color:#EDCC95">        .attr</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"text-anchor"</span><span style="color:#ECEBE8">, </span><span style="color:#97CCAE">"middle"</span><span style="color:#ECEBE8">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#EDCC95">    qtyLabel.transition</span><span style="color:#ECEBE8">()</span></span>
<span class="line"><span style="color:#EDCC95">      .duration</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">1000</span><span style="color:#ECEBE8">)									</span></span>
<span class="line"><span style="color:#EDCC95">    .attr</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"x"</span><span style="color:#ECEBE8">, </span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">(d, i) {</span></span>
<span class="line"><span style="color:#A1C1E4">      return</span><span style="color:#EDCC95"> xScale</span><span style="color:#ECEBE8">(i) </span><span style="color:#A1C1E4">+</span><span style="color:#EDCC95"> xScale.rangeBand</span><span style="color:#ECEBE8">()</span><span style="color:#A1C1E4">/</span><span style="color:#97CCAE">2</span><span style="color:#ECEBE8">;</span></span>
<span class="line"><span style="color:#ECEBE8">    })</span></span>
<span class="line"><span style="color:#EDCC95">    .attr</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"y"</span><span style="color:#ECEBE8">, </span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">(d, i) {</span></span>
<span class="line"><span style="color:#A1C1E4">      return</span><span style="color:#ECEBE8"> props.height </span><span style="color:#A1C1E4">-</span><span style="color:#EDCC95"> yScale</span><span style="color:#ECEBE8">(d.qty) </span><span style="color:#A1C1E4">-</span><span style="color:#97CCAE"> 25</span></span>
<span class="line"><span style="color:#ECEBE8">    })</span></span>
<span class="line"><span style="color:#EDCC95">    .text</span><span style="color:#ECEBE8">(</span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">(d, i) { 	    	  	</span></span>
<span class="line"><span style="color:#A1C1E4">      return</span><span style="color:#ECEBE8"> d.qty; </span></span>
<span class="line"><span style="color:#ECEBE8">    });</span></span>
<span class="line"></span>
<span class="line"><span style="color:#A1C1E4">    var</span><span style="color:#ECEBE8"> xLabel </span><span style="color:#A1C1E4">=</span><span style="color:#EDCC95"> svg.selectAll</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">".xLabel"</span><span style="color:#ECEBE8">)</span><span style="color:#EDCC95">.data</span><span style="color:#ECEBE8">(data);</span></span>
<span class="line"><span style="color:#EDCC95">    xLabel.enter</span><span style="color:#ECEBE8">()</span></span>
<span class="line"><span style="color:#EDCC95">        .append</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"text"</span><span style="color:#ECEBE8">)</span></span>
<span class="line"><span style="color:#EDCC95">        .attr</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"class"</span><span style="color:#ECEBE8">, </span><span style="color:#97CCAE">"xLabel"</span><span style="color:#ECEBE8">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#EDCC95">    xLabel.text</span><span style="color:#ECEBE8">(</span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">(d, i) { 	    	  	</span></span>
<span class="line"><span style="color:#A1C1E4">          return</span><span style="color:#ECEBE8"> d.xLabel; </span></span>
<span class="line"><span style="color:#ECEBE8">        })</span></span>
<span class="line"><span style="color:#EDCC95">        .attr</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"text-anchor"</span><span style="color:#ECEBE8">, </span><span style="color:#97CCAE">"middle"</span><span style="color:#ECEBE8">)</span></span>
<span class="line"><span style="color:#EDCC95">        .attr</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"x"</span><span style="color:#ECEBE8">, </span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">(d, i) {</span></span>
<span class="line"><span style="color:#A1C1E4">          return</span><span style="color:#EDCC95"> xScale</span><span style="color:#ECEBE8">(i) </span><span style="color:#A1C1E4">+</span><span style="color:#EDCC95"> xScale.rangeBand</span><span style="color:#ECEBE8">()</span><span style="color:#A1C1E4">/</span><span style="color:#97CCAE">2</span><span style="color:#ECEBE8">;</span></span>
<span class="line"><span style="color:#ECEBE8">        })</span></span>
<span class="line"><span style="color:#EDCC95">        .attr</span><span style="color:#ECEBE8">(</span><span style="color:#97CCAE">"y"</span><span style="color:#ECEBE8">, </span><span style="color:#A1C1E4">function</span><span style="color:#ECEBE8">(d, i) {</span></span>
<span class="line"><span style="color:#A1C1E4">          return</span><span style="color:#ECEBE8"> props.height </span><span style="color:#A1C1E4">-</span><span style="color:#97CCAE"> 5</span><span style="color:#ECEBE8">; </span></span>
<span class="line"><span style="color:#ECEBE8">        });</span></span>
<span class="line"><span style="color:#ECEBE8">},</span></span></code></pre></figure>
<p>If you are familiarized with D3, there’s nothing to worry about it. For those who aren’t, some explanation:</p>
<ul>
<li>Line 4 uses <a href="http://underscorejs.org/" rel="noopener noreferrer" target="_blank">Underscore</a> to get the maximum value of <code>qty</code>. We use it to define our vertical scale. Note we give some space on the top to add the label.</li>
<li>In lines 15-18 we bind all rect elements to the data we mapped before and handle when a new rect is detected (appending into SVG and setting its color).</li>
<li>Lines 20-31 are where we perform updates. Transitions smooth the changes and we set the new values of x, y, width and height. Note we also give some space now at the bottom to insert another label.</li>
<li>Lines 33-34 delete unnecessary rects.</li>
<li>Lines 36-70 describe pretty much the same, now with labels and some positioning adjustments. This is nothing but a trial-and-error game until you feel comfortable.</li>
</ul>
<p>And we are done! More important than the code is how to behave when integrating React and D3 – you first render the svg and then update the elements (rect and text in this case) whenever your data changes.</p>
<h2 id="summarizing">Summarizing</h2>
<p>This was a very comprehensive and long tutorial. Take a time to digest everything but keep the notion that integrating Meteor, React and D3 shouldn’t be painful. Moreover, if you are careful when designing your components, they will be reusable from now on.</p>
<p>Exercise: how could you improve <code>BeerForm</code>, <code>BeerList</code> and <code>BeerItem</code> to become a single solid and reusable component?</p>
<p>In the likely event that something could have been implemented better or more efficiently, don’t hesitate and make a comment or start a new discussion. See you around!</p>]]></content:encoded>
</item>
</channel>
</rss>
