React-chartjsx Simple Yet Flexible React Chart Components for Designers & Developers

People normally don’t want to go through a large amount of data presented to them in form of text or tables. Mostly that’s because it is boring, but more importantly, it’s a little harder to process raw numbers.

Here is a table of the ten most populous countries in the world:

react-chartjsx

With only five countries in this table, there is still a very good chance that you and other will skip over the table entirely. Normally, people only look at one or two countries that interest them. If the same data had been presented in the form of a bar chart, it would have taken very little time for someone to get a rough idea of the population in these countries.

Moreover, it will be a lot easier to figure out trends or facts, for example, Asia is twice as populated as Africa, and Asia has about ten times more people than Latin America by looking at the length of bars in the chart.

Bar chart

react-chartjsx

react-chartjsx

The official React chart.js components. A simple yet flexible react chart components for designers & developers that you can use to create different kinds of charts is react-chartjsx. In this series, you will be learning about all the important aspects of this react chart components. It can be used to create fancy, responsive charts on HTML5 Canvas.

react-chartjsx allows you to mix different chart types and plot data on date time, logarithmic, or custom scales with ease. The library also sports out-of-the-box animations that can be applied when changing data or updating colors.

Let’s get started with the installation, and then we’ll move on to configuration options and other aspects.

Installation

1
npm install react-chartjsx chart.js --save

Usage

1
2
3
4
5
6
7
8
9
10
11
import { Bar, Line } from 'react-chartjsx'

<Bar data={this.state.barChartData}
     options={chartOptions}
     width={800}
     height={400} />

<Line data={this.state.lineChartData} 
      options={chartOptions} 
      width={400} 
      height={400} />

Properties
- data: PropTypes.object.isRequired
- width: PropTypes.number
- height: PropTypes.number
- options: PropTypes.object
- redraw: PropTypes.bool
- getDatasetAtEvent: PropTypes.func
- getElementAtEvent: PropTypes.func
- getElementsAtEvent: PropTypes.func
- getChart: PropTypes.func
- getCanvas: PropTypes.func

Redraw
If you want the chart destroyed and redrawn on every change, pass in redraw as true.

1
2
3
4
5
6
7
import { Bar } from 'react-chartjsx'

<Bar data={this.state.barChartData}
     options={chartOptions}
     width={800}
     height={400}
     redraw={true} />

Custom size
To custom size you need to set responsive to false.

1
2
3
4
5
6
7
8
const chartOptions = {
  responsive: false
}

<Bar data={this.state.chartDataBar}
     options={chartOptions}
     width={800}
     height={400} />

Events

getDatasetAtEvent
Looks for the element under the event point, then returns all elements from that dataset. This is used internally for ‘dataset’ mode highlighting.

1
2
3
4
5
6
7
8
9
const chartOptions = {
  responsive: false
}

<Bar data={this.state.barChartData}
     options={chartOptions}
     width={800}
     height={400}
     getDatasetAtEvent={(dataset, event) => {console.log(dataset)}} />

getElementAtEvent
Calling getElementAtEvent(event) on your Chart instance passing an argument of an event, will return the single element at the event position. If there are multiple items within range, only the first is returned.

1
2
3
4
5
6
7
8
9
const chartOptions = {
  responsive: false
}

<Bar data={this.state.barChartData}
     options={chartOptions}
     width={800}
     height={400}
     getElementAtEvent={(elems, event) => {console.log(elems)}} />

getElementsAtEvent
A function to be called when mouse clicked on chart elememts, will return all element at that point as an array.

1
2
3
4
5
6
7
8
9
const chartOptions = {
  responsive: false
}

<Bar data={this.state.barChartData}
     options={chartOptions}
     width={800}
     height={400}
     getElementsAtEvent={(elems, event) => {console.log(elems)}} />

getChart
A function to be called for getting chartjs object.

1
2
3
4
5
6
7
8
9
const chartOptions = {
  responsive: false
}

<Bar data={this.state.barChartData}
     options={chartOptions}
     width={800}
     height={400}
     getChart={(chart) => {console.log(chart)}} />

getCanvas
A function to be called for getting canvas element.

1
2
3
4
5
6
7
8
9
const chartOptions = {
  responsive: false
}

<Bar data={this.state.barChartData}
     options={chartOptions}
     width={800}
     height={400}
     getCanvas={(canvas) => {console.log(canvas)}} />

Sample

Bar chart

Bar chart

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
import { Bar } from 'react-chartjsx'

export default class App extends Component {
  state = {
    barChartData: {
      labels: ["Africa", "Asia", "Europe", "Latin America", "North America"],
      datasets: [
        {
          label: "Population (millions)",
          backgroundColor: ["#3e95cd", "#8e5ea2","#3cba9f","#e8c3b9","#c45850"],
          data: [2478,5267,734,784,433]
        }
      ]
    }
  }

  constructor(props) {
    super(props)
  }

  render() {
    const chartOptions = {
      responsive: false
    }

    return (
      <div>
        <Bar data={this.state.barChartData}
             options={chartOptions}
             width={800}
             height={400} />
      </div>
    )
  }
}

Line chart

Line chart

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
import { Line } from 'react-chartjsx'

