Working with React.js Class Components

React.js is a first class JavaScript library for building front-end for the modern web applications. This library is based on a WebComponent concept. The WebComponent is an autonomous object which has it own UI, Data and logic (presenter). The React.js is makes use of this concept to implement <b>Compositional UI<b>.

In React.js, we can create components using 2 mechanisms, the first is Class Component and the second is Functional Components.     

Class Components, are the pure implementation of ES 6 class concept. The class component is derived from Component base class. This base class contains render() method to render the HTML UI. The class components defines local public properties. These properties represents State of the class component. The State, means the data that will be used by class component to manipulate local to component so that the the HTML UI can be rendered. 

Functional Components, are the JavaScript functions. These functions returns the HTML so that the UI will be rendered. While working with React.js applications, you can use either of the components. The functional components uses a concept of React.js Hooks to define state, making AJAX calls, etc. 

One important of the React.js library is that, it uses the concept of Virtual DOM. This means that, the DOM rendering is manipulated based on the State data bound with HTML elements. The DOM will be rendered in the browser based on the virtual DOM. If the data bound property of the HTML element is changed, then new Virtual DOM rendering will be compare with the previous Virtual DOM rendering and instead of re-rendering the whole DOM, only the updated data bound HTML will be patched into the rendering. This will provide a reactive UI generation for the front-end applications.       

Being compositional in nature, we can create re-usable components in React.js applications. This will help to divide the complex UI in small chunks of components and we can share these components across various projects in organisation or even we can share it to our customers. When we create and share re-usable components, we may need to pass data across components. We do this by using props or using context. So the question is what is the difference between State and Props.

State: This is an object that is scoped to the component. This object contains all properties those will be having their lifecycle within the component itself. Once the component is unloaded (aka unmounted), the state will be cleaned.

Props: This will be used to maintain the state of the data across components. The container / parent component can send data to child component using props. The props are shared in a hierarchy of all components in the React.js applications.  

In this post, I will demonstrate class components. The post contains code with component re-usability. we will create the React.js application using the React.js CLI. 

Step 1: Open Command prompt (Windows Command Prompt / Terminal Window in Mac or Linux) and run the following command to install React CLI

npm install -g create-react-app

Once the React CLI is installed, we can use it for creating React.js applications.

Step 2: On the command prompt, run the following command to create a new React project.

create-react-app my-react-app

The new application will be created with the folder name as the name of the application. Open the my-react-app folder in Visual Studio Code (VSCode).

Navigate to the project folder in the command prompt and run the following  command to install Bootstrap CSS framework so that we can use it in our application

npm install --save bootstrap

Step 3: In the project, we have the src  folder.  In this folder add a new folder and a new folder and name it as components. In this folder add a new file and name this file as dropdowncomponent.jsx. In this file we will add a class component. This class component will be used as reusable DropDown. In this file add a code as shown in the listing 1

import React, { Component } from 'react'
class DropDownComponent extends Component {
constructor(props) {
super(props);
this.state = { }
}
handleChange=(evt)=> {
// selectedValue is a method that will executed
// when the handleChange event is raised on current component
// the parent component must subscribe to 'selectedValue'
// using method
this.props.selectedValue(evt.target.value);
}
render() {
return (
<div className="container">
<select className="form-control"
                        value={this.props.data}
onChange={this.handleChange.bind(this)}>
<option>Select Value</option>
{
this.props.dataSource.map(
                            (v,i)=> (
<option key={i} value={v}>{v}
                            </option>
))
}
</select>
</div>
);
}
}
export default DropDownComponent;

Listing 1: The DropDownComponent

The DropDownComponent  class is derived from Component  base class. The constructor accepts the props parameter. This parameter will be used when the parent of this component pass any data to the DropDownComponent. Note that there is no state property declared for this component. The render() method returns <select> element.  This select element will generate <options>  based on the data passes to this component from its parent component using the dataSource property. Here in this case the dataSource property is a props type property. The handleChange() method is bound to the onChange event of the <select> element, so that when a value is chosen from the <select> element it will be emitted back to the parent component.  The code

this.props.selectedValue(evt.target.value);     

define the selectedValue props type. The parent component can read the selected value from the DropDownComponent by using the selectedValue props type.

Step 4: In the components folder add a new file and name this file as tablecomponent.jsx. In this component we will generate the HTML table element dynamically. Like DropDownComponent, the TableGridComponent is also a re-usable component. This will accept props type from its parent to generate the HTML table dynamically. In the tablecomponent.jsx file add the code as shown in listing 2

import React, { Component } from 'react'

