diff --git a/docs/jsx-is-not-html.md b/docs/jsx-is-not-html.md index e3c41263..084c9719 100644 --- a/docs/jsx-is-not-html.md +++ b/docs/jsx-is-not-html.md @@ -10,13 +10,13 @@ JSX looks like HTML but there are some important differences you may run into. ## Whitespace removal -JSX doesn't follow the same whitespace elimination rules as HTML. JSX removes all the whitespaces between two curly braces expressions. If you want to have a white space, a work-around is to add `{' '}`. +JSX doesn't follow the same whitespace elimination rules as HTML. JSX removes all whitespace between two curly braces expressions. If you want to have whitespace, simply add `{' '}`. ```javascript
{this.props.name} {' '} {this.props.surname}
``` -This behavior is still being debated. Follow [Issue #65](https://github.com/facebook/react/issues/65) to be updated on the situation. +Follow [Issue #65](https://github.com/facebook/react/issues/65) for discussion on this behavior. ## HTML Entities @@ -26,20 +26,20 @@ You can insert HTML entities within literal text in JSX:
First · Second
``` -If you want to display an HTML entity within a dynamic content, you will run into double escaping issues as React escapes all the strings you are displaying in order to prevent a wide range of XSS attacks by default. +If you want to display an HTML entity within dynamic content, you will run into double escaping issues as React escapes all the strings you are displaying in order to prevent a wide range of XSS attacks by default. ```javascript // Bad: It displays "First · Second"
{'First · Second'}
``` -There are various ways to work-around this issue. The easiest one is to write unicode character directly in Javascript. You've got to make sure that the file is saved as UTF-8 and that the propers UTF-8 directives are set so the browser will display it correctly. +There are various ways to work-around this issue. The easiest one is to write unicode character directly in Javascript. You need to make sure that the file is saved as UTF-8 and that the proper UTF-8 directives are set so the browser will display it correctly. ```javascript
{'First ยท Second'}
``` -A safer alternative is to find the unicode number corresponding to the entity and use it inside of a Javascript string. +A safer alternative is to find the [unicode number corresponding to the entity](http://www.fileformat.info/info/unicode/char/b7/index.htm) and use it inside of a JavaScript string. ```javascript
{'First \u00b7 Second'}
@@ -52,29 +52,29 @@ You can use mixed arrays with strings and JSX elements.
{['First ', ·, ' Second']}
``` -In last resort, you always have the ability to insert raw HTML inside of the div. +As a last resort, you always have the ability to insert raw HTML. ```javascript -
+
``` ## Comments -JSX supports both single-line and multi-lines Javascript comments within a tag declaration: +JSX supports both single-line and multi-line JavaScript comments within a tag declaration: ```javascript -
``` -As of React 0.3, there is no good way to insert comments within the children section. [Issue #82](https://github.com/facebook/react/issues/82) is tracking progress to enable the following way to write comments: +As of React 0.3, there is no good way to insert comments within the children section. [Issue #82](https://github.com/facebook/react/issues/82) is tracking progress to enable the following: ```javascript -// Note: The following is not implemented yet! +// Note: This is not implemented yet!
{/* This is a comment */}