export default class App extends Component {
  state = {
    lineChartData: {
      labels: [1500,1600,1700,1750,1800,1850,1900,1950,1999,2050],
      datasets: [{
          data: [86,114,106,106,107,111,133,221,783,2478],
          label: "Africa",
          borderColor: "#3e95cd",
          fill: false
        }, {
          data: [282,350,411,502,635,809,947,1402,3700,5267],
          label: "Asia",
          borderColor: "#8e5ea2",
          fill: false
        }, {
          data: [168,170,178,190,203,276,408,547,675,734],
          label: "Europe",
          borderColor: "#3cba9f",
          fill: false
        }, {
          data: [40,20,10,16,24,38,74,167,508,784],
          label: "Latin America",
          borderColor: "#e8c3b9",
          fill: false
        }, {
          data: [6,3,2,2,7,26,82,172,312,433],
          label: "North America",
          borderColor: "#c45850",

          fill: false
        }
      ]
    }
  }

  constructor(props) {
    super(props)
  }

  render() {
    const chartOptions = {
      responsive: false
    }

    return (
      <div>
        <Line data={this.state.lineChartData}
              options={chartOptions}
              width={800}
              height={400} />
      </div>
    )
  }
}

Pie chart

Pie chart

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
import { Pie } from 'react-chartjsx'

export default class App extends Component {
  state = {
    pieChartData: {
      labels: ["Africa", "Asia", "Europe", "Latin America", "North America"],
      datasets: [{
        label: "Population (millions)",
        backgroundColor: ["#3e95cd", "#8e5ea2","#3cba9f","#e8c3b9","#c45850"],
        data: [2478,5267,734,784,433]
      }]
    }
  }

  constructor(props) {
    super(props)
  }

  render() {
    const chartOptions = {
      responsive: false
    }

    return (
      <div>
        <Pie data={this.state.pieChartData}
             options={chartOptions}
             width={800}
             height={400} />
      </div>
    )
  }
}

Radar chart

Radar chart

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
import { Radar } from 'react-chartjsx'

export default class App extends Component {
  state = {
    radarChartData: {
      labels: ["Africa", "Asia", "Europe", "Latin America", "North America"],
      datasets: [
        {
          label: "1950",
          fill: true,
          backgroundColor: "rgba(179,181,198,0.2)",
          borderColor: "rgba(179,181,198,1)",
          pointBorderColor: "#fff",
          pointBackgroundColor: "rgba(179,181,198,1)",
          data: [8.77,55.61,21.69,6.62,6.82]
        }, {
          label: "2050",
          fill: true,
          backgroundColor: "rgba(255,99,132,0.2)",
          borderColor: "rgba(255,99,132,1)",
          pointBorderColor: "#fff",
          pointBackgroundColor: "rgba(255,99,132,1)",
          pointBorderColor: "#fff",
          data: [25.48,54.16,7.61,8.06,4.45]
        }
      ]
    }
  }

  constructor(props) {
    super(props)
  }

  render() {
    const chartOptions = {
      responsive: false
    }

    return (
      <div>
        <Radar data={this.state.radarChartData}
               options={chartOptions}
               width={800}
               height={400} />
      </div>
    )
  }
}

Polar area chart

Polar area chart

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
import { PolarArea } from 'react-chartjsx'

export default class App extends Component {
  state = {
    polarAreaChartData: {
      labels: ["Africa", "Asia", "Europe", "Latin America", "North America"],
      datasets: [
        {
          label: "Population (millions)",
          backgroundColor: ["#3e95cd", "#8e5ea2","#3cba9f","#e8c3b9","#c45850"],
          data: [2478,5267,734,784,433]
        }
      ]
    }
  }

  constructor(props) {
    super(props)
  }

  render() {
    const chartOptions = {
      responsive: false
    }

    return (
      <div>
        <PolarArea data={this.state.polarAreaChartData}
                   options={chartOptions}
                   width={800}
                   height={400} />
      </div>
    )
  }
}

Doughnut chart

Doughnut chart

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
import { Doughnut } from 'react-chartjsx'

export default class App extends Component {
  state = {
    doughnutChartData: {
      labels: ["Africa", "Asia", "Europe", "Latin America", "North America"],
      datasets: [
        {
          label: "Population (millions)",
          backgroundColor: ["#3e95cd", "#8e5ea2","#3cba9f","#e8c3b9","#c45850"],
          data: [2478,5267,734,784,433]
        }
      ]
    }
  }

  constructor(props) {
    super(props)
  }

  render() {
    const chartOptions = {
      responsive: false
    }

    return (
      <div>
        <Doughnut data={this.state.doughnutChartData}
                  options={chartOptions}
                  width={800}
                  height={400} />
      </div>
    )
  }
}

Horizontal bars chart

Horizontal bars chart

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
import { HorizontalBar } from 'react-chartjsx'

export default class App extends Component {
  state = {
    horizontalBarsChartData: {
      labels: ["Africa", "Asia", "Europe", "Latin America", "North America"],
      datasets: [
        {
          label: "Population (millions)",
          backgroundColor: ["#3e95cd", "#8e5ea2","#3cba9f","#e8c3b9","#c45850"],
          data: [2478,5267,734,784,433]
        }
      ]
    }
  }

  constructor(props) {
    super(props)
  }

  render() {
    const chartOptions = {
      responsive: false
    }

    return (
      <div>
        <HorizontalBar data={this.state.horizontalBarsChartData}
                       options={chartOptions}
                       width={800}
                       height={400} />
      </div>
    )
  }
}

Grouped bars chart

