常用 React
组件 API
:
- 设置状态:
setState
- 替换状态:
replaceState
- 设置属性:
setProps
- 替换属性:
replaceProps
- 强制更新:
forceUpdate
- 获取DOM节点:
findDOMNode
- 判断组件挂载状态:
isMounted
setState
setState(object nextState[, function callback])
参数说明
nextState
:将要设置的新状态,该状态会和当前的 state
合并;
callback
:可选参数,回调函数。该函数会在 setState
设置成功,且组件重新渲染后调用。
注意事项
- 不能在组件内部通过
this.state
修改状态,因为该状态会在调用setState()
后被替换。 setState()
并不会立即改变this.state
,而是创建一个即将处理的state
。setState()
并不一定是同步的,为了提升性能React
会批量执行state
和DOM
渲染。setState()
总是会触发一次组件重绘,除非在shouldComponentUpdate()
中实现了一些条件渲染逻辑。
使用
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8" />
<title>React demo</title>
<script src="https://cdn.staticfile.org/react/16.4.0/umd/react.development.js"></script>
<script src="https://cdn.staticfile.org/react-dom/16.4.0/umd/react-dom.development.js"></script>
<script src="https://cdn.staticfile.org/babel-standalone/6.26.0/babel.min.js"></script>
</head>
<body>
<div id="example"></div>
<script type="text/babel">
class Counter extends React.Component{
constructor(props) {
super(props);
this.state = {count: 0};
this.handleClick = this.handleClick.bind(this);
}
handleClick() {
this.setState((state) =>{
return {count: state.count + 1};
});
}
render () {
return (<h2 onClick={this.handleClick}>点我!点击次数为: {this.state.count}</h2>);
}
}
ReactDOM.render(
<Counter />,
document.getElementById('example')
);
</script>
</body>
</html>
页面效果:
注意:
上面例子中,有一句 this.handleClick = this.handleClick.bind(this)
。
用 class
来创建 react
组件时,有一件很麻烦的事情,就是this
的指向问题。类的方法默认是不会绑定 this
的,为了保证 this
的指向正确,需要写这样的代码:
this.handleClick = this.handleClick.bind(this)
或者是这样的代码:
<button onClick={() => this.handleClick(e)}>
如果忘记绑定 this.handleClick
并把它传入 onClick
,调用这个函数的时候 this
的值会是 undefined
。
replaceState
replaceState(object nextState[, function callback])
参数说明
nextState
:将要设置的新状态,该状态会替换当前的 state
。
callback
:可选参数,回调函数。该函数会在 replaceState
设置成功,且组件重新渲染后调用。
replaceState()
方法与setState()
类似,但是方法只会保留nextState
中状态,原state
不在nextState
中的状态都会被删除。
setProps
setProps(object nextProps[, function callback])
参数说明
nextProps
:将要设置的新属性,该状态会和当前的 props
合并
callback
:可选参数,回调函数。该函数会在 setProps
设置成功,且组件重新渲染后调用。
设置组件属性,并重新渲染组件。
-
props
相当于组件的数据流,它总是会从父组件向下传递至所有的子组件中。 -
当和一个外部的
JavaScript
应用集成时,可能会需要向组件传递数据或通知React.render()
组件需要重新渲染,可以使用setProps()
。 -
更新组件,可以在节点上再次调用
React.render()
,也可以通过setProps()
方法改变组件属性,触发组件重新渲染。
replaceProps
replaceProps(object nextProps[, function callback])
参数说明
nextProps
:将要设置的新属性,该属性会替换当前的 props
。
callback
:可选参数,回调函数。该函数会在 replaceProps
设置成功,且组件重新渲染后调用。
replaceProps()
方法与setProps
类似,但它会删除原有props
。
forceUpdate
forceUpdate([function callback])
参数说明
callback
:可选参数,回调函数。该函数会在组件render()方法调用后调用。
-
forceUpdate()
方法会使组件调用自身的render()
方法重新渲染组件,组件的子组件也会调用自己的render()
。但是,组件重新渲染时,依然会读取this.props
和this.state
,如果状态没有改变,那么React
只会更新DOM
。 -
forceUpdate()
方法适用于this.props
和this.state
之外的组件重绘(如:修改了this.state
后),通过该方法通知React
需要调用render()
。 -
一般来说,应该尽量避免使用
forceUpdate()
,而仅从this.props
和this.state
中读取状态并由React
触发render()
调用。
findDOMNode
DOMElement findDOMNode()
返回值:DOM
元素 DOMElement
- 如果组件已经挂载到
DOM
中,该方法返回对应的本地浏览器DOM
元素。 - 当
render
返回null
或false
时,this.findDOMNode()
也会返回null
。从DOM
中读取值的时候,该方法很有用,如:获取表单字段的值和做一些DOM
操作。
isMounted
bool isMounted()
返回值:true
或 false
,表示组件是否已挂载到 DOM
中
isMounted()
方法用于判断组件是否已挂载到DOM
中。可以使用该方法保证setState()
和forceUpdate()
在异步场景下的调用不会出错。