class TableGridComponent extends Component {
constructor(props) {
super(props);
this.state = { }
}
handleRowClick=(row)=> {
this.props.selectRow(row);
}
render() {
// read rows from the dataSource
if(this.props.dataSource.length <= 0) {
return
                (<div>No Records in data source</div>)
} else {
let columns =[];
// read properties of the 0th index
//row from data Source
for(const c of Object.keys(this.props.dataSource[0])) {
columns.push(c);
}
return (
<div className="container">
<table
    className="table table-bordered table-striped">
<thead>
<tr>
{
columns.map((col,idx)=> (
<td key={idx}>{col}</td>
))
}
</tr>
</thead>
<tbody>
{
this.props.dataSource.map((row, index)=> (
<tr key={index} onClick={()=>this.handleRowClick(row)}>
{
columns.map((col,idx)=> (
<td key={idx}>{row[col]}</td>
))
}
</tr>
))
}
</tbody>
</table>
</div>
);
}
}
}
export default TableGridComponent;

Listing 2: The TableGridComponent  

The TableGridComponent reads the data from the dataSource props type and generate table headers and rows. The table row is bound with the handleRowClick() method using the onClick event. When the row is clicked the selected record which is bound with the Table row will be passed to the selectRow() props type so that the parent component can receive the selected value from the TableGridComponent.

Step 5: In the src folder add a new folder and name it as models. In this folder add a new file and name it as product.js. In this file add a code for Product class as shown in listing 3

export class Product {
constructor(){
this.ProductId = 0;
this.ProductName = '';
this.CategoryName = '';
this.Manufacturer = '',
this.Price = 0;
}
}

Listing 3: The Product Class  

Add one more file in the same folder and name it as constants.js. In this file we will define constant array as shown in listing 4

export const Categories = ['Electronics', 'Electrical', 'Food'];
export const Manufacturers = ['HP', 'IBM', 'Bajaj', 'TATA', 'Parle'];

Listing 4: The constants

Add one more file in the models folder and name it as logic.js. This file will contains a code for logic for Read/Write operations for Product. The code of the logic is provided in listing 5

export class Logic {
constructor(){
this.products = [
{ProductId:1, ProductName: 'Laptop',
CategoryName: 'Electroics', Manufacturer: 'HP',
Price:200000},
{ProductId:2, ProductName: 'Iron',
CategoryName: 'Electrical', Manufacturer: 'Bajaj',
Price:2000},
{ProductId:3, ProductName: 'Biscuts',
CategoryName: 'Food',
Manufacturer: 'Parle', Price:20},
{ProductId:4, ProductName: 'Router',
\CategoryName: 'Electroics', Manufacturer: 'IBM',
Price:5000},
{ProductId:5, ProductName: 'Mixer',
CategoryName: 'Electrical', Manufacturer: 'TATA',
Price:2000},
{ProductId:6, ProductName: 'Lays',
CategoryName: 'Food', Manufacturer: 'Parle',
Price:1000}
];
}

getProducts(){
return this.products;
}
saveProduct(prd) {
this.products.push(prd);
return this.products;
}
}

Listing 5: The Logic class 

Step 6: In the components folder add a new file and name it as productformcomponent.jsx. In this flde we will create a ProductFormComponent. This component will use DropDownComponent and TableGridComponent and also the logic class. Add the code in this file as shown in listing 6

