React Patterns:
React Cheat Sheet
See More
Components
//ximport React from 'react';import ReactDOM from 'react-dom';
//xclass Hello extends React.Component {render() {return <div className="message-box">Hello {this.props.name}</div>;}}
const el = document.body
ReactDOM.render(<Hello name='John' />, el)
Use the React.js jsfiddle to start hacking. (or the unofficial jsbin)
Import multiple exports
import React, {Component} from 'react'
import ReactDOM from 'react-dom'
class Hello extends Component {
...
}
Properties
<Video fullscreen={true} autoplay={false} />
render () {
this.props.fullscreen
const { fullscreen, autoplay } = this.props
···
}
Use this.props
to access properties passed to the component.
See: Properties
States
constructor(props) {
super(props)
this.state = { username: undefined }
}
this.setState({ username: 'rstacruz' })
render () {
this.state.username
const { username } = this.state
···
}
Use states (this.state
) to manage dynamic data.
With Babel you can use proposal-class-fields and get rid of constructor
class Hello extends Component {
state = { username: undefined };
...
}
See: States
Nesting
class Info extends Component {
render () {
const { avatar, username } = this.props
return <div>
<UserAvatar src={avatar} />
<UserProfile username={username} />
</div>
}
}
As of React v16.2.0, fragments can be used to return multiple children without adding extra wrapping nodes to the DOM.
import React, {
Component,
Fragment
} from 'react'
class Info extends Component {
render () {
const { avatar, username } = this.props
return (
<Fragment>
<UserAvatar src={avatar} />
<UserProfile username={username} />
</Fragment>
)
}
}
Nest components to separate concerns.
See: Composing Components
Children
<AlertBox>
<h1>You have pending notifications</h1>
</AlertBox>
class AlertBox extends Component {
render () {
return <div className='alert-box'>
{this.props.children}
</div>
}
}
Children are passed as the children
property.
#Defaults
Setting default props
Hello.defaultProps = {
color: 'blue'
}
See: defaultProps
Setting default state
class Hello extends Component {
constructor (props) {
super(props)
this.state = { visible: true }
}
}
Set the default state in the constructor()
.
And without constructor using Babel with proposal-class-fields.
class Hello extends Component {
state = { visible: true }
}
See: Setting the default state
#Other components
Functional components
function MyComponent ({ name }) {
return <div className='message-box'>
Hello {name}
</div>
}
Functional components have no state. Also, their props
are passed as the first parameter to a function.
See: Function and Class Components
Pure components
import React, {PureComponent} from 'react'
class MessageBox extends PureComponent {
···
}
Performance-optimized version of React.Component
. Doesn't rerender if props/state hasn't changed.
See: Pure components
Component API
this.forceUpdate()
this.setState({ ... })
this.setState(state => { ... })
this.state
this.props
These methods and properties are available for Component
instances.
See: Component API
#Lifecycle
Mounting
Method | Description |
---|---|
constructor (props) | Before rendering # |
componentWillMount() | Don't use this # |
render() | Render # |
componentDidMount() | After rendering (DOM available) # |
componentWillUnmount() | Before DOM removal # |
componentDidCatch() | Catch errors (16+) # |
Set initial the state on constructor()
. Add DOM event handlers, timers (etc) on componentDidMount()
, then remove them on componentWillUnmount()
.
Updating
Method | Description |
---|---|
componentDidUpdate (prevProps, prevState, snapshot) | Use setState() here, but remember to compare props |
shouldComponentUpdate (newProps, newState) | Skips render() if returns false |
render() | Render |
componentDidUpdate (prevProps, prevState) | Operate on the DOM here |
Called when parents change properties and .setState()
. These are not called for initial renders.
See: Component specs
#Hooks (New)
State Hook
import React, { useState } from 'react';
function Example() {
// Declare a new state variable, which we'll call "count"
const [count, setCount] = useState(0);
return (
<div>
<p>You clicked {count} times</p>
<button onClick={() => setCount(count + 1)}>
Click me
</button>
</div>
);
}
Hooks are a new addition in React 16.8.
See: Hooks at a Glance
Declaring multiple state variables
function ExampleWithManyStates() {
// Declare multiple state variables!
const [age, setAge] = useState(42);
const [fruit, setFruit] = useState('banana');
const [todos, setTodos] = useState([{ text: 'Learn Hooks' }]);
// ...
}
Effect hook
import React, { useState, useEffect } from 'react';
function Example() {
const [count, setCount] = useState(0);
// Similar to componentDidMount and componentDidUpdate:
useEffect(() => {
// Update the document title using the browser API
document.title = `You clicked ${count} times`;
}, [count]);
return (
<div>
<p>You clicked {count} times</p>
<button onClick={() => setCount(count + 1)}>
Click me
</button>
</div>
);
}
If you're familiar with React class lifecycle methods, you can think of useEffect
Hook as componentDidMount
, componentDidUpdate
, and componentWillUnmount
combined.
By default, React runs the effects after every render — including the first render.
Building your own hooks
Define FriendStatus
import React, { useState, useEffect } from 'react';
function FriendStatus(props) {
const [isOnline, setIsOnline] = useState(null);
useEffect(() => {
function handleStatusChange(status) {
setIsOnline(status.isOnline);
}
ChatAPI.subscribeToFriendStatus(props.friend.id, handleStatusChange);
return () => {
ChatAPI.unsubscribeFromFriendStatus(props.friend.id, handleStatusChange);
};
}, [props.friend.id]);
if (isOnline === null) {
return 'Loading...';
}
return isOnline ? 'Online' : 'Offline';
}
Effects may also optionally specify how to “clean up” after them by returning a function.
Use FriendStatus
function FriendStatus(props) {
const isOnline = useFriendStatus(props.friend.id);
if (isOnline === null) {
return 'Loading...';
}
return isOnline ? 'Online' : 'Offline';
}
Hooks API Reference
Also see: Hooks FAQ
Basic Hooks
Hook | Description |
---|---|
useState (initialState) | |
useEffect (() => { … }) | |
useContext (MyContext) | value returned from React.createContext |
Full details: Basic Hooks
Additional Hooks
Hook | Description |
---|---|
useReducer (reducer, initialArg, init) | |
useCallback (() => { … }) | |
useMemo (() => { … }) | |
useRef (initialValue) | |
useImperativeHandle (ref, () => { … }) | |
useLayoutEffect | identical to useEffect , but it fires synchronously after all DOM mutations |
useDebugValue (value) | display a label for custom hooks in React DevTools |
Full details: Additional Hooks
#DOM nodes
References
class MyComponent extends Component {
render () {
return <div>
<input ref={el => this.input = el} />
</div>
}
componentDidMount () {
this.input.focus()
}
}
Allows access to DOM nodes.
See: Refs and the DOM
DOM Events
class MyComponent extends Component {
render () {
<input type="text"
value={this.state.value}
onChange={event => this.onChange(event)} />
}
onChange (event) {
this.setState({ value: event.target.value })
}
}
Pass functions to attributes like onChange
.
See: Events
#Other features
Transferring props
<VideoPlayer src="video.mp4" />
class VideoPlayer extends Component {
render () {
return <VideoEmbed {...this.props} />
}
}
Propagates src="..."
down to the sub-component.
Top-level API
React.createClass({ ... })
React.isValidElement(c)
ReactDOM.render(<Component />, domnode, [callback])
ReactDOM.unmountComponentAtNode(domnode)
ReactDOMServer.renderToString(<Component />)
ReactDOMServer.renderToStaticMarkup(<Component />)
There are more, but these are most common.
See: React top-level API
#JSX patterns
Style shorthand
const style = { height: 10 }
return <div style={style}>
</div>
return <div style={{ margin: 0, padding: 0 }}>
</div>
See: Inline styles
Inner HTML
function markdownify() { return "<p>...</p>"; }
<div dangerouslySetInnerHTML={{__html: markdownify()}} />
See: Dangerously set innerHTML
Lists
class TodoList extends Component {
render () {
const { items } = this.props
return <ul>
{items.map(item =>
<TodoItem item={item} key={item.key} />)}
</ul>
}
}
Always supply a key
property.
Conditionals
<Fragment>
{showMyComponent
? <MyComponent />
: <OtherComponent />}
</Fragment>
Short-circuit evaluation
<Fragment>
{showPopup && <Popup />}
...
</Fragment>
#New features
Returning multiple elements
You can return multiple elements as arrays or fragments.
Arrays
render () {
// Don't forget the keys!
return [
<li key="A">First item</li>,
<li key="B">Second item</li>
]
}
Fragments
render () {
// Fragments don't require keys!
return (
<Fragment>
<li>First item</li>
<li>Second item</li>
</Fragment>
)
}
Returning strings
render() {
return 'Look ma, no spans!';
}
You can return just a string.
Errors
class MyComponent extends Component {
···
componentDidCatch (error, info) {
this.setState({ error })
}
}
Catch errors via componentDidCatch
. (React 16+)
See: Error handling in React 16
Portals
render () {
return React.createPortal(
this.props.children,
document.getElementById('menu')
)
}
This renders this.props.children
into any location in the DOM.
See: Portals
Hydration
const el = document.getElementById('app')
ReactDOM.hydrate(<App />, el)
Use ReactDOM.hydrate
instead of using ReactDOM.render
if you're rendering over the output of ReactDOMServer.
See: Hydrate
#Property validation
PropTypes
import PropTypes from 'prop-types'
See: Typechecking with PropTypes
Key | Description |
---|---|
any | Anything |
Basic
Key | Description |
---|---|
string | |
number | |
func | Function |
bool | True or false |
Enum
Key | Description |
---|---|
oneOf (any) | Enum types |
oneOfType (type array) | Union |
Array
Key | Description |
---|---|
array | |
arrayOf (…) |
Object
Key | Description |
---|---|
object | |
objectOf (…) | Object with values of a certain type |
instanceOf (…) | Instance of a class |
shape (…) |
Elements
Key | Description |
---|---|
element | React element |
node | DOM node |
Required
Key | Description |
---|---|
(···).isRequired | Required |
Basic types
MyComponent.propTypes = {
email: PropTypes.string,
seats: PropTypes.number,
callback: PropTypes.func,
isClosed: PropTypes.bool,
any: PropTypes.any
}
Required types
MyCo.propTypes = {
name: PropTypes.string.isRequired
}
Elements
MyCo.propTypes = {
// React element
element: PropTypes.element,
// num, string, element, or an array of those
node: PropTypes.node
}
Enumerables (oneOf)
MyCo.propTypes = {
direction: PropTypes.oneOf([
'left', 'right'
])
}
Arrays and objects
MyCo.propTypes = {
list: PropTypes.array,
ages: PropTypes.arrayOf(PropTypes.number),
user: PropTypes.object,
user: PropTypes.objectOf(PropTypes.number),
message: PropTypes.instanceOf(Message)
}
MyCo.propTypes = {
user: PropTypes.shape({
name: PropTypes.string,
age: PropTypes.number
})
}
Use .array[Of]
, .object[Of]
, .instanceOf
, .shape
.
Custom validation
MyCo.propTypes = {
customProp: (props, key, componentName) => {
if (!/matchme/.test(props[key])) {
return new Error('Validation failed!')
}
}
}
React:
<script src="https://unpkg.com/react@15/dist/react.js"> </script>
$ npm install react --save
$ bower install react --save
React DOM:
<script src="https://unpkg.com/react-dom@15/dist/react-dom.js"> </script>
$ npm install react-dom
$ bower install react-dom --save
Rendering
Rendering (ES5)
//
ReactDOM.render(React.createElement(Link, { name: 'HackHall.com' }), document.getElementById('menu'));
Rendering (ES5+JSX)
//
ReactDOM.render(<Link name="HackHall.com" />, document.getElementById('menu'));
Server-side Rendering
//var ReactDOMServer = require('react-dom/server');
ReactDOMServer.renderToString(Link, { name: 'HackHall.com' });
ReactDOMServer.renderToStaticMarkup(Link, { name: 'HackHall.com' });
Components
ES5
//var Link = React.createClass({displayName: 'Link',render: function () {return React.createElement('a', { className: 'btn', title: this.props.name }, 'Click ->', this.props.name);}});
ES5 + JSX
//var Link = React.createClass({render: function () {return (<a className="btn" title={this.props.name}>
Click -> this.props.name
</a>);}});
ES6 + JSX
//class Link extends React.Component {render() {return (<a className="btn" title={this.props.name}>
Click -> this.props.name
</a>);}}
npm install --save react // declarative and flexible JavaScript library for building UI
npm install --save react-dom // serves as the entry point of the DOM-related rendering paths
npm install --save prop-types // runtime type checking for React props and similar objects
// notes: don't forget the command lines
///* *******************************************************************************************
* REACT
* https://reactjs.org/docs/react-api.html
* ******************************************************************************************* */// Create and return a new React element of the given type.// Code written with JSX will be converted to use React.createElement().// You will not typically invoke React.createElement() directly if you are using JSX.
React.createElement(
type,[props],[...children])// Clone and return a new React element using element as the starting point.// The resulting element will have the original element's props with the new props merged in shallowly.
React.cloneElement(
element,[props],[...children])// Verifies the object is a React element. Returns true or false.
React.isValidElement(object)
React.Children // provides utilities for dealing with the this.props.children opaque data structure.// Invokes a function on every immediate child contained within children with this set to thisArg.
React.Children.map(children, function[(thisArg)])// Like React.Children.map() but does not return an array.
React.Children.forEach(children, function[(thisArg)])// Returns the total number of components in children,// equal to the number of times that a callback passed to map or forEach would be invoked.
React.Children.count(children)// Verifies that children has only one child (a React element) and returns it.// Otherwise this method throws an error.
React.Children.only(children)// Returns the children opaque data structure as a flat array with keys assigned to each child.// Useful if you want to manipulate collections of children in your render methods,// especially if you want to reorder or slice this.props.children before passing it down.
React.Children.toArray(children)// The React.Fragment component lets you return multiple elements in a render() method without creating an additional DOM element// You can also use it with the shorthand <></> syntax.
React.Fragment
/* *******************************************************************************************
* REACT.COMPONENT
* React.Component is an abstract base class, so it rarely makes sense to refer to React.Component
* directly. Instead, you will typically subclass it, and define at least a render() method.
* https://reactjs.org/docs/react-component.html
* ******************************************************************************************* */class Component extends React.Component {// Will be called before it is mountedconstructor(props) {// Call this method before any other statement// or this.props will be undefined in the constructorsuper(props);// The constructor is also often used to bind event handlers to the class instance.// Binding makes sure the method has access to component attributes like this.props and this.statethis.method = this.method.bind(this);// The constructor is the right place to initialize state.this.state = {active: true,// In rare cases, it's okay to initialize state based on props.// This effectively "forks" the props and sets the state with the initial props.// If you "fork" props by using them for state, you might also want to implement componentWillReceiveProps(nextProps)// to keep the state up-to-date with them. But lifting state up is often easier and less bug-prone.color: props.initialColor
};}// Enqueues changes to the component state and// tells React that this component and its children need to be re-rendered with the updated state.// setState() does not always immediately update the component. It may batch or defer the update until later.// This makes reading this.state right after calling setState() a potential pitfall.// Instead, use componentDidUpdate or a setState callback.// You may optionally pass an object as the first argument to setState() instead of a function.setState(updater[, callback]) { }// Invoked just before mounting occurs (before render())// This is the only lifecycle hook called on server rendering.componentWillMount() { }// Invoked immediately after a component is mounted.// Initialization that requires DOM nodes should go here.// If you need to load data from a remote endpoint, this is a good place to instantiate the network request.// This method is a good place to set up any subscriptions. If you do that, don't forget to unsubscribe in componentWillUnmount().componentDidMount() { }// Invoked before a mounted component receives new props.// If you need to update the state in response to prop changes (for example, to reset it),// you may compare this.props and nextProps and perform state transitions using this.setState() in this method.componentWillReceiveProps(nextProps) { }// Let React know if a component's output is not affected by the current change in state or props.// The default behavior is to re-render on every state change, and in the vast majority of cases you should rely on the default behavior.// shouldComponentUpdate() is invoked before rendering when new props or state are being received. Defaults to true.// This method is not called for the initial render or when forceUpdate() is used.// Returning false does not prevent child components from re-rendering when their state changes.shouldComponentUpdate(nextProps, nextState) { }// Invoked just before rendering when new props or state are being received.// Use this as an opportunity to perform preparation before an update occurs. This method is not called for the initial render.// Note that you cannot call this.setState() here; nor should you do anything else// (e.g. dispatch a Redux action) that would trigger an update to a React component before componentWillUpdate() returns.// If you need to update state in response to props changes, use componentWillReceiveProps() instead.componentWillUpdate(nextProps, nextState) { }// Invoked immediately after updating occurs. This method is not called for the initial render.// Use this as an opportunity to operate on the DOM when the component has been updated.// This is also a good place to do network requests as long as you compare the current props to previous props (e.g. a network request may not be necessary if the props have not changed).componentDidUpdate(prevProps, prevState) { }// Invoked immediately before a component is unmounted and destroyed.// Perform any necessary cleanup in this method, such as invalidating timers, canceling network requests,// or cleaning up any subscriptions that were created in componentDidMount().componentWillUnmount() { }// Error boundaries are React components that catch JavaScript errors anywhere in their child component tree,// log those errors, and display a fallback UI instead of the component tree that crashed.// Error boundaries catch errors during rendering, in lifecycle methods, and in constructors of the whole tree below them.componentDidCatch() { }// This method is required.// It should be pure, meaning that it does not modify component state,// it returns the same result each time it's invoked, and// it does not directly interact with the browser (use lifecycle methods for this)// It must return one of the following types: react elements, string and numbers, portals, null or booleans.render() {// Contains the props that were defined by the caller of this component.
console.log(this.props);// Contains data specific to this component that may change over time.// The state is user-defined, and it should be a plain JavaScript object.// If you don't use it in render(), it shouldn't be in the state.// For example, you can put timer IDs directly on the instance.// Never mutate this.state directly, as calling setState() afterwards may replace the mutation you made.// Treat this.state as if it were immutable.
console.log(this.state);return (<div>{/* Comment goes here */}
Hello, {this.props.name}!</div>);}}// Can be defined as a property on the component class itself, to set the default props for the class.// This is used for undefined props, but not for null props.
Component.defaultProps = {color: 'blue'};
component = new Component();// By default, when your component's state or props change, your component will re-render.// If your render() method depends on some other data, you can tell React that the component needs re-rendering by calling forceUpdate().// Normally you should try to avoid all uses of forceUpdate() and only read from this.props and this.state in render().
component.forceUpdate(callback)/* *******************************************************************************************
* REACT.DOM
* The react-dom package provides DOM-specific methods that can be used at the top level of
* your app and as an escape hatch to get outside of the React model if you need to.
* Most of your components should not need to use this module.
* https://reactjs.org/docs/react-dom.html
* ******************************************************************************************* */// Render a React element into the DOM in the supplied container and return a reference// to the component (or returns null for stateless components).
ReactDOM.render(element, container[, callback])// Same as render(), but is used to hydrate a container whose HTML contents were rendered// by ReactDOMServer. React will attempt to attach event listeners to the existing markup.
ReactDOM.hydrate(element, container[, callback])// Remove a mounted React component from the DOM and clean up its event handlers and state.// If no component was mounted in the container, calling this function does nothing.// Returns true if a component was unmounted and false if there was no component to unmount.
ReactDOM.unmountComponentAtNode(container)// If this component has been mounted into the DOM, this returns the corresponding native browser// DOM element. This method is useful for reading values out of the DOM, such as form field values// and performing DOM measurements. In most cases, you can attach a ref to the DOM node and avoid// using findDOMNode at all.
ReactDOM.findDOMNode(component)// Creates a portal. Portals provide a way to render children into a DOM node that exists outside// the hierarchy of the DOM component.
ReactDOM.createPortal(child, container)/* *******************************************************************************************
* REACTDOMSERVER
* The ReactDOMServer object enables you to render components to static markup.
* https://reactjs.org/docs/react-dom.html
* ******************************************************************************************* */// Render a React element to its initial HTML. React will return an HTML string.// You can use this method to generate HTML on the server and send the markup down on the initial// request for faster page loads and to allow search engines to crawl your pages for SEO purposes.
ReactDOMServer.renderToString(element)// Similar to renderToString, except this doesn't create extra DOM attributes that React uses// internally, such as data-reactroot. This is useful if you want to use React as a simple static// page generator, as stripping away the extra attributes can save some bytes.
ReactDOMServer.renderToStaticMarkup(element)// Render a React element to its initial HTML. Returns a Readable stream that outputs an HTML string.// The HTML output by this stream is exactly equal to what ReactDOMServer.renderToString would return.// You can use this method to generate HTML on the server and send the markup down on the initial// request for faster page loads and to allow search engines to crawl your pages for SEO purposes.
ReactDOMServer.renderToNodeStream(element)// Similar to renderToNodeStream, except this doesn't create extra DOM attributes that React uses// internally, such as data-reactroot. This is useful if you want to use React as a simple static// page generator, as stripping away the extra attributes can save some bytes.
ReactDOMServer.renderToStaticNodeStream(element)/* *******************************************************************************************
* TYPECHECKING WITH PROPTYPES
* https://reactjs.org/docs/typechecking-with-proptypes.html
* ******************************************************************************************* */import PropTypes from 'prop-types';
MyComponent.propTypes = {// You can declare that a prop is a specific JS type. By default, these// are all optional.optionalArray: PropTypes.array,optionalBool: PropTypes.bool,optionalFunc: PropTypes.func,optionalNumber: PropTypes.number,optionalObject: PropTypes.object,optionalString: PropTypes.string,optionalSymbol: PropTypes.symbol,// Anything that can be rendered: numbers, strings, elements or an array// (or fragment) containing these types.optionalNode: PropTypes.node,// A React element.optionalElement: PropTypes.element,// You can also declare that a prop is an instance of a class. This uses// JS's instanceof operator.optionalMessage: PropTypes.instanceOf(Message),// You can ensure that your prop is limited to specific values by treating// it as an enum.optionalEnum: PropTypes.oneOf(['News', 'Photos']),// An object that could be one of many typesoptionalUnion: PropTypes.oneOfType([
PropTypes.string,
PropTypes.number,
PropTypes.instanceOf(Message)]),// An array of a certain typeoptionalArrayOf: PropTypes.arrayOf(PropTypes.number),// An object with property values of a certain typeoptionalObjectOf: PropTypes.objectOf(PropTypes.number),// An object taking on a particular shapeoptionalObjectWithShape: PropTypes.shape({color: PropTypes.string,fontSize: PropTypes.number
}),// You can chain any of the above with `isRequired` to make sure a warning// is shown if the prop isn't provided.requiredFunc: PropTypes.func.isRequired,// A value of any data typerequiredAny: PropTypes.any.isRequired,// You can also specify a custom validator. It should return an Error// object if the validation fails. Don't `console.warn` or throw, as this// won't work inside `oneOfType`.customProp: function(props, propName, componentName) {if (!/matchme/.test(props[propName])) {return new Error('Invalid prop `' + propName + '` supplied to' +' `' + componentName + '`. Validation failed.');}},// You can also supply a custom validator to `arrayOf` and `objectOf`.// It should return an Error object if the validation fails. The validator// will be called for each key in the array or object. The first two// arguments of the validator are the array or object itself, and the// current item's key.customArrayProp: PropTypes.arrayOf(function(propValue, key, componentName, location, propFullName) {if (!/matchme/.test(propValue[key])) {return new Error('Invalid prop `' + propFullName + '` supplied to' +' `' + componentName + '`. Validation failed.');}})};
Advanced Components
Options (ES5)
propTypes object
: Type validation in development modegetDefaultProps function()
: object of default propsgetInitialState function()
: object of the initial state
ES5:
//var Link = React.createClass({propTypes: { name: React.PropTypes.string },getDefaultProps: function () {return { initialCount: 0 };},getInitialState: function () {return { count: this.props.initialCount };},tick: function () {this.setState({ count: this.state.count + 1 });},render: function () {return React.createElement('a',{ className: 'btn', href: '#', title: this.props.name, onClick: this.tick.bind(this) },'Click ->',this.props.name ? this.props.name : 'webapplog.com',' (Clicked: ' + this.state.count + ')');}});
ES5 + JSX:
//var Link = React.createClass({propTypes: { name: React.PropTypes.string },getDefaultProps: function () {return { initialCount: 0 };},getInitialState: function () {return { count: this.props.initialCount };},tick: function () {this.setState({ count: this.state.count + 1 });},render: function () {return (<a onClick={this.tick.bind(this)} href="#" className="btn" title={this.props.name}>
Click -> {this.props.name ? this.props.name : 'webapplog.com'}(Clicked: {this.state.count})</a>);}});
ES6 + JSX:
//export class Link extends React.Component {constructor(props) {super(props);this.state = { count: props.initialCount };}tick() {this.setState({ count: this.state.count + 1 });}render() {return (<a onClick={this.tick.bind(this)} href="#" className="btn" title={this.props.name}>
Click -> {this.props.name ? this.props.name : 'webapplog.com'}(Clicked: {this.state.count})</a>);}}
Link.propTypes = { initialCount: React.PropTypes.number };
Link.defaultProps = { initialCount: 0 };
Lifecycle Events
Modern React lifecycle methods (v16+)
Legacy Lifecycle Events:
componentWillMount function()
componentDidMount function()
componentWillReceiveProps function(nextProps)
shouldComponentUpdate function(nextProps, nextState)-> bool
componentWillUpdate function(nextProps, nextState)
componentDidUpdate function(prevProps, prevState)
componentWillUnmount function()
Sequence of lifecycle events:
Inspired by http://react.tips
Special Props
key
: Unique identifier for an element to turn arrays/lists into hashes for better performance, e.g.,key={id}
ref
: Reference to an element viathis.refs.NAME
, e.g.,ref="email"
will createthis.refs.email
DOM node orReactDOM.findDOMNode(this.refs.email)
style
: Accept an object of styles, instead of a string (immutable since v0.14), e.g.,style={{color: red}}
className
: the HTMLclass
attribute, e.g.,className="btn"
htmlFor
: the HTMLfor
attribute, e.g.,htmlFor="email"
dangerouslySetInnerHTML
: raw HTML by providing an object with the key__html
children
: content of the element viathis.props.children
, e.g.,this.props.children[0]
data-NAME
: custom attribute, e.g.,data-tooltip-text="..."
propTypes
Types available under React.PropTypes
:
any
array
bool
element
func
node
number
object
string
To make required, append .isRequired
.
More methods:
instanceOf(constructor)
oneOf(['News', 'Photos'])
oneOfType([propType, propType])
Custom Validation
//propTypes: {customProp: function(props, propName, componentName) {if (!/regExPattern/.test(props[propName])) {return new Error('Validation failed!');}}}
Component Properties and Methods
Properties:
this.refs
: Lists components with aref
propthis.props
: Any props passed to an element (immutable)this.state
: State set by setState and getInitialState (muttable) — avoid setting state manually withthis.state=...
this.isMounted
: Flag whether the element has a corresponding DOM node or not
Methods:
setState(changes)
: Change state (partially) tothis.state
and trigger re-renderreplaceState(newState)
: Replacethis.state
and trigger re-renderforceUpdate()
: Trigger DOM re-render immediately
React Addons
As npm modules:
react-addons-css-transition-group
react-addons-perf
react-addons-test-utils
react-addons-pure-render-mixin
react-addons-linked-state-mixin
react-addons-clone-with-props
react-addons-create-fragment
react-addons-css-transition-group
react-addons-linked-state-mixin
react-addons-pure-render-mixin
react-addons-shallow-compare
react-addons-transition-group
react-addons-update
React Components
- https://github.com/brillout/awesome-react-components and http://devarchy.com/react-components: List of React components
- Material-UI: Material design React components
- http://react-toolbox.com: Set of React components that implement Google Material Design specification
- https://js.coach: Opinionated catalog of open source JS (mostly React) packages
- https://react.rocks: Catalog of React components
- https://khan.github.io/react-components: Khan Academy React components
- http://www.reactjsx.com: Registry of React components