React Compatibility Component

The missing link!

Wrapper class, which adds a compatibility layer to React 0.13's ES6 Component class, to make it easier to use ES6 goodness without changing much code.

Do you want to use ES6 classes via React 0.13's Component class?

Do you want to be able to keep your mixins?

Do you miss autobinding this to your methods?

This is perfect for you!

react-compat-component allows you to use the new ES6 class structure for your components without changing much code. And it allows you to continue to use mixins without any special modifications. You don't need to code differently because of ES6.

Installation

npm install --save react-compat-component

Example

A modified example from the React Docs:

import React from "react";
import { CompatComponent } from "react-compat-component";

export class HelloMessage extends CompatComponent {
  getMixins() {
    return [
      SetIntervalMixin
    ];
  }

  getPropTypes() {
    return {
      example: React.PropTypes.number
    };
  }

  getDefaultProps() {
    return {
      example: 0
    }
  }

  constructor(props) {
    super(props);
    // ...
  }

  getInitialState: function() {
    return {
      seconds: 0
    };
  }

  render() {
    // ...
  }
}

In the future, something like this might be possible:

import React from "react";
import { CompatComponent } from "react-compat-component";

export class HelloMessage extends CompatComponent {
  const mixins = [
    SetIntervalMixin
  ];
  defaultProps = {
    example: 0
  };
  propTypes = {
    example: React.PropTypes.number
  };

  constructor(props) {
    super(props);
    // ...
  }

  getInitialState: function() {
    return {
      seconds: 0
    };
  }

  render() {
    // ...
  }
}

Differences from createClass

Originally React ditched two major features for ES6 classes:

• Autobinding
• Mixins
• getInitialState()

Also it deletes the following methods:

• getInitialState()
• getDefaultProps()

react-compat-component restores all three features.

Its "meta-constructor" modifies the component during instantiation. (Note that this might affect performance)

Also as a workaround it has to introduce the getMixins and the getPropTypes method as in classes there isn't variable instantiation available as of now.

Difference to react-mixin

react-mixin implements a function to modify arbitrary objects to "import" mixins. It is an unnecessary hack and just doesn't feel as elegant as mixins were. It was a quick fix, but react-compat-component is the real deal.

reactMixin(Foo.prototype, someMixin);

Contribute

Feel free to contribute!

Open fork, open pull requests and issues and help out. Any feedback is greatly appreciated.

Building

You need to let Babel do its job to get a compiled version of this:

npm build