componentWillReceiveProps
1.介绍
componentWillReceiveProps是React生命周期函数之一,在初始props不会被调用,它会在组件接受到新的props时调用。一般用于父组件更新状态时子组件的重新渲染。在react16.3之前,componentWillReceiveProps是在不进行额外render的前提下,响应props中的改变并更新state的唯一方式。
2.使用方法
componentWillReceiveProps(nextProps) { //通过this.props来获取旧的外部状态,初始 props 不会被调用 //通过对比新旧状态,来判断是否执行如this.setState及其他方法 }
主要在以下两种情景使用:
从上传的props无条件的更新state
当props和state不匹配时候更新state
3.常见误区
无条件的更新state
class EmailInput extends Component { state = { email: this.props.email }; componentWillReceiveProps(nextProps) { // 这样会覆盖内部 email的更新! this.setState({ email: nextProps.email }); } handleChange = event => { this.setState({ email: event.target.value }); }; render() { return <input onChange={this.handleChange} value={this.state.email} />; } }
从上述例子可以发现子组件的更新会被父组件的更新覆盖。并且大家在使用过程没有必要这样无条件更新,完全可以写成一个完全受控组件。
<input onChange={this.props.onChange} value={this.props.email} />
也可以对比新旧props状态:
componentWillReceiveProps(nextProps) { if (nextProps.email !== this.props.email) { this.setState({ email: nextProps.email }); } }
现在该组件只会在props改变时候覆盖之前的修改了,但是仍然存在一个小问题。例如一个密码管理网站使用了如上的输入组件。当切换两个不同的账号的时候,如果这两个账号的邮箱相同,那么我们的重置就会失效。因为对于这两个账户传入的email属性是一样的,即数据源相同。效果如下:
父组件:
import React, { Component, Fragment } from 'react'; import { Radio } from 'antd'; import UncontrolledInput from './UncontrolledInput'; const accounts = [ { id: 1, name: 'One', email: 'same.email@example.com', }, { id: 2, name: 'Two', email: 'same.email@example.com', }, { id: 3, name: 'Three', email: 'other.fake.email@example.com', } ]; export default class AccountList extends Component { state = { selectedIndex: 0 }; render() { const { selectedIndex } = this.state; return ( <Fragment> <UncontrolledInput email={accounts[selectedIndex].email} /> <Radio.Group onChange={(e) => this.setState({ selectedIndex: e.target.value })} value={selectedIndex}> {accounts.map((account, index) => ( <Radio value={index}> {account.name} </Radio> ))} </Radio.Group> </Fragment> ); } }
//子组件
import React, { Component } from 'react'; import { Input } from 'antd'; export default class UncontrolledInput extends Component { state = { email: this.props.email }; componentWillReceiveProps(nextProps) { if (nextProps.email !== this.props.email) { this.setState({ email: nextProps.email }); } } handleChange = event => { this.setState({ email: event.target.value }); }; render() { return ( <div> Email: <Input onChange={this.handleChange} value={this.state.email} /> </div> ); } }
从id为1的账户切换到id为2的账户,因为传入的email相同(nextProps.email === this.props.email),输入框无法重置。从id为2的账户切换到id为3的账户,因为传入的email不同,进行了输入框的重置。大家可能想到,既然需要切换账户就重置,那就把id或者selectedIndex选中项作为判断重置条件。
//父组件引入子组件方式
<UncontrolledInput email={accounts[selectedIndex].email} selectedIndex={selectedIndex} />
//子组件
componentWillReceiveProps(nextProps) { if (nextProps.selectedIndex !== this.props.selectedIndex) { this.setState({ email: nextProps.email }); } }
其实当使用唯一标识符来判来保证子组件有一个明确的数据来源时,我们使用key是获取是最合适的方法。并且不需要使用componentWillReceiveProps,只需要保证每次我们每次需要重置输入框时候可以有不同的key值。
//父组件
<UncontrolledInput email={accounts[selectedIndex].email} key={selectedIndex} />
每当key发生变化,会引起子组件的重新构建而不是更新。当我们切换账户,不再是子组件而是重新构建,同样的达到了重置的效果。但是还有一个小问题,当我们在一个账户做了更改之后,切换到其他账户并切换回来,发现我们的之前的更改不会缓存。这里我们可以将输入框设计为一个完全可控组件,将更改的状态存在父组件中。
//父组件
export default class Release extends Component { state = { selectedIndex: 0, valueList: [...accounts] }; onChange = (event) => { const { valueList, selectedIndex } = this.state; valueList[selectedIndex].email = event.target.value; this.setState({ valueList: [...valueList] }); } render() { const { selectedIndex, valueList } = this.state; return ( <Fragment> <UncontrolledInput email={valueList[selectedIndex].email} onChange={this.onChange} /> <Radio.Group onChange={(e) => this.setState({ selectedIndex: e.target.value })} value={selectedIndex}> {valueList.map((account, index) => ( <Radio value={index}> {account.name} </Radio> ))} </Radio.Group> </Fragment> ); } }
//子组件
export default class UncontrolledInput extends Component { state = { email: this.props.email }; render() { return ( <div> Email: <Input onChange={this.props.onChange} value={this.props.email} /> </div> ); } }
替换方案:getDerivedStateFromProps
1.介绍
React在版本16.3之后,引入了新的生命周期函数getDerivedStateFromProps 需要注意的一点,在React 16.4^ 版本中getDerivedStateFromProps 比 16.3 版本中多了setState forceUpdate 两种触发方法。
详情请看官方给出的生命周期图。
2.使用
static getDerivedStateFromProps(nextProps,prevState){
//该方法内禁止访问this
if(nextProps.email !== prevState.email){ //通过对比nextProps和prevState,返回一个用于更新状态的对象 return { value:nextProps.email } } //不需要更新状态,返回null return null }
如果大家仍需要通过this.props来做一些事,可以使用componentDidUpdate
componentDidUpdate(prevProps, prevState, snapshot){ if(this.props.email){ // 做一些需要this.props的事 } }
通过以上使用方法,React相当于把componentWillReceiveProps拆分成getDerivedStateFromProps和componentDidUpdate。拆分后,使得派生状态更加容易预测。
3.常见误区
当我们在子组件内使用该方法来判断新props和state时,可能会引起内部更新无效。
//子组件
export default class UncontrolledInput extends Component { state = { email: this.props.email }; static getDerivedStateFromProps(props, state) { if (props.email !== state.email) { return { email: props.email }; } return null; } handleChange = event => { this.setState({ email: this.props.email }); }; render() { return ( <div> Email: <Input onChange={this.handleChange} value={this.state.email} style={style} /> </div> ); } }
这是因为在 React 16.4^ 的版本中,setState 和 forceUpdate 也会触发getDerivedStateFromProps方法。当我们尝试改变输入框值,触发setState方法,进而触发该方法,并把 state 值更新为传入的 props。虽然在getDerivedStateFromProps中,不能访问this.props,但是我们可以新加个字段来间接访问this.props进而判断新旧props。
export default class UncontrolledInput extends Component { state = { email: this.props.email, prevPropEmail: '' }; static getDerivedStateFromProps(props, state) { if (props.email !== state.prevPropEmail) { return { email: props.email, prevPropEmail: props.email, }; } return null; } handleChange = event => { this.setState({ email: this.props.email }); }; render() { return ( <div> Email: <Input onChange={this.handleChange} value={this.state.email} style={style} /> </div> ); } }
通过上一个props.email来判断是否更新,而不是通过state的状态。虽然解决了内部更新问题,但是并不能解决componentWillReceiveProps中提到的多个账户切换无法重置等问题。并且这样写的派生状态代码冗余,并使组件难以维护。
升级方案
我们在开发过程中很难保证每个数据都有明确的数据来源,尽量避免使用这两个生命周期函数。结合以上例子以及官网提供的方法,我们有以下升级方案: 1.完全受控组件(推荐) 2.key标识的完全不可控组件(推荐) 使用React的key属性。通过传入不同的key来重新构建组件。在极少情况,你可能需要在没有合适的ID作为key的情况下重置state,可以将需要重置的组件的key重新赋值为当前时间戳。虽然重新创建组件听上去会很慢,但其实对性能的影响微乎其微。并且如果组件具有很多更新上的逻辑,使用key甚至可以更快,因为该子树的diff得以被绕过。 3.通过唯一属性值重置非受控组件。 因为使用key值我们会重置子组件所有状态,当我们需要仅重置某些字段时或者子组件初始化代价很大时,可以通过判断唯一属性是否更改来保证重置组件内部状态的灵活性。 4.使用实例方法重置非受控组件。 当我们没有合适的特殊属性去匹配的时候,可以通过实例方法强制重置内部状态
//父组件
handleChange = index => { this.setState({ selectedIndex: index }, () => { const selectedAccount = accounts[index]; this.inputRef.current.resetEmailForNewUser(selectedAccount.email); }); }; //子组件 resetEmailForNewUser(defaultEmail) { this.setState({ email: defaultEmail }); }
总结
升级方案不仅仅以上几种,例如当我们仅仅需要当props更改进行数据提取或者动画时,可以使用componentDidUpdate。还可以参考官网提供的memoization(缓存记忆)。但是主要推荐的方案是完全受控组件和key值的完全不受控组件。当无法满足需求的特殊情况,再使用其他方法。总之,componentWillReceiveProps/getDerivedStateFromProps是一个拥有一定复杂度的高级特性,我们应该谨慎地使用。
欢迎关注前端早茶,与广东靓仔携手共同进阶
前端早茶专注前端,一起结伴同行,紧跟业界发展步伐~
公众号作者:广东靓仔