使用 React 的网页源码,结构大体以下。javascript
<!DOCTYPE html> <html> <head> <script src="../build/react.js"></script> <script src="../build/react-dom.js"></script> <script src="../build/browser.min.js"></script> </head> <body> <div id="example"></div> <script type="text/babel"> // ** Our code goes here! ** </script> </body> </html>
上面代码有两个地方须要注意。首先,最后一个 <script>
标签的 type
属性为 text/babel
。这是由于 React 独有的 JSX 语法,跟 JavaScript 不兼容。凡是使用 JSX 的地方,都要加上 type="text/babel"
。html
其次,上面代码一共用了三个库: react.js
、react-dom.js
和 Browser.js
,它们必须首先加载。其中,react.js
是 React 的核心库,react-dom.js
是提供与 DOM 相关的功能,Browser.js
的做用是将 JSX 语法转为 JavaScript 语法,这一步很消耗时间,实际上线的时候,应该将它放到服务器完成。java
$ babel src --out-dir build
上面命令能够将 src
子目录的 js
文件进行语法转换,转码后的文件所有放在 build
子目录。react
ReactDOM.render 是 React 的最基本方法,用于将模板转为 HTML 语言,并插入指定的 DOM 节点。git
ReactDOM.render( <h1>Hello, world!</h1>, document.getElementById('example') );
上面代码将一个 h1
标题,插入 example
节点(查看 demo01
),运行结果以下。github
上一节的代码, HTML 语言直接写在 JavaScript 语言之中,不加任何引号,这就是 JSX 的语法,它容许 HTML 与 JavaScript 的混写(查看 Demo02
)。算法
var names = ['Alice', 'Emily', 'Kate']; ReactDOM.render( <div> { names.map(function (name) { return <div>Hello, {name}!</div> }) } </div>, document.getElementById('example') );
上面代码体现了 JSX 的基本语法规则:遇到 HTML 标签(以 <
开头),就用 HTML 规则解析;遇到代码块(以 {
开头),就用 JavaScript 规则解析。上面代码的运行结果以下。api
JSX 容许直接在模板插入 JavaScript 变量。若是这个变量是一个数组,则会展开这个数组的全部成员(查看 demo03
)。数组
var arr = [ <h1>Hello world!</h1>, <h2>React is awesome</h2>, ]; ReactDOM.render( <div>{arr}</div>, document.getElementById('example') );
上面代码的arr
变量是一个数组,结果 JSX 会把它的全部成员,添加到模板,运行结果以下。promise
React 容许将代码封装成组件(component),而后像插入普通 HTML 标签同样,在网页中插入这个组件。React.createClass 方法就用于生成一个组件类(查看 demo04
)。
var HelloMessage = React.createClass({ render: function() { return <h1>Hello {this.props.name}</h1>; } }); ReactDOM.render( <HelloMessage name="John" />, document.getElementById('example') );
上面代码中,变量 HelloMessage
就是一个组件类。模板插入 <HelloMessage />
时,会自动生成 HelloMessage
的一个实例(下文的"组件"都指组件类的实例)。全部组件类都必须有本身的 render
方法,用于输出组件。
注意,组件类的第一个字母必须大写,不然会报错,好比HelloMessage
不能写成helloMessage
。另外,组件类只能包含一个顶层标签,不然也会报错。
var HelloMessage = React.createClass({ render: function() { return <h1> Hello {this.props.name} </h1><p> some text </p>; } });
上面代码会报错,由于HelloMessage
组件包含了两个顶层标签:h1
和p
。
组件的用法与原生的 HTML 标签彻底一致,能够任意加入属性,好比 <HelloMessage name="John">
,就是 HelloMessage
组件加入一个 name
属性,值为 John
。组件的属性能够在组件类的 this.props
对象上获取,好比 name
属性就能够经过 this.props.name
读取。上面代码的运行结果以下。
添加组件属性,有一个地方须要注意,就是 class
属性须要写成 className
,for
属性须要写成 htmlFor
,这是由于 class
和 for
是 JavaScript 的保留字。
this.props
对象的属性与组件的属性一一对应,可是有一个例外,就是 this.props.children
属性。它表示组件的全部子节点(查看 demo05
)。
var NotesList = React.createClass({ render: function() { return ( <ol> { React.Children.map(this.props.children, function (child) { return <li>{child}</li>; }) } </ol> ); } }); ReactDOM.render( <NotesList> <span>hello</span> <span>world</span> </NotesList>, document.body );
上面代码的 NoteList
组件有两个 span
子节点,它们均可以经过 this.props.children
读取,运行结果以下。
这里须要注意, this.props.children
的值有三种可能:若是当前组件没有子节点,它就是 undefined
;若是有一个子节点,数据类型是 object
;若是有多个子节点,数据类型就是 array
。因此,处理 this.props.children
的时候要当心。
React 提供一个工具方法 React.Children
来处理 this.props.children
。咱们能够用 React.Children.map
来遍历子节点,而不用担忧 this.props.children
的数据类型是 undefined
仍是 object
。更多的 React.Children
的方法,请参考官方文档。
组件的属性能够接受任意值,字符串、对象、函数等等均可以。有时,咱们须要一种机制,验证别人使用组件时,提供的参数是否符合要求。
组件类的PropTypes
属性,就是用来验证组件实例的属性是否符合要求(查看 demo06
)。
var MyTitle = React.createClass({ propTypes: { title: React.PropTypes.string.isRequired, }, render: function() { return <h1> {this.props.title} </h1>; } });
上面的Mytitle
组件有一个title
属性。PropTypes
告诉 React,这个 title
属性是必须的,并且它的值必须是字符串。如今,咱们设置 title
属性的值是一个数值。
var data = 123; ReactDOM.render( <MyTitle title={data} />, document.body );
这样一来,title
属性就通不过验证了。控制台会显示一行错误信息。
Warning: Failed propType: Invalid prop `title` of type `number` supplied to `MyTitle`, expected `string`.
更多的PropTypes
设置,能够查看官方文档。
此外,getDefaultProps
方法能够用来设置组件属性的默认值。
var MyTitle = React.createClass({ getDefaultProps : function () { return { title : 'Hello World' }; }, render: function() { return <h1> {this.props.title} </h1>; } }); ReactDOM.render( <MyTitle />, document.body );
上面代码会输出"Hello World"。
组件并非真实的 DOM 节点,而是存在于内存之中的一种数据结构,叫作虚拟 DOM (virtual DOM)。只有当它插入文档之后,才会变成真实的 DOM 。根据 React 的设计,全部的 DOM 变更,都先在虚拟 DOM 上发生,而后再将实际发生变更的部分,反映在真实 DOM上,这种算法叫作 DOM diff ,它能够极大提升网页的性能表现。
可是,有时须要从组件获取真实 DOM 的节点,这时就要用到 ref
属性(查看 demo07 )。
var MyComponent = React.createClass({ handleClick: function() { this.refs.myTextInput.focus(); }, render: function() { return ( <div> <input type="text" ref="myTextInput" /> <input type="button" value="Focus the text input" onClick={this.handleClick} /> </div> ); } }); ReactDOM.render( <MyComponent />, document.getElementById('example') );
上面代码中,组件 MyComponent
的子节点有一个文本输入框,用于获取用户的输入。这时就必须获取真实的 DOM 节点,虚拟 DOM 是拿不到用户输入的。为了作到这一点,文本输入框必须有一个 ref
属性,而后 this.refs.[refName]
就会返回这个真实的 DOM 节点。
须要注意的是,因为 this.refs.[refName]
属性获取的是真实 DOM ,因此必须等到虚拟 DOM 插入文档之后,才能使用这个属性,不然会报错。上面代码中,经过为组件指定 Click
事件的回调函数,确保了只有等到真实 DOM 发生 Click
事件以后,才会读取 this.refs.[refName]
属性。
React 组件支持不少事件,除了 Click
事件之外,还有 KeyDown
、Copy
、Scroll
等,完整的事件清单请查看官方文档。
组件免不了要与用户互动,React 的一大创新,就是将组件当作是一个状态机,一开始有一个初始状态,而后用户互动,致使状态变化,从而触发从新渲染 UI (查看 demo08
)。
var LikeButton = React.createClass({ getInitialState: function() { return {liked: false}; }, handleClick: function(event) { this.setState({liked: !this.state.liked}); }, render: function() { var text = this.state.liked ? 'like' : 'haven\'t liked'; return ( <p onClick={this.handleClick}> You {text} this. Click to toggle. </p> ); } }); ReactDOM.render( <LikeButton />, document.getElementById('example') );
上面代码是一个 LikeButton
组件,它的 getInitialState
方法用于定义初始状态,也就是一个对象,这个对象能够经过 this.state
属性读取。当用户点击组件,致使状态变化,this.setState
方法就修改状态值,每次修改之后,自动调用 this.render
方法,再次渲染组件。
因为 this.props
和 this.state
都用于描述组件的特性,可能会产生混淆。一个简单的区分方法是,this.props
表示那些一旦定义,就再也不改变的特性,而 this.state
是会随着用户互动而产生变化的特性。
用户在表单填入的内容,属于用户跟组件的互动,因此不能用 this.props
读取(查看 demo9
)。
var Input = React.createClass({ getInitialState: function() { return {value: 'Hello!'}; }, handleChange: function(event) { this.setState({value: event.target.value}); }, render: function () { var value = this.state.value; return ( <div> <input type="text" value={value} onChange={this.handleChange} /> <p>{value}</p> </div> ); } }); ReactDOM.render(<Input/>, document.body);
上面代码中,文本输入框的值,不能用 this.props.value
读取,而要定义一个 onChange
事件的回调函数,经过 event.target.value
读取用户输入的值。textarea
元素、select
元素、radio
元素都属于这种状况,更多介绍请参考官方文档。
组件的生命周期分红三个状态:
- Mounting:已插入真实 DOM
- Updating:正在被从新渲染
- Unmounting:已移出真实 DOM
React 为每一个状态都提供了两种处理函数,will
函数在进入状态以前调用,did
函数在进入状态以后调用,三种状态共计五种处理函数。
- componentWillMount()
- componentDidMount()
- componentWillUpdate(object nextProps, object nextState)
- componentDidUpdate(object prevProps, object prevState)
- componentWillUnmount()
此外,React 还提供两种特殊状态的处理函数。
- componentWillReceiveProps(object nextProps):已加载组件收到新的参数时调用
- shouldComponentUpdate(object nextProps, object nextState):组件判断是否从新渲染时调用
这些方法的详细说明,能够参考官方文档。下面是一个例子(查看 demo10
)。
var Hello = React.createClass({ getInitialState: function () { return { opacity: 1.0 }; }, componentDidMount: function () { this.timer = setInterval(function () { var opacity = this.state.opacity; opacity -= .05; if (opacity < 0.1) { opacity = 1.0; } this.setState({ opacity: opacity }); }.bind(this), 100); }, render: function () { return ( <div style={{opacity: this.state.opacity}}> Hello {this.props.name} </div> ); } }); ReactDOM.render( <Hello name="world"/>, document.body );
上面代码在hello
组件加载之后,经过 componentDidMount
方法设置一个定时器,每隔100毫秒,就从新设置组件的透明度,从而引起从新渲染。
另外,组件的style
属性的设置方式也值得注意,不能写成
style="opacity:{this.state.opacity};"
而要写成
style={{opacity: this.state.opacity}}
这是由于 React 组件样式是一个对象,因此第一重大括号表示这是 JavaScript 语法,第二重大括号表示样式对象。
组件的数据来源,一般是经过 Ajax 请求从服务器获取,可使用 componentDidMount
方法设置 Ajax 请求,等到请求成功,再用 this.setState
方法从新渲染 UI (查看 demo11
)。
var UserGist = React.createClass({ getInitialState: function() { return { username: '', lastGistUrl: '' }; }, componentDidMount: function() { $.get(this.props.source, function(result) { var lastGist = result[0]; if (this.isMounted()) { this.setState({ username: lastGist.owner.login, lastGistUrl: lastGist.html_url }); } }.bind(this)); }, render: function() { return ( <div> {this.state.username}'s last gist is <a href={this.state.lastGistUrl}>here</a>. </div> ); } }); ReactDOM.render( <UserGist source="https://api.github.com/users/octocat/gists" />, document.body );
上面代码使用 jQuery 完成 Ajax 请求,这是为了便于说明。React 自己没有任何依赖,彻底能够不用jQuery,而使用其余库。
咱们甚至能够把一个Promise对象传入组件,请看Demo12
。
ReactDOM.render( <RepoList promise={$.getJSON('https://api.github.com/search/repositories?q=javascript&sort=stars')} />, document.body );
上面代码从Github的API抓取数据,而后将Promise对象做为属性,传给RepoList
组件。
若是Promise对象正在抓取数据(pending状态),组件显示"正在加载";若是Promise对象报错(rejected状态),组件显示报错信息;若是Promise对象抓取数据成功(fulfilled状态),组件显示获取的数据。
var RepoList = React.createClass({ getInitialState: function() { return { loading: true, error: null, data: null}; }, componentDidMount() { this.props.promise.then( value => this.setState({loading: false, data: value}), error => this.setState({loading: false, error: error})); }, render: function() { if (this.state.loading) { return <span>Loading...</span>; } else if (this.state.error !== null) { return <span>Error: {this.state.error.message}</span>; } else { var repos = this.state.data.items; var repoList = repos.map(function (repo) { return ( <li> <a href={repo.html_url}>{repo.name}</a> ({repo.stargazers_count} stars) <br/> {repo.description} </li> ); }); return ( <main> <h1>Most Popular JavaScript Projects in Github</h1> <ol>{repoList}</ol> </main> ); } } });