React 组件 API网站首页 技术教程

React 组件 API

＊且听风吟 2023-06-11 00:00:03

简介React 组件 API

常用 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 操作。