0.10 release materials
Paul O’Shannessy committed
Mar 21, 2014 at 14:30 UTC
aea394906285d427745022149babeb9ac5cefb5b
6 files changed
+112
-14
CHANGELOG.md
+24
@@ -1,3 +1,27 @@
1
+## 0.10.0 (March 21, 2014)
2
+
3
+### React Core
4
+
5
+#### New Features
6
+* Added warnings to help migrate towards descriptors
7
+* Made it possible to server render without React-related markup (`data-reactid`, `data-react-checksum`). This DOM will not be mountable by React. [Read the docs for `React.renderComponentToStaticMarkup`](http://facebook.github.io/react/docs/top-level-api.html#react.rendercomponenttostaticmarkup)
8
+* Added support for more attributes:
9
+ * `srcSet` for `<img>` to specify images at different pixel ratios
10
+ * `textAnchor` for SVG
11
+
12
+#### Bug Fixes
13
+* Ensure all void elements don’t insert a closing tag into the markup.
14
+* Ensure `className={false}` behaves consistently
15
+* Ensure `this.refs` is defined, even if no refs are specified.
16
+
17
+### Addons
18
+
19
+* `update` function to deal with immutable data. [Read the docs](http://facebook.github.io/react/docs/update.html)
20
+
21
+### react-tools
22
+* Added an option argument to `transform` function. The only option supported is `harmony`, which behaves the same as `jsx --harmony` on the command line. This uses the ES6 transforms from [jstransform](https://github.com/facebook/jstransform).
23
+
24
+
25
## 0.9.0 (February 20, 2014)
26
27
### React Core
README.md
+3
-3
@@ -40,12 +40,12 @@ The fastest way to get started is to serve JavaScript from the CDN (also availab
40
41
```html
42
<!-- The core React library -->
43
-<script src="http://fb.me/react-0.9.0.js"></script>
43
+<script src="http://fb.me/react-0.10.0.js"></script>
44
<!-- In-browser JSX transformer, remove when pre-compiling JSX. -->
45
-<script src="http://fb.me/JSXTransformer-0.9.0.js"></script>
45
+<script src="http://fb.me/JSXTransformer-0.10.0.js"></script>
46
```
47
48
-We've also built a [starter kit](http://facebook.github.io/react/downloads/react-0.9.0.zip) which might be useful if this is your first time using React. It includes a webpage with an example of using React with live code.
48
+We've also built a [starter kit](http://facebook.github.io/react/downloads/react-0.10.0.zip) which might be useful if this is your first time using React. It includes a webpage with an example of using React with live code.
49
50
If you'd like to use [bower](http://bower.io), it's as easy as:
51
docs/_config.yml
+1
-1
@@ -13,7 +13,7 @@ redcarpet:
13
pygments: true
14
name: React
15
markdown: redcarpet
16
-react_version: 0.10.0-alpha
16
+react_version: 0.10.0
17
description: A JavaScript library for building user interfaces
18
relative_permalinks: true
19
paginate: 5
docs/_posts/2014-03-19-react-v0.10-rc1.md
+11
-10
@@ -8,13 +8,13 @@ author: Paul O’Shannessy
8
9
The release candidate is available for download from the CDN:
10
11
-* **React**
12
- Dev build with warnings: <http://fb.me/react-0.10.0-rc1.js>
13
- Minified build for production: <http://fb.me/react-0.10.0-rc1.min.js>
14
-* **React with Add-Ons**
15
- Dev build with warnings: <http://fb.me/react-with-addons-0.10.0-rc1.js>
16
- Minified build for production: <http://fb.me/react-with-addons-0.10.0-rc1.min.js>
17
-* **In-Browser JSX transformer**
11
+* **React**
12
+ Dev build with warnings: <http://fb.me/react-0.10.0-rc1.js>
13
+ Minified build for production: <http://fb.me/react-0.10.0-rc1.min.js>
14
+* **React with Add-Ons**
15
+ Dev build with warnings: <http://fb.me/react-with-addons-0.10.0-rc1.js>
16
+ Minified build for production: <http://fb.me/react-with-addons-0.10.0-rc1.min.js>
17
+* **In-Browser JSX transformer**
18
<http://fb.me/JSXTransformer-0.10.0-rc1.js>
19
20
We've also published version `0.10.0-rc1` of the `react` and `react-tools` packages on npm and the `react` package on bower.
@@ -53,9 +53,10 @@ The plan for v0.11 is that we will go fully to "descriptors". Method calls on th
53
### React Core
54
55
#### New Features
56
-* Made it possible to server render without React-related markup (`data-reactid`, `data-react-checksum`) - `React.renderComponentToStaticMarkup`
56
+* Added warnings to help migrate towards descriptors
57
+* Made it possible to server render without React-related markup (`data-reactid`, `data-react-checksum`). This DOM will not be mountable by React. [Read the docs for `React.renderComponentToStaticMarkup`](/react/docs/top-level-api.html#react.rendercomponenttostaticmarkup)
58
* Added support for more attributes:
58
- * `srcSet` for `<img>` to images at different pixel ratios
59
+ * `srcSet` for `<img>` to specify images at different pixel ratios
60
* `textAnchor` for SVG
61
62
#### Bug Fixes
@@ -65,7 +66,7 @@ The plan for v0.11 is that we will go fully to "descriptors". Method calls on th
66
67
### Addons
68
68
-* `update` function to deal with immutable data.
69
+* `update` function to deal with immutable data. [Read the docs](/react/docs/update.html)
70
71
### react-tools
72
* Added an option argument to `transform` function. The only option supported is `harmony`, which behaves the same as `jsx --harmony` on the command line. This uses the ES6 transforms from [jstransform](https://github.com/facebook/jstransform).
docs/_posts/2014-03-21-react-v0.10.md
new
+73
@@ -0,0 +1,73 @@
1
+---
2
+title: React v0.10
3
+layout: post
4
+author: Paul O’Shannessy
5
+---
6
+
7
+Hot on the heels of the [release candidate earlier this week](/react/blog/2014/02/20/react-v0.10rc.html), we're ready to call v0.10 done. The only major issue we discovered had to do with the `react-tools` package, which has been updated. We've copied over the changelog from the RC with some small clarifying changes.
8
+
9
+The release is available for download from the CDN:
10
+
11
+* **React**
12
+ Dev build with warnings: <http://fb.me/react-0.10.0.js>
13
+ Minified build for production: <http://fb.me/react-0.10.0.min.js>
14
+* **React with Add-Ons**
15
+ Dev build with warnings: <http://fb.me/react-with-addons-0.10.0.js>
16
+ Minified build for production: <http://fb.me/react-with-addons-0.10.0.min.js>
17
+* **In-Browser JSX transformer**
18
+ <http://fb.me/JSXTransformer-0.10.0.js>
19
+
20
+We've also published version `0.10.0` of the `react` and `react-tools` packages on npm and the `react` package on bower.
21
+
22
+Please try these builds out and [file an issue on GitHub](https://github.com/facebook/react/issues/new) if you see anything awry.
23
+
24
+## Clone On Mount
25
+
26
+The main purpose of this release is to provide a smooth upgrade path as we evolve some of the implementation of core. In v0.9 we started warning in cases where you called methods on unmounted components. This is part of an effort to enforce the idea that the return value of a component (`React.DOM.div()`, `MyComponent()`) is in fact not a reference to the component instance React uses in the virtual DOM. The return value is instead a light-weight object that React knows how to use. Since the return value currently is a reference to the same object React uses internally, we need to make this transition in stages as many people have come to depend on this implementation detail.
27
+
28
+In 0.10, we’re adding more warnings to catch a similar set of patterns. When a component is mounted we clone it and use that object for our internal representation. This allows us to capture calls you think you’re making to a mounted component. We’ll forward them on to the right object, but also warn you that this is breaking. See “Access to the Mounted Instance” on [this page](http://fb.me/react-warning-descriptors). Most of the time you can solve your pattern by using refs.
29
+
30
+Storing a reference to your top level component is a pattern touched upon on that page, but another examples that demonstrates what we see a lot of:
31
+
32
+```js
33
+// This is a common pattern. However instance here really refers to a
34
+// "descriptor", not necessarily the mounted instance.
35
+var instance = <MyComponent/>;
36
+React.renderComponent(instance);
37
+// ...
38
+instance.setProps(...);
39
+
40
+// The change here is very simple. The return value of renderComponent will be
41
+// the mounted instance.
42
+var instance = React.renderComponent(<MyComponent/>)
43
+// ...
44
+instance.setProps(...);
45
+```
46
+
47
+These warnings and method forwarding are only enabled in the development build. The production builds continue to work as they did in v0.9. We strongly encourage you to use the development builds to catch these warnings and fix the call sites.
48
+
49
+The plan for v0.11 is that we will go fully to "descriptors". Method calls on the return value of `MyComponent()` will fail hard.
50
+
51
+## Changelog
52
+
53
+### React Core
54
+
55
+#### New Features
56
+* Added warnings to help migrate towards descriptors
57
+* Made it possible to server render without React-related markup (`data-reactid`, `data-react-checksum`). This DOM will not be mountable by React. [Read the docs for `React.renderComponentToStaticMarkup`](/react/docs/top-level-api.html#react.rendercomponenttostaticmarkup)
58
+* Added support for more attributes:
59
+ * `srcSet` for `<img>` to specify images at different pixel ratios
60
+ * `textAnchor` for SVG
61
+
62
+#### Bug Fixes
63
+* Ensure all void elements don’t insert a closing tag into the markup.
64
+* Ensure `className={false}` behaves consistently
65
+* Ensure `this.refs` is defined, even if no refs are specified.
66
+
67
+### Addons
68
+
69
+* `update` function to deal with immutable data. [Read the docs](/react/docs/update.html)
70
+
71
+### react-tools
72
+* Added an option argument to `transform` function. The only option supported is `harmony`, which behaves the same as `jsx --harmony` on the command line. This uses the ES6 transforms from [jstransform](https://github.com/facebook/jstransform).
73
+
docs/downloads/react-0.10.0.zip
Binary files /dev/null and b/docs/downloads/react-0.10.0.zip differ