Grouped bars chart

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
import { Bar } from 'react-chartjsx'

export default class App extends Component {
  state = {
    groupedBarsChartData: {
      labels: ["1900", "1950", "1999", "2050"],
      datasets: [
        {
          label: "Africa",
          backgroundColor: "#3e95cd",
          data: [133,221,783,2478]
        }, {
          label: "Europe",
          backgroundColor: "#8e5ea2",
          data: [408,547,675,734]
        }
      ]
    }
  }

  constructor(props) {
    super(props)
  }

  render() {
    const chartOptions = {
      responsive: false
    }

    return (
      <div>
        <Bar data={this.state.groupedBarsChartData}
             options={chartOptions}
             width={800}
             height={400} />
      </div>
    )
  }
}

Mixed charts

Mixed charts

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
import { Bar } from 'react-chartjsx'

export default class App extends Component {
  state = {
    mixedChartsData: {
      labels: ["1900", "1950", "1999", "2050"],
      datasets: [{
          label: "Europe",
          type: "line",
          borderColor: "#8e5ea2",
          data: [408,547,675,734],
          fill: false
        }, {
          label: "Africa",
          type: "line",
          borderColor: "#3e95cd",
          data: [133,221,783,2478],
          fill: false
        }, {
          label: "Europe",
          type: "bar",
          backgroundColor: "rgba(0,0,0,0.2)",
          data: [408,547,675,734],
        }, {
          label: "Africa",
          type: "bar",
          backgroundColor: "rgba(0,0,0,0.2)",
          backgroundColorHover: "#3e95cd",
          data: [133,221,783,2478]
        }
      ]
    }
  }

  constructor(props) {
    super(props)
  }

  render() {
    const chartOptions = {
      responsive: false
    }

    return (
      <div>
        <Bar data={this.state.mixedChartsData}
             options={chartOptions}
             width={800}
             height={400} />
      </div>
    )
  }
}

Bubble chart

Bubble chart

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
import { Scatter } from 'react-chartjsx'

export default class App extends Component {
  state = {
    scatterChartData: {
      datasets: [
        {
          label: 'Latin America',
          borderColor: "#3e95cd",
          data: [
            {
              x: -10,
              y: 0
            }, {
              x: 0,
              y: 10
            }, {
              x: 10,
              y: 5
            }, {
              x: 20,
              y: 6
            }
          ]
        }, {
          label: 'Asia',
          borderColor: "#8e5ea2",
          data: [
            {
              x: -11,
              y: 1
            }, {
              x: 1,
              y: 11
            }, {
              x: 11,
              y: 6
            }, {
              x: 21,
              y: 7
            }
          ]
        }
      ]
    }
  }

  constructor(props) {
    super(props)
  }

  render() {
    const chartOptions = {
      responsive: false
    }

    return (
      <div>
        <Scatter data={this.state.scatterChartData}
                 options={chartOptions}
                 width={800}
                 height={400} />
      </div>
    )
  }
}

Well, You can read all details on the project’s GitHub repo.

Progressive & Lazy Loading Image With lazy-load-images.js

Lazy load images

With images making up a whopping 65% of all web content, page load time on websites can easily become an issue.

Images can weight quite a bit. This can have a negative impact on the time visitors have to wait before they can access content on your website. they will get navigate somewhere else, unless you come up with a solution to image loading.

What is lazy loading?
Lazy loading images means loading images on websites asynchronously that is, after the content is fully loaded, or even conditionally, only when they appear in the browser’s viewport. This means that if users don’t scroll all the way down, images placed at the bottom of the page won’t be loaded.

What reason you should care of lazy loading images?
There are many reasons you should consider of lazy loading images for your website:

If your website uses JavaScript to display content or provide some functionality to users, loading the DOM quickly becomes critical. It’s common for scripts to wait until the DOM has completely loaded before they start running. On a site with a number of images, lazy loading or loading images asynchronously could make the difference between users staying or leaving your website.

Since most lazy loading solutions work by loading images only if the user has scrolled to the location where images would be visible inside the viewport, those images will never be loaded if users never get to that point. This means considerable savings in bandwidth, for which most users, especially those accessing the web on mobile devices and slow-connections.

Lazy loading images helps with website performance, but what’s the best way to go about it?

Well, lazy-load-images.js is a javascript library which could help you with the website performance.

lazy-load-images.js is loading with blurred image effect
If you are a Medium reader, you have certainly noticed how the site loads the main image inside a post.

The first thing you see is a blurred, low-resolution copy of the image, while its high-resversion is being lazy loaded:

Blurred placeholder image on lazy-load-images.js website:

Lazy load images

High-res, lazy loaded image on lazy-load-images.js website:

Lazy load images

You can lazy load images with this interesting blurring effect in a number of ways.

My favorite technique/library is using lazy-load-images.js. Here’s all the features/goodness:
- Fast loading
- High performance
- Supports all images type
- Responsive images
- Supports all modern browsers Chrome, Firefox, Safari, (IE10+), … etc.

You can read all details and download the lazy-load-images.js library on the project’s GitHub repo.

Serve Static Files sitemap.xml, robots.txt and favicon.ico With Next.js

Serve static files sitemap.xml, robots.txt and favicon.ico with Next.js

