Clarify React.render note in documentation
Kevin Coughlin committed
Jul 6, 2015 at 21:47 UTC
e685da53ee3a06066e7b1c68f97f3423f017ec23
1 file changed
+7
-3
docs/docs/ref-01-top-level-api.md
+7
-3
@@ -88,10 +88,14 @@ If the ReactElement was previously rendered into `container`, this will perform
88
If the optional callback is provided, it will be executed after the component is rendered or updated.
89
90
> Note:
91
+>
92
+> `React.render()` controls the contents of the container node you pass in*. Any existing DOM elements
93
+> inside are replaced when first called. Later calls use React’s DOM diffing algorithm for efficient
94
+> updates.
95
>
92
-> `React.render()` replaces the contents of the container node you
93
-> pass in. In the future, it may be possible to insert a component to an
94
-> existing DOM node without overwriting the existing children.
96
+> \* `React.render()` does not modify the container node (only modifies the children of the container). In
97
+> the future, it may be possible to insert a component to an existing DOM node without overwriting
98
+> the existing children.
99
100
101
### React.unmountComponentAtNode