KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #open-source #ai #claude-code #codex #deepseek-harness #dsh-plugin #react #windows #developer-tools

react-compat-component

★ 39 Open GitHub ↗

Marrying ES6 with mixins and more: Compatibility layer for React's ES6 Component class

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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](https://facebook.github.io/react/docs/reusable-components.html):

```javascript
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:

```javascript
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.

```javascript
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
```

react-compat-component

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README