Well, to serve static files such as sitemap.xml, robots.txt and favicon.ico with Next.js you just put those static files in static folder and add the below code to your server (server.js) config:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
const robotsOptions = {
  root: __dirname + '/static/',
  headers: {
    'Content-Type': 'text/plain;charset=UTF-8',
  }
};
server.get('/robots.txt', (req, res) => (
  res.status(200).sendFile('robots.txt', robotsOptions)
));

const sitemapOptions = {
  root: __dirname + '/static/',
  headers: {
    'Content-Type': 'text/xml;charset=UTF-8',
  }
};
server.get('/sitemap.xml', (req, res) => (
  res.status(200).sendFile('sitemap.xml', sitemapOptions)
));

const faviconOptions = {
  root: __dirname + '/static/'
};
server.get('/favicon.ico', (req, res) => (
  res.status(200).sendFile('favicon.ico', faviconOptions)
));

So far so good, That’s it!!! See ya!!! :)

Import CSS Files Into Nextjs

Import CSS Files into Nextjs

The way to import css files into Nextjs is very simple:

1. Create a /static folder at the same level of /pages folder.
2. In /static folder put your .css files.
3. In your pages components import Head and add a CSS .

1
2
3
4
5
6
7
8
9
10
11
12
13
import Head from 'next/head'

export default () => (
  <div>
    <Head>
      <title>My styles pages</title>
      <link href="/statics/styles.css" rel="stylesheet" />
    </Head>
    <p className="some-class-name">
      Welcome to my styles pages!
    </p>
  </div>
)

This way Nextjs render the link tag in the head of the page and the browser will download the CSS and applied it.

So far so good, That’s it!!! See ya!!! :)

Import Markdown Files and Serve Its Content in Next.js

Import Markdown Files in Next.js

As @arunoda (Next.js founder) said Next.js does not support importing markdown files yet. But you can configure the Next.js webpack loaders to load raw-loader modules and import markdown files and return them as strings.

Let get started!

Open the terminal, run the command below to install raw-loader and react-markdown modules (noted: use react-markdown to renders markdown as pure React components):

1
2
3
npm install --save raw-loader

npm install --save react-markdown

Create next.config.js file with content below:

next.config.js
1
2
3
4
5
6
7
8
9
10
11
12
module.exports = {
  webpack: (config) => {
    config.module.rules.push(
      {
        test: /\.md$/,
        use: 'raw-loader'
      }
    )

    return config
  },
}

Create docs/about.md file with content below:

about.md
1
2
3
# About

Welcome to **GeeKhmer**!

Create pages/about.js file with content below:

about.js
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
import React from 'react'
import ReactMarkdown from 'react-markdown'

export default class extends React.Component {
  static async getInitialProps({ req }) {
    const content = await require(`../docs/about.md`)
    return { content }
  }

  render() {
    return (
      <div>
        <ReactMarkdown source={this.props.content} />
      </div>
    )
  }
}

So far so good, That’s it!!! See ya!!! :)

The Most Popular ReactJs User Interface Frameworks

I was researching for the rich UI frameworks based on ReactJs which give the power of composability through ReactJs components, that you can directly plug in into your ReactJs project. Let go through the list below and pickup the right one.

Material-UI
Material-UI is a set of ReactJs components which implement Google’s Material Design. Source

Material UI

React-Bootstrap
Bootstrap is one of the most advanced UI frameworks out there and has got most of the things right. Source

React Bootstrap

React-Foundation
Foundation from Zurb is a very feature-rich and easily customizable library. Source

React Foundation

React-Semantic
Semantic UI React is the official React integration for Semantic UI. Source

React Semantic

The Most Popular ReactJs Data Table

I’ve been researching this for many days so I can help you at least find the ones out there. I don’t have experience with most of these but the one I do have experience with is one I don’t recommend as it seems unmaintained. Though I did find it well documented and easy to use. My requirements aren’t particularly complicated for a data-grid component, I basically look at filtering, sorting and row selection. If you need anything more complicated you’ll have to dig further into the documentations.

React-Data-Grid
Excel-liked grid component built with React, with editors, keyboard navigation, copy & paste, and the like http://adazzle.github.io/react-data-grid.

React-Data-Grid

React-Bootstrap-Table
It’s a ReactJs table for bootstrap, named react-bootstrap-table. It’s a configurable, functional table component and make you build a Bootstrap Table more efficiency and easy in your ReactJs application like https://allenfang.github.io/react-bootstrap-table.

React-Bootstrap-Table

Griddle
It’s an ultra customizable data-grid component for ReactJs like http://griddlegriddle.github.io/Griddle.

Griddle

React-Table
React-Table is a lightweight, fast and extendable data-grid built for ReactJs like https://react-table.js.org.

React-Table

Create-React-App vs NextJs

Create-React-App Vs NextJs

NextJs is a new project with a lot to offer.

The comparison between NextJs and Create-React-App is an apt one. What NextJs brings is great defaults. Like Create-React-App, NextJs is opinionated. It makes choices for you about what an ideal React setup should look like.

One of the biggest pain points in starting a new javascript App is the tooling. Webpack, babel, and the like can be a pain to setup, especially with the aggressive release cycle of open source javascript projects. As of this writing you’re probably already using Webpack syntax that’s been deprecated.

Here are the biggest differences between Create-React-App and NextJs.

Create-React-App Is Ejectable, NextJs Is Extensible

