React组件的API

React 组件实例在渲染的时候(实例化)创建,这些实例在接下来渲染中会被重复使用。要调用组件上的API,首先需要获取对组件的引用。在组件方法内部可以通过this访问,在组件外唯一访问组件方法就是通过React.render的返回值,在其它组件内访问组件,可以使用refs获得对组件的引用。


  1. 设置状态:setState

  2. 替换状态:replaceState

  3. 设置属性setProps

  4. 替换属性replaceProps

  5. 强制更新:forceUpdate

  6. 获取DOM节点:getDOMNode

  7. 判断组件挂载状态:isMounted


1. 设置状态:setState

setState(object nextState[, function callback])

合并nextState和当前state,并重新渲染组件。setState是React事件处理函数中和请求回调函数中触发UI更新的主要方法。


关于setState

不能在组件内部通过this.state修改状态,因为该状态会在调用setState()后被替换。

setState()并不会立即改变this.state,而是创建一个即将处理的statesetState()并不一定是同步的,为了提升性能React会批量执行state和DOM渲染。

setState()总是会触发一次组件重绘,除非在shouldComponentUpdate()中实现了一些条件渲染逻辑。


2. 替换状态:replaceState

replaceState(object nextState[, function callback])

replaceState()方法与setState()类似,但是方法只会保留nextState中状态,原state不在nextState中的状态都会被删除。


3. 设置属性setProps

setProps(object nextProps[, function callback])

设置组件属性,并重新渲染组件。

props相当于组件的数据流,它总是会从父组件向下传递至所有的子组件中。当和一个外部的JavaScript应用集成时,我们可能会需要向组件传递数据或通知React.render()组件需要重新渲染,可以使用setProps()

更新组件,我可以在节点上再次调用React.render(),也可以通过setProps()方法改变组件属性,触发组件重新渲染。


4. 替换属性replaceProps

replaceProps(object nextProps[, function callback])

replaceProps()方法与setProps类似,但它会删除原有

props

只保留nextProps中的属性。



5. 强制更新:forceUpdate

forceUpdate([function callback])

forceUpdate()方法会使组件调用自身的render()方法重新渲染组件,组件的子组件也会调用自己的render()。但是,组件重新渲染时,依然会读取this.propsthis.state,如果状态没有改变,那么React只会更新DOM。

forceUpdate()方法适用于this.propsthis.state之外的组件重绘(如:修改了this.state后),通过该方法通知React需要调用render()

一般来说,应该尽量避免使用forceUpdate(),而仅从this.propsthis.state中读取状态并由React触发render()调用。


6. 获取DOM节点:getDOMNode

DOMElement getDOMNode()

如果组件已经挂载到DOM中,该方法返回对应的本地浏览器 DOM 元素。当render返回null 或 false时,this.getDOMNode()也会返回null。从DOM 中读取值的时候,该方法很有用,如:获取表单字段的值和做一些 DOM 操作。


7. 判断组件挂载状态:isMounted

bool isMounted()

isMounted()方法用于判断组件是否已挂载到DOM中。可以使用该方法保证了setState()forceUpdate()在异步场景下的调用不会出错。