React 0.13 has a lot of nice features but there is one particular feature that I’m really excited about. I couldn’t wait for React.js Conf to start tomorrow morning.
\nMaybe you’re like me and staying up late excited about the conference, or maybe you weren’t one of the lucky ones to get a ticket. Either way I figured I’d give you all something to play with until then.
\nWe just published a beta version of React v0.13.0 to npm! You can install it with npm install react@0.13.0-beta.1. Since this is a pre-release, we don’t have proper release notes ready.
So what is that one feature I’m so excited about that I just couldn’t wait to share?
\nJavaScript originally didn’t have a built-in class system. Every popular framework built their own, and so did we. This means that you have a learn slightly different semantics for each framework.
\nWe figured that we’re not in the business of designing a class system. We just want to use whatever is the idiomatic JavaScript way of creating classes.
\nIn React 0.13.0 you no longer need to use React.createClass to create React components. If you have a transpiler you can use ES6 classes today. You can use the transpiler we ship with react-tools by making use of the harmony option: jsx --harmony.
class HelloMessage extends React.Component {\n render() {\n return <div>Hello {this.props.name}</div>;\n }\n}\n\nReact.render(<HelloMessage name=\"Sebastian\" />, mountNode);The API is mostly what you would expect, with the exception of getInitialState. We figured that the idiomatic way to specify class state is to just use a simple instance property. Likewise getDefaultProps and propTypes are really just properties on the constructor.
export class Counter extends React.Component {\n constructor(props) {\n super(props);\n this.state = {count: props.initialCount};\n }\n tick() {\n this.setState({count: this.state.count + 1});\n }\n render() {\n return (\n <div onClick={this.tick.bind(this)}>\n Clicks: {this.state.count}\n </div>\n );\n }\n}\nCounter.propTypes = { initialCount: React.PropTypes.number };\nCounter.defaultProps = { initialCount: 0 };Wait, assigning to properties seems like a very imperative way of defining classes! You’re right, however, we designed it this way because it’s idiomatic. We fully expect a more declarative syntax for property initialization to arrive in future version of JavaScript. It might look something like this:
\n// Future Version\nexport class Counter extends React.Component {\n static propTypes = { initialCount: React.PropTypes.number };\n static defaultProps = { initialCount: 0 };\n state = { count: this.props.initialCount };\n tick() {\n this.setState({ count: this.state.count + 1 });\n }\n render() {\n return (\n <div onClick={this.tick.bind(this)}>\n Clicks: {this.state.count}\n </div>\n );\n }\n}This was inspired by TypeScript’s property initializers.
\nReact.createClass has a built-in magic feature that bound all methods to this automatically for you. This can be a little confusing for JavaScript developers that are not used to this feature in other classes, or it can be confusing when they move from React to other classes.
Therefore we decided not to have this built-in into React’s class model. You can still explicitly prebind methods in your constructor if you want.
\nclass Counter extends React.Component {\n constructor(props) {\n super(props);\n this.tick = this.tick.bind(this);\n }\n tick() {\n ...\n }\n ...\n}However, when we have the future property initializers, there is a neat trick that you can use to accomplish this syntactically:
\nclass Counter extends React.Component {\n tick = () => {\n ...\n }\n ...\n}Unfortunately, we will not launch any mixin support for ES6 classes in React. That would defeat the purpose of only using idiomatic JavaScript concepts.
\nThere is no standard and universal way to define mixins in JavaScript. In fact, several features to support mixins were dropped from ES6 today. There are a lot of libraries with different semantics. We think that there should be one way of defining mixins that you can use for any JavaScript class. React just making another doesn’t help that effort.
\nTherefore, we will keep working with the larger JS community to create a standard for mixins. We will also start designing a new compositional API that will help make common tasks easier to do without mixins. E.g. first-class subscriptions to any kind of Flux store.
\nLuckily, if you want to keep using mixins, you can just keep using React.createClass.
\n\nNote:
\nThe classic
\nReact.createClassstyle of creating classes will continue to work just fine.
Since these classes are just plain old JavaScript classes, you can use other languages that compile to JavaScript classes, such as TypeScript.
\nYou can also use CoffeeScript classes:
\ndiv = React.createFactory 'div'\n\nclass Counter extends React.Component\n @propTypes = initialCount: React.PropTypes.number\n @defaultProps = initialCount: 0\n\n constructor: (props) ->\n super props\n @state = count: props.initialCount\n\n tick: =>\n @setState count: @state.count + 1\n\n render: ->\n div onClick: @tick,\n 'Clicks: '\n @state.countYou can even use the old ES3 module pattern if you want:
\nfunction MyComponent(initialProps) {\n return {\n state: { value: initialProps.initialValue },\n render: function() {\n return <span className={this.state.value} />\n }\n };\n}