Create-React-App uses babel, webpack, and eslint but “hides” this tooling and bundles it together in react-scripts. But Create-React-App doesn’t lock you in; when you’re ready to depart from training wheels you can unmask these dependencies and then configure them.

NextJs, on the other hand, provides great defaults with the option to configure tooling if you want to. For example, you can override (or extend) NextJs’s webpack configuration by adding a webpack.config.js file. Or you can add an express server if you don’t want to use NextJs’ server.

NextJs is Out Of The Box

The biggest point of NextJs is server-side rendering.

People will tell you that Google crawls javascript and that it’s sufficient to serve up an almost-empty html document with root class along with a massive bundle.js.

It’s true that Google crawls javascript. But this just isn’t a good approach for apps that are content-focused and need to expose their content to search.

Styling is A Pain With NextJs

NextJs can be a pain with styling. Out of the box, NextJs uses styled-jsx, which is OK. But what if you want to use SASS or styled-components? You’re in for a few hours of frustration.

You Can’t make API Calls In Components With NextJs

Initializing a new NextJs project creates two directores ./pages and ./components.

Pages are like container React components. But they have more significance than simply wrapping other components. Page components are literally rendered into pages with a little help from react-router. That is, http://localhost:3000/about points to ./pages/about.js. This approach has strengthes and limitations. One of the limitations is that you can only make a client-side fetch request in top-level page components.

Create-React-App Vs NextJs: Comparison Table

Create React App NextJs
Dependencies One (react-scripts) One (next)
Ejectable Yes No
Extensible No Yes
Isomorphic/Universal No Yes
Zero-configuration Yes Yes
Service workers Yes No
Hot-reloading Yes Yes
Code-splitting Can be configured Out of the box

Conclusion

NextJs is a good start if you need SSR first, SEO friendly with lots of public content. But if you build a highly dynamic statically deployed Single Page Application client, CRA (Create React App) is better suited for that.

So for blog, news, with lots of public content and shareability, I’ll go with NextJs. For dashboard, admin, apps, I’ll go with CRA (Create React App)

Laravel 5.x.x Migrations

Laravel 5.x.x Migrations

Laravel migrations provide mechanisms for creating and modifying database tables. Migrations are database agnostic, this means you don’t have to worry about the specific SQL syntax for the database engine that you are creating tables for.

Well, in this articles I will cover the following sections: Requirements for running migrations, Artisan migration command, Migration structure, How to create a table using a migration, Laravel migration rollback, Laravel migration how-tos, Database seeding.

Requirements for Running Migrations

1. Create the database for Laravel project
2. Set the database connection parameters for Laravel project
3. Set the database connection parameters for artisan command line

1. Create the Database for Laravel Project
Open up terminator or what ever MySQL database management tool that you are using and run the command below:

1
CREATE DATABASE foodie;

CREATE DATABASE foodie; creates a database called foodie in MySQL.

2. Set the Database Connection Parameters for Laravel Project
Open up /config/database.php file and modify to the following:

database.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
'mysql' => [
  'driver' => 'mysql',
  'host' => env('DB_HOST', '127.0.0.1'),
  'port' => env('DB_PORT', '3306'),
  'database' => env('DB_DATABASE', 'foodie'),
  'username' => env('DB_USERNAME', 'root'),
  'password' => env('DB_PASSWORD', ''),
  'unix_socket' => env('DB_SOCKET', ''),
  'charset' => 'utf8mb4',
  'collation' => 'utf8mb4_unicode_ci',
  'prefix' => '',
  'strict' => true,
  'engine' => null,
]

3. Set the Database Connection Parameters for Artisan Command Line
One of the challenges that most developers face when working with migrations in Laravel 5.x.x from the artisan command line is the following message:

1
Access denied for user 'homestead'@' localhost' (using password: YES)

You will get the above message even you have set the correct parameters in /config/database.php file, because the artisan command line uses the database connection parameters specified in .env file.

The solutions is go to the project open up /.env file and modify to the following:

.env
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
APP_NAME=Laravel
APP_ENV=local
APP_KEY=base64:n8KivGzDCuNX1SljFb8xxQxBOPquewnAQIBa0H81nR8=
APP_DEBUG=true
APP_LOG_LEVEL=debug
APP_URL=http://localhost

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=foodie
DB_USERNAME=root
DB_PASSWORD=

BROADCAST_DRIVER=log
CACHE_DRIVER=file
SESSION_DRIVER=file
QUEUE_DRIVER=sync

REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379

MAIL_DRIVER=smtp
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null

PUSHER_APP_ID=
PUSHER_APP_KEY=
PUSHER_APP_SECRET=

The database, username and password must match the ones on your system.

Artisan Migration Command

We will create:
1. The migration table in our database.
2. A migration file that we will use to create a table for hard drinks.

When you create a migration file, Laravel will stores it in /database/migrations folder. You can specify a different path if you would like to but we won’t cover that in this articles. We will work with the default path.

Create Migration Table
Open up the terminator and run the following artisan command to create a migration table:

1
php artisan make:migration create_drinks_table

php artisan make:migration executes the make migration method via the artisan command.
create_drinks_table specifies the name of the migration file that will be created.

You will get the following results:

1
Created Migration: 2017_08_08_072434_create_drinks_table

Migration Structure

You will get the following file with the contents below:

20170808072434createdrinkstable.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
<?php

use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class CreateDrinksTable extends Migration {
  public function up() {
    //
  }

  public function down() {
    //
  }
}

