react-addons-pure-render-mixin

react-addons-pure-render-mixin

Note: This is a legacy React addon, and is no longer maintained.

We don't encourage using it in new code, but it exists for backwards compatibility.
The recommended migration path is to use React.PureComponent instead.

Importing

import PureRenderMixin from 'react-addons-pure-render-mixin'; // ES6
var PureRenderMixin = require('react-addons-pure-render-mixin'); // ES5 with npm

If you prefer a <script> tag, you can get it from React.addons.PureRenderMixin with:

<!-- development version -->
<script src="https://unpkg.com/react-addons-pure-render-mixin/react-addons-pure-render-mixin.js"></script>

<!-- production version -->
<script src="https://unpkg.com/react-addons-pure-render-mixin/react-addons-pure-render-mixin.min.js"></script>

In this case, make sure to put the <script> tag after React.

Overview

If your React component's render function renders the same result given the same props and state, you can use this mixin for a performance boost in some cases.

Example:

const createReactClass = require('create-react-class');

createReactClass({
  mixins: [PureRenderMixin],

  render: function() {
    return <div className={this.props.className}>foo</div>;
  }
});

Under the hood, the mixin implements shouldComponentUpdate, in which it compares the current props and state with the next ones and returns false if the equalities pass.

Note:

This only shallowly compares the objects. If these contain complex data structures, it may produce false-negatives for deeper differences. Only mix into components which have simple props and state, or use forceUpdate() when you know deep data structures have changed. Or, consider using immutable objects to facilitate fast comparisons of nested data.

Furthermore, shouldComponentUpdate skips updates for the whole component subtree. Make sure all the children components are also "pure".

Changelog

15.6.2 (September 25, 2017)

All Packages

• Switch from BSD + Patents to MIT license

React DOM

• Fix a bug where modifying document.documentMode would trigger IE detection in other browsers, breaking change events. (@aweary in #10032)
• CSS Columns are treated as unitless numbers. (@aweary in #10115)
• Fix bug in QtWebKit when wrapping synthetic events in proxies. (@walrusfruitcake in #10115)
• Prevent event handlers from receiving extra argument in development. (@aweary in #10115)
• Fix cases where onChange would not fire with defaultChecked on radio inputs. (@jquense in #10156)
• Add support for controlList attribute to allowed DOM properties (@nhunzaker in #9940)
• Fix a bug where creating an element with a ref in a constructor did not throw an error in development. (@iansu in #10025)