react-component-update

1.6.0 • Public • Published

react-component-update

npm package node version Build Status codecov Known Vulnerabilities

Adds convenience lifecycle events to your React components.

Installation

Published on npm as react-component-update.

npm users:

npm install --save react-component-update

yarn users:

yarn add react-component-update

react-component-update does not include its own version of React. It will use whatever version is already installed in your project.

Usage

To extend React's Component class:

import React from 'react';
import { Component } from 'react-component-update';

class MyReactComponent extends Component {
  componentWillMountOrReceiveProps(nextProps) {
    // Code that runs before every render().  For example, check that the data
    // used by this component has already loaded, otherwise trigger an AJAX
    // request for it.  nextProps contains the props that render() will receive.
  }

  componentDidMountOrUpdate(prevProps, prevState) {
    // Code that runs after every render().  For example, inspect the latest DOM
    // to get the height of the rendered elements.  prevProps and prevState
    // contain the props and state that render() will receive.
  }

  render() {
    return <div />;
  }
}

Or to extend React's PureComponent class (available in React v15.3.0+):

import { PureComponent } from 'react-component-update';

For compatibility with create-react-class, use the withEvents() higher-order component.

import createReactClass from 'create-react-class';
import { withEvents } from 'react-component-update';

const MyReactComponent = createReactClass(withEvents({
	componentWillMountOrReceiveProps: function(nextProps) {
		// Code that runs before every render().
	},

	componentDidMountOrUpdate: function(prevProps, prevState) {
		// Code that runs after every render().
	},

	render: function() {
		return <div />;
	}
}));

Mixing with your own lifecycle events

react-component-update implements four lifecycle events of the React base classes:

  • componentWillMount()
  • componentDidMount()
  • componentWillReceiveProps()
  • componentDidUpdate()

If you extend Component or PureComponent from react-component-update and you also implement these events in your component, you will need to call the corresponding super() method like so:

componentWillMount() {
	super.componentWillMount();
}

componentDidMount() {
	super.componentDidMount();
}

componentWillReceiveProps(nextProps) {
	super.componentWillReceiveProps(nextProps);
}

componentDidUpdate(prevProps, prevState) {
	super.componentDidUpdate(prevProps, prevState);
}

The super() method can be called anywhere in your function to suit your needs.

If you use the withEvents() higher-order component, you do not need to add any extra code to your events. The new event (ex. componentDidMountOrUpdate()) will always run after the related built-in event (ex. componentDidUpdate()).

License

MIT

Readme

Keywords

none

Package Sidebar

Install

npm i react-component-update

Weekly Downloads

1

Version

1.6.0

License

MIT

Unpacked Size

42.8 kB

Total Files

8

Last publish

Collaborators

  • wimpyprogrammer