组件的详细说明
通过Reac.createClass({...})创建组件的时候,应该有一个render()方法,也可以在其中添加生命周期函数.
render方法
当调用该方法的时候,会检测this.props和this.state两个对象,并且返回以一个单子级组件:
1.该组件可以是本地DOM组件(比如<div/>或者React.DOM.div())
2.也可以是自定义的复合组件
3.也可以返回null或者false来表明不需要渲染任何东西,原理:React渲染一个<noscript>标签来处理当前的差异,当返回null或者false时,this.getDomNode()将返回null
tips:
render()
函数应该是纯粹的,也就是说该函数不修改组件 state,每次调用都返回相同的结果,不读写 DOM 信息,也不和浏览器交互(例如通过使用 setTimeout
)。如果需要和浏览器交互,在 componentDidMount()
中或者其它生命周期方法中做这件事。保持render()
纯粹,可以使服务器端渲染更加切实可行,也使组件更容易被理解。
getInitialState
object getInitialState()
在组件挂载之前调用一次。返回值将会作为 this.state
的初始值。
getDefaultProps
object getDefaultProps()
在组件类创建的时候调用一次,然后返回值被缓存下来。如果父组件没有指定 props 中的某个键,则此处返回的对象中的相应属性将会合并到 this.props
(使用 in
检测属性)。
该方法在任何实例创建之前调用,因此不能依赖于 this.props
。另外,getDefaultProps()
返回的任何复杂对象将会在实例间共享,而不是每个实例拥有一份拷贝。
propTypes
object propTypes
propTypes
对象允许验证传入到组件的 props。更多关于 propTypes
的信息,参考可重用的组件。
mixins
mixin
数组允许使用混合来在多个组件之间共享行为。更多关于混合的信息,参考可重用的
statics
object statics
statics
对象允许你定义静态的方法,这些静态的方法可以在组件类上调用.
displayName
string displayName
displayName
字符串用于输出调试信息。JSX 自动设置该值;参考JSX 深入。
生命周期方法
许多方法在组件生命周期中某个确定的时间点执行。
挂载: componentWillMount
componentWillMount()
服务器端和客户端都只调用一次,在初始化渲染执行之前立刻调用。如果在这个方法内调用setState
,render()
将会感知到更新后的 state,将会执行仅一次,尽管 state 改变了。
挂载: componentDidMount
componentDidMount()
在初始化渲染执行之后立刻调用一次,仅客户端有效(服务器端不会调用)。在生命周期中的这个时间点,组件拥有一个 DOM 展现,你可以通过 this.getDOMNode()
来获取相应 DOM 节点。
如果想和其它 JavaScript 框架集成,使用 setTimeout
或者 setInterval
来设置定时器,或者发送 AJAX 请求,可以在该方法中执行这些操作。
注意:
为了兼容 v0.9,DOM 节点作为最后一个参数传入。你依然可以通过
this.getDOMNode()
获取 DOM 节点。
更新: componentWillReceiveProps
componentWillReceiveProps(object nextProps)
在组件接收到新的 props 的时候调用。在初始化渲染的时候,该方法不会调用。
用此函数可以作为 react 在 prop 传入之后, render()
渲染之前更新 state 的机会。老的 props 可以通过 this.props
获取到。在该函数中调用 this.setState()
将不会引起第二次渲染。
componentWillReceiveProps: function(nextProps) {
this.setState({
likesIncreasing: nextProps.likeCount > this.props.likeCount
});
}
注意:
对于 state,没有相似的方法:
componentWillReceiveState
。将要传进来的 prop 可能会引起 state 改变,反之则不然。如果需要在 state 改变的时候执行一些操作,请使用componentWillUpdate
。
更新: shouldComponentUpdate
boolean shouldComponentUpdate(object nextProps, object nextState)
在接收到新的 props 或者 state,将要渲染之前调用。该方法在初始化渲染的时候不会调用,在使用 forceUpdate
方法的时候也不会。
如果确定新的 props 和 state 不会导致组件更新,则此处应该 返回 false
。
shouldComponentUpdate: function(nextProps, nextState) {
return nextProps.id !== this.props.id;
}
如果 shouldComponentUpdate
返回 false,则 render()
将不会执行,直到下一次 state 改变。(另外,componentWillUpdate
和 componentDidUpdate
也不会被调用。)
默认情况下,shouldComponentUpdate
总会返回 true,在 state
改变的时候避免细微的 bug,但是如果总是小心地把 state
当做不可变的,在 render()
中只从 props
和state
读取值,此时你可以覆盖 shouldComponentUpdate
方法,实现新老 props 和 state 的比对逻辑。
如果性能是个瓶颈,尤其是有几十个甚至上百个组件的时候,使用 shouldComponentUpdate
可以提升应用的性能。
更新: componentWillUpdate
componentWillUpdate(object nextProps, object nextState)
在接收到新的 props 或者 state 之前立刻调用。在初始化渲染的时候该方法不会被调用。
使用该方法做一些更新之前的准备工作。
注意:
你不能在刚方法中使用
this.setState()
。如果需要更新 state 来响应某个 prop 的改变,请使用componentWillReceiveProps
。
更新: componentDidUpdate
componentDidUpdate(object prevProps, object prevState)
在组件的更新已经同步到 DOM 中之后立刻被调用。该方法不会在初始化渲染的时候调用。
使用该方法可以在组件更新之后操作 DOM 元素。
注意:
为了兼容 v0.9,DOM 节点会作为最后一个参数传入。如果使用这个方法,你仍然可以使用
this.getDOMNode()
来访问 DOM 节点。
移除: componentWillUnmount
componentWillUnmount()
在组件从 DOM 中移除的时候立刻被调用。
在该方法中执行任何必要的清理,比如无效的定时器,或者清除在 componentDidMount
中创建的 DOM 元素。