- class CreateDrinksTable extends Migration defines the CreateDrinksTable class that extends Migration class. - public function up() defines the function that is executed when the migration is run.
- public function down() defines the function that is executed when you run migration rollback.

How to Create a Table Using a Migration

Now that we have successfully created a migration file, we will add the table definition fields in the migration modify the contents of /database/migrations/20170808072434createdrinkstable.php file.

20170808072434createdrinkstable.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
<?php
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class CreateDrinksTable extends Migration {
  /**
  * Run the migrations.
  *
  * @return void
  */
  public function up() {
    Schema::create('drinks', function (Blueprint $table) {
      $table->increments('id');
      $table->string('name', 75)->unique();
      $table->text('comments')->nullable();
      $table->integer('rating');
      $table->date('brew_date');

      $table->timestamps();
    });
  }

  /**
  * Reverse the migrations.
  *
  * @return void
  */
  public function down() {
    Schema::drop('drinks');
  }
}

- Schema::create('drinks', function (Blueprint $table) {...} calls the create function of the Schema class. The create function is responsible for creating the database table.
- (Blueprint $table) is a closure function with a $table parameter.
- $table parameter is used to define the structure of the database.
- $table->increments('id'); increments is used to define an auto increment field.
- $table->string('name', 75)->unique(); string is used to define varchar fields. The second parameter is the length of the field. ->unique() is used to mark the column as unique.
- $table->text('comments')->nullable(); is used to define text fields. ->nullable() is used to allow the column to accept null values.
- $table->integer('rating'); integer is used to define int fields.
- $table->date('brew_date'); is used to define date fields.
- $table->timestamps(); is used to automatically create two time stamp fields namely created_at and updated_at.

Go back to the terminator and run the command below:

1
php artisan migrate

And then you will get many tables drinks and users, password_resets which Laravel has migrated those two tables by defaults.

Laravel Migration Rollback

One of the advantages of migrations is that it allow you to roll back to the previous state before you run the migrations. In this section, we will roll back the creation of the tables.

Go back to the terminator and run the command below:

1
php artisan migrate:rollback

And then you will get the following output:

1
2
3
Rolled back: 2017_08_08_000000_create_users_table.php
Rolled back: 2017_08_08_100000_create_password_resets_table.php
Rolled back: 2017_08_08_090421_create_drinks_table.php

Laravel Migration How-tos

This section I will show how to perform various Laravel migration tasks.

Laravel Migration Insert Data
This “how-to” shows you how to create a migration file that inserts data into the newly created table. We will create an employees table and add 33 seed records using Faker Library.

Open up the terminator and run the command below:

1
php artisan make:migration employees

Open up /database/migrations/xxxxxxxxx_employees.php file and add the following codes:

xxxxxxxxx_employees.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
<?php

use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class Employees extends Migration
{
  /**
   * Run the migrations.
   *
   * @return void
   */
  public function up() {
    Schema::create('employees', function (Blueprint $table) {
      $table->increments('id');
      $table->string('name');
      $table->string('email')->unique();
      $table->string('contact_number');
      $table->timestamps();
    });

    $faker = Faker\Factory::create();

    $limit = 33;

    for($i = 0; $i < $limit; $i++) {
      DB::table('employees')->insert([ //,
        'name' => $faker->name,
        'email' => $faker->unique()->email,
        'contact_number' => $faker->phoneNumber,
      ]);
    }
  }

  /**
   * Reverse the migrations.
   *
   * @return void
   */
  public function down() {
    Schema::drop('employees');
  }
}

$faker = Faker\Factory::create(); creates an instance of Faker factory.
$limit = 33; sets the number of records that we want to add to the database.
for($i = 0; $i < $limit; $i++) { DB::table(‘employees’)–>insert(…); } uses a for loop to add records to the database 33 times. $faker->name generates a faker name. $faker->unique()–>email generates a fake unique email address. $faker->phoneNumber generates a fake phone number.

Open up the terminator and run the following command to run the migration:

1
php artisan migration

Laravel Migration Add Column/Drop Colum
We will add a new gender column to employees table.

Open up the terminator and run the following command:

1
php artisan make:migration add_gender_to_employees table=employees

—table=employees tells Laravel we want to work with an existing table called employees.

Open up /database/migration/xxxxxxx_add_gender_to_employees.php and modify to the following:

xxxxxxx_add_gender_to_employees.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
<?php

use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class AddGenderToEmployees extends Migration
{
  /
   * Run the migrations.
   
   * @return void
   /
  public function up() {
    Schema::table('employees', function (Blueprint $table) {
      $table–>string('gender')–>after('contact_number');
    });
  }

  /
   * Reverse the migrations.
   
   * @return void
   /
  public function down() {
    Schema::table('employees', function (Blueprint $table) {
      $table–>dropColumn('gender');
    });
  }
}

public function up() {…} uses Schema::table(‘employees’ …) to add a new column gender.
public function down() {…} drops the new column from the table when we reverse the command. $table->dropColumn(‘gender’); is the command that drops the table.

Laravel Migration Change Column Type

We have created the gender column with the default size of 255. We want to change it to 5 as the maximum size.

Open up the terminator and run the following command:

1
php artisan make:migration modify_gender_in_employees table=employees

Open up /database/migrations/xxxxxxx_modify_gender_in_employees.php file and modify to the following:

xxxxxxx_modify_gender_in_employees.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
<?php

use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class ModifyGenderInEmployees extends Migration {
  /
   * Run the migrations.
   
   * @return void
   /
  public function up()
  {
    Schema::table('employees', function(Blueprint $table) {
      $table–>string('gender', 5)–>change();
    });
  }

  /
   * Reverse the migrations.
   
   * @return void
   /
  public function down() {
    Schema::table('employees', function(Blueprint $table) {
      $table–>string('gender', 255)–>change();
    });
  }
}

$table->string(‘gender’, 5)–>change(); maintains the varchar data type and sets the character limit to 5. If we wanted to change the data type too, we would have specified a different data type.
$table->string(‘gender’, 255)–>change(); rollback the migration to the previous state.

Open up the terminator and run the following command to run the migration:

1
php artisan migrate

Laravel Migration Nullable
By default, Laravel assumes all columns are required unless you tell it so let’s assume the gender field is optional.

Open up the terminator and run the following command to create a migration file:

1
php artisan make:migration make_gender_null_in_employees tableemployees

Open up /database/migrations/xxxxxxx_make_gender_null_in_employees.php file and modify to the following:

xxxxxxx_make_gender_null_in_employees.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
<?php

use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class MakeGenderNullInEmployees extends Migration {
  /
   * Run the migrations.
   
   * @return void
   /
  public function up() {
    Schema::table('employees', function(Blueprint $table) {
      $table–>string('gender', 5)–>nullable()–>change();
    });
  }

  /
   * Reverse the migrations.
   
   * @return void
   /
  public function down() {
    Schema::table('employees', function(Blueprint $table) {
      $table–>string('gender', 5)–>change();
    });
  }
}

Laravel Migration Foreign Key
Let’s say we want to group our employees by their departments, we can add a foreign key for the dept_id.

Open up the terminator and run the following command to create a migration file for depts table:

1
php artisan make:migration depts

Open up /database/migrations/xxxxxxxxx_depts.php file and add the following codes:

xxxxxxxxx_depts.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
<?php

use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class Depts extends Migration
{
  /
   * Run the migrations.
   
   * @return void
   /
  public function up() {
    Schema::create('depts', function(Blueprint $table) {
      $table–>increments('id');
      $table–>string('name');
      $table–>timestamps();
    });
  }

  /
   * Reverse the migrations.
   
   * @return void
   /
  public function down() {
    Schema::drop('depts');
  }
}

Open up the terminator and run the following command to create the depts table:

1
php artisan migrate

The primary and foreign key relationship requires both tables to have the same data type and length. We used Schema’s increments to define the primary key for depts id. Schema’s increments creates an unsigned integer INT(10), Schema’s integer creates signed integer INT(11).

We need to use Schema’s unsignedInteger when creating dept_id so that both the primary and foreign keys will be INT(10).

Open up the terminator and run the following command to create the migration for adding the dept_id to the employees table:

1
php artisan make:migration add_dept_id_in_employees table=employees

Open up /database/migrations/xxxxxxxxx_add_dept_id_in_employees.php file and add the following codes:

xxxxxxxxx_add_dept_id_in_employees.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
<?php

use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class AddDeptIdInEmployees extends Migration {
  /
   * Run the migrations.
   
   * @return void
   /
  public function up() {
    Schema::table('employees', function (Blueprint $table) {
      $table–> unsignedInteger ('dept_id')–>after('gender');
      $table–>foreign('dept_id')
              –>references('id')–>on('depts')
              –>onDelete('cascade');
    });
  }

  /
   * Reverse the migrations.
   
   * @return void
   /
  public function down() {
    Schema::table('employees', function (Blueprint $table) {
      $table–>dropColumn('dept_id');
    });
  }
}

Open up the terminator and run the following command to execute the migration:

1
php artisan migrate

Database Seeding

In this section, we will add dummy data to our database. Seeding is a term that is used to describe the process of adding data to the database.

Open up the terminator and run the following command:

1
php artisan make:seeder DrinksTableSeeder

Open up /database/seeds/DrinksTableSeeder.php file and add the following codes:

DrinksTableSeeder.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
<?php

use Illuminate\Database\Seeder;

class DrinksTableSeeder extends Seeder {

  /
   * Run the database seeds.
   
   * @return void
   /
  public function run() {
    DB::table('drinks')–>insert([
      'name' => 'Vodka',
      'comments' => 'Blood of creativity',
      'rating' => 9,
      'brew_date' => '1973-09-03',
    ]);
  }
}

class DrinksTableSeeder extends Seeder defines the table DrinksTableSeeder that extends the Seeder class.
public function run() defines the function that is executed when you run the seed command from artisan.

The above table uses an array that matches database field name to values and inserts the record into the specified table drinks. Now let’s run the seed and add our dummy record to the database.

Open up the terminator and run the following command:

1
php artisan db:seed class=DrinksTableSeeder

Laravel 5.x.x Template

Laravel 5.x.x Template

Blade is a powerful easy to use template that comes with Laravel. Blade templates can be mixed with plain php code.

Well, in this articles I will cover the following sections: Template inheritance, Master layout, Extending the master layout, Displaying variables, Blade conditional statements, Blade Loops and Executing PHP functions in blade template.

Template Inheritance
In a nutshell, template inheritance allows us to define a master layout with elements that are common to all web pages. The individual pages extend the master layout. This saves us time of repeating the same elements in the individual pages.

Master Layout
All blade templates must be saved with the .blade extension. In this section, we are going to create a master template that all pages will extend. The following is the syntax for defining a master layout.

Create a new file named master.blade.php in /resources/views/layouts folder with the following code below:

master.blade.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
<html>
  <head>
    <title>@yield('title')</title>
  </head>
  <body>
    @section('sidebar')
      Here is the master sidebar.
    @show

    <div class="container">
      @yield('content')
    </div>
  </body>
</html>

- @yield('title') is used to display the value of the title.
- @section('sidebar') is used to define a section named sidebar.
- @show is used to display the contents of a section.
- @yield('content') is used to display the contents of content.

Extending the Master Layout
Now we will create a page that extends the master layout. Create a new page named page.blade.php in /resources/views folder with the following code below:

page.blade.php
1
2
3
4
5
6
7
8
9
10
11
@extends('layouts.master')

@section('title', 'Page Title')

@section('sidebar')
  <p>Here is appended to the master sidebar.</p>
@endsection

@section('content')
  <p>Here is my body content.</p>
@endsection

- @extends('layouts.master') is used to extends the master layout.
- @section('title', 'Page Title') is used to sets the value of the title section.
- @section('sidebar') is used to defines a sidebar section in the child page of master layout.
- @endsection is used to ends the sidebar section.
- @section('content') is used to defines the content section.

And now we will add a route to tests our blade template. Open up /routes/web.php file and add the following route below:

web.php
1
2
3
Route::get('blade', function () {
  return view('page');
});

Load the http:://localhost:8000/blade URL in your web browser and you will see the paragraph.

Displaying Variables in a Blade Template
Now we will define a variable and pass it to our blade template view. Open up /routes/web.php file and add the route below:

web.php
1
2
3
Route::get('blade', function () {
  return view('page',array('name' => 'The Foodie'));
});

And then update pages.blade.php file to display the variable. Open up page.blade.php file and update the contents to the following:

page.blade.php
1
2
3
4
5
6
7
8
9
10
11
@extends('layouts.master')

@section('title', 'Page Title')

@section('sidebar')
  <p>Here is appended to the master sidebar.</p>
@endsection
@section('content')
  <h2></h2>
  <p>Here is my body content.</p>
@endsection

{{$name}} double opening curly braces and double closing curly braces are used to display the value of $name variable.

Blade Condition Statements
Blade also supports conditional statements. Conditional statements are used to determine what to display in the browser. We will pass a variable that will determine what to display in the browser.

Open up /routes/web.php file and modify route as follow:

web.php
1
2
3
Route::get('blade', function () {
  return view('page', array('name' => 'The Foodie', 'day' => 'Sunday'));
});

We added another variable day with a value of Sunday.

And then open up /resources/views/page.blade.php file and modify the codes to the following:

page.blade.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
@extends('layouts.master')

@section('title', 'Page Title')

@section('sidebar')
  <p>Here is appended to the master sidebar.</p>
@endsection

@section('content')
  <h2></h2>
  <p>Here is my body content.</p>
  <h2>If Statement</h2>
  @if ($day == 'Sunday')
    <p>Time to party</p>
  @else
    <p>Time to make money</p>
  @endif
@endsection

- @if ($day == 'Sunday') starts the if statement and evaluates the condition $day == ‘Sunday’.
- @else is the else part of the if statement.
- @endif ends the if statement.

Blade Loop
Blade template supports all of the loops that PHP supports. We will look at how we can use the foreach loop in blade to loop through an array of items.

Open up /routes/web.php file and modify the codes for the blade route to the following:

web.php
1
2
3
4
Route::get('blade', function () {
  $drinks = array('Vodka', 'Gin', 'Brandy');
  return view('page', array('name' => 'The Foodie','day' => 'Sunday', 'drinks' => $drinks));
});

$drinks = array('Vodka', 'Gin', 'Brandy'); defines an array variable that we are passing to the blade template.

And then open up /resources/views/page.blade.php file and modify the contents to the following:

page.blade.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
@extends('layouts.master')

@section('title', 'Page Title')

@section('sidebar')
  <p>Here is appended to the master sidebar.</p>
@endsection

@section('content')
  <h2></h2>
  <p>Here is my body content.</p>
  <h2>If Statement</h2>
  @if ($day == 'Sunday')
    <p>Time to party</p>
  @else
    <p>Time to make money</p>
  @endif
  <h2>Foreach Loop</h2>
  @foreach ($drinks as $drink)
    <p></p>
  @endforeach
@endsection

Executing php functions in Blade
We will call the php date function in the blade template. Open up /resources/views/page.blade.php file and modify the contents to the following:

page.blade.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
@extends('layouts.master')

@section('title', 'Page Title')

@section('sidebar')
  <p>Here is appended to the master sidebar.</p>
@endsection

@section('content')
  <h2></h2>
  <p>Here is my body content.</p>
  <h2>If Statement</h2>
  @if ($day == 'Sunday')
    <p>Time to party</p>
  @else
    <p>Time to make money</p>
  @endif
  <h2>Foreach Loop</h2>
  @foreach ($drinks as $drink)
    <p></p>
  @endforeach

  <h2>Execute PHP Function</h2>
  <p>The date is </p>
@endsection

{{date(' D M, Y')}} double opening and closing curly braces are used to execute the php date function.