import React, { Component } from 'react'
import DropDownComponent from './dropdoencomponent';
import TableGridComponent from './tablecomponent';
import {Categories, Manufacturers} from './../mdoels/constants';
import { Logic} from './../../mdoels/logic';
class ProductFormComponent extends Component {
constructor(props) {
super(props);
this.state = {
ProductId:0,
ProductName: '',
CategoryName: '',
Manufacturer: '',
Price: 0,
categories: Categories,
manufacturers: Manufacturers,
products: [{ProductId:1, ProductName: 'Laptop', CategoryName: 'Electroics', Manufacturer: 'HP', Price:200000},
{ProductId:2, ProductName: 'Iron', CategoryName: 'Electrical', Manufacturer: 'Bajaj', Price:2000},
{ProductId:3, ProductName: 'Biscuts', CategoryName: 'Food', Manufacturer: 'Parle', Price:20},
{ProductId:4, ProductName: 'Router', CategoryName: 'Electroics', Manufacturer: 'IBM', Price:5000},
{ProductId:5, ProductName: 'Mixer', CategoryName: 'Electrical', Manufacturer: 'TATA', Price:2000},
{ProductId:6, ProductName: 'Las', CategoryName: 'Food', Manufacturer: 'Parle', Price:1000}],
manufacturersData:[
{Id:1001, Name: 'Microsoft'}, {Id:102,Name:'Oracle'}
]

};
this.logic = new Logic();
}
// when an event is raised on UI element
// the state property wll be updated based on name of the UI element
// the matches with the state property name
handleChange =(evt)=> {
// update the state property
this.setState({[evt.target.name]: evt.target.value});
}
clear =()=> {
this.setState({ProductId:0});
this.setState({ProductName:''});
this.setState({CategoryName:''});
this.setState({Manufacturer:''});
this.setState({Price:0});

}
getCategory=(val)=> {
this.setState({CategoryName: val}, ()=> {});
}
getManufacturer=(val)=> {
this.setState({Manufacturer: val}, ()=>{});
}
getSelectedRow=(prd)=>{
this.setState({ProductId:prd.ProductId});
this.setState({ProductName:prd.ProductName});
this.setState({CategoryName:prd.CategoryName});
this.setState({Manufacturer:prd.Manufacturer});
this.setState({Price:prd.Price});
}
save=()=> {
let prd = {
ProductId: this.state.ProductId,
ProductName: this.state.ProductName,
CategoryName: this.state.CategoryName,
Manufacturer: this.state.Manufacturer,
Price: this.state.Price
};
// define a temp array having same structire of the products array in state

let tempProduct = this.state.products.slice();
// push data in temp array
tempProduct.push(prd);
// update the products state
this.setState({products: tempProduct}, ()=>{});
alert(JSON.stringify(this.state.products));
}
render() {
return (
<div className="container">
<form name="frmProduct">
<div className="form-group">
<label>Product Id</label>
<input type="text"
className="form-control" value={this.state.ProductId}
name="ProductId"
required={true}
onChange={this.handleChange.bind(this)}/>
</div>
<div className="form-group">
<label>Product Name</label>
<input type="text"
className="form-control"
name="ProductName"
onChange={this.handleChange.bind(this)}
value={this.state.ProductName}/>
</div>
<div className="form-group">
<label>Category Name</label>
<DropDownComponent
dataSource={this.state.categories}
data={this.state.CategoryName}
selectedValue={this.getCategory.bind(this)}></DropDownComponent>
</div>
<div className="form-group">
<label>Manufacturer</label>
<DropDownComponent
dataSource={this.state.manufacturers}
data={this.state.Manufacturer}
selectedValue={this.getManufacturer.bind(this)}></DropDownComponent>
</div>
<div className="form-group">
<label>Price</label>
<input type="text"
className="form-control"
name="Price"
onChange={this.handleChange.bind(this)}
value={this.state.Price}/>
</div>
<div className="form-group">
<input
type="button" value="Clear" className="btn btn-warning" onClick={this.clear.bind(this)}/>
<input
type="button" value="Save" className="btn btn-success" onClick={this.save.bind(this)}/>
</div>
</form>
<br/>
<TableGridComponent
dataSource={this.state.products}
selectRow={this.getSelectedRow.bind(this)}
></TableGridComponent>
</div>
);
}
}
export default ProductFormComponent;

Listing 6: The ProductComponent class   

The ProductFormComponent defines the state properties for Product information, categories, manufacturers and products. The component contains methods clear(), save() to clear all HTML input elements and save product data. The getCategory() and getManufactuer() methods are bound to DropDwonCompoent used in render() method. This component is used twice in the ProductFormComponent to show categories and manufacturers arrays passed to this component using the dataSource props type. The selected category and manufacturer  will be received by the ProductFormComponent using  the getCategory() and getManufactuer() methods.  The TableGridComponent accepts products data using the dataSource props type to render the HTML table to show products data. The Save and Clear buttons are bound to save() and clear() methods using its onClick event.

So, if you have notices that, we have design a React component that re-uses the other React  components in it and hence we can say that React.js is compositional in nature.

Step 7: Modify index.js to run the ProductFormComponent and also load the bootstrap.css as shown in listing 7

import React from 'react';
import ReactDOM from 'react-dom';
import './index.css';
import './../node_modules/bootstrap/dist/css/bootstrap.min.css';
import ProductFormComponent from './components/productcomponent/productformcomponent';

Listing 7: Index.js   

Run the application using following command  

npm run start

The browser will be opened with an address in address bar as http://localhost:3000

The browse will render the ProductFormComponent as show in image 1



Image 1: The ProductFormComponent  

Conclusion: React.js compositional nature allows us to create re-usable components. The class components provides a simple Object-Oriented-Programming like experience to create a React front-end application with an experience like server side programming. 

Popular posts from this blog

Uploading Excel File to ASP.NET Core 6 application to save data from Excel to SQL Server Database

ASP.NET Core 6: Downloading Files from the Server

ASP.NET Core 6: Using Entity Framework Core with Oracle Database with Code-First Approach