React学习(最终篇)—— 高阶应用:高阶组件(HOCs)
高阶组件高阶组件(higher-order components:以下简称HOC或HOC组件)是一个React组件复用的高级技巧。HOCs本身并不是React的API接口,他是React组件之间组织方式的一种模式。 具体来说,一个HOC组件是一个返回另外一个新组件的方法,如下面的代码: const EnhancedComponent = higherOrderComponent(WrappedComponent); 常规的React组件都是将传入的props值转换成一个UI返回,而高阶组件是将一个组件转换成另外一个组件。HOCs通常以第三方React组件库的方式呈现,比如Redux的 connect 和Relay的createContainer。 本文会讨论为什么HOCs非常有用,并且介绍如何开发自定义的HOCs。 HOCs用于组件代码共用
组件是React中代码重用的主要单元。但是随着应用的深入,开发者会发现一些模式对于一些传统的组件并不总是行之有效。下面这个例子,假设有一个名为 class CommentList extends React.Component { constructor() { super(); this.handleChange = this.handleChange.bind(this); this.state = { // "DataSource"是一个全局的数据源 comments: DataSource.getComments() }; } componentDidMount() { // 监听数据变更 DataSource.addChangeListener(this.handleChange); } componentWillUnmount() { // 清除注册事件 DataSource.removeChangeListener(this.handleChange); } handleChange() { // 当数据变更时更新组件的列表数据 this.setState({ comments: DataSource.getComments() }); } render() { return ( <div> {this.state.comments.map((comment) => ( <Comment comment={comment} key={comment.id} /> ))} </div> ); } } 随后,再创建一个组件来订阅监听数据的更新,也使用类似的模式: class BlogPost extends React.Component { constructor(props) { super(props); this.handleChange = this.handleChange.bind(this); this.state = { blogPost: DataSource.getBlogPost(props.id) }; } componentDidMount() { DataSource.addChangeListener(this.handleChange); } componentWillUnmount() { DataSource.removeChangeListener(this.handleChange); } handleChange() { this.setState({ blogPost: DataSource.getBlogPost(this.props.id) }); } render() { return <TextBlock text={this.state.blogPost} />; } }
可以想象在一个非常庞大的应用中,上面这种订阅 可以编写一个通用方法来创建类似 const CommentListWithSubscription = withSubscription( CommentList,(DataSource) => DataSource.getComments() ); const BlogPostWithSubscription = withSubscription( BlogPost,(DataSource,props) => DataSource.getBlogPost(props.id) });
当 // 方法第一个参数传入另外一个组件 function withSubscription(WrappedComponent,selectData) { // 然后在方法体中构建另外一个组件并返回 return class extends React.Component { constructor(props) { super(props); this.handleChange = this.handleChange.bind(this); this.state = { data: selectData(DataSource,props) }; } componentDidMount() { // 订阅DataSource的数据 DataSource.addChangeListener(this.handleChange); } componentWillUnmount() { DataSource.removeChangeListener(this.handleChange); } handleChange() { this.setState({ data: selectData(DataSource,this.props) }); } render() { // 在render返回的部分对传入的组件进行包装, // 将变更后的数据以data属性传入包装组件,并返回根据参数渲染之后的组件 // 如果这里利用ES6的"..."扩展属性 + assgin方法,可以组合更多的参数 return <WrappedComponent data={this.state.data} {...this.props} />; } }; } 需要注意的,一个HOC模式的组件不会修改传入的组件,更不会使用继承的方式去复制组件原有的功能。相反地,一个HOC模式的组件是通过组合的方式将原来的组件通过“容器组件”包装起来。概括的来说,HOC是一个零副作用的纯函数。 就像我们在例子中看到的,被包装的组件从容器获取所有的props属性,根据容器传入给他新属性值——
不要让源组件数据突变在HOC编码过程中,一定不能让组件产生数据突变: function logProps(InputComponent) { InputComponent.prototype.componentWillReceiveProps(nextProps) { console.log('Current props: ',this.props); console.log('Next props: ',nextProps); } // 实时上,这里返回的原始input只是一个映射值,因为它已经发生了突变 return InputComponent; } // EnhancedComponent 将在收到props时记录。 const EnhancedComponent = logProps(InputComponent); 上面的代码看似没毛病,但是存在一些隐藏的问题。 首先是输入的组件不能与HOC分开使用,比如例子中的 其次还存在更重要的问题是,如果还有另外一个HOC组件包装了 用数据突变的方式去实现HOCs是一种不完备的抽象,开发人员在使用这些HOCs时候必须知道某些实现细节,以避免与其他HOC组件或在自身的编码中与之产生冲突。 HOCs应该使用组合的方式来代替数据突变,下面的代码展示了使用容器如何包装输入组件以实现相同的功能: function logProps(WrappedComponent) { // 新创建一个组件 return class extends React.Component { //重载生命周期方法 componentWillReceiveProps(nextProps) { console.log('Current props: ',this.props); console.log('Next props: ',nextProps); } render() { // 对输入组件进行包装,利用ES6"..."扩展将参数原封不动的传入输入组件 return <WrappedComponent {...this.props} />; } } } 这一段代码和之前的数据突变例子具备相同的功能,同时能避免上面提到的问题,而且无论是class还是function定义的组件它都适用。由于是一个纯函数,所以即使对其继续使用HOC包装也不会有任何问题。 在前面的介绍中,HOCs和容器组件的实现模式有相似之处。容器组件是将高级组件和底层组件整合在一起形成连接的一部分。容器会管理各种各样的内容,例如:订阅、状态,以及将属性数据传递到子组件中以实现底层组件的渲染功能。容器组件是HOCs模式实现的一部分,可以将HOCs模式看作一个参数化的容器组件。 惯例:将无关的属性值传递到包装组件中HOCs为一个组件额外增加了一些特性,但是它不应该影响组件原有的功能。对于一个HOC组件来说,他应该和被包装的子组件有相似的输入接口、有相同的返回。 HOC组件应该将那些外部传入但是与HOC组件功能无关的参数按照被包装子组件接口定义的方式传递到子组件中。所以大部分HOC组件都会像下面这个编写render方法: render() { // 过滤掉在当前HOC组件中不需要传递的额外参数 const { extraProp,...passThroughProps } = this.props; // 需要注入到包装组件中的参数 const injectedProp = someStateOrInstanceMethod; // Pass props to wrapped component return ( <WrappedComponent injectedProp={injectedProp} {...passThroughProps} /> ); } 这个惯例能确保HOC具备不错的复用能力。 惯例:最大化组合性并不是所有HOC组件都是一样的。某些时候,它们仅仅需求接受一个参数,例如: const NavbarWithRouter = withRouter(Navbar); 通常情况下,HOC组件会接受额外的参数,下面的例子中一个配置对象 config 用于指定组件的数据依赖: const CommentWithRelay = Relay.createContainer(Comment,config); 最通用的的HOC组件声明方式是这样的: // React Redux's `connect` const ConnectedComment = connect(commentSelector,commentActions)(Comment); 看到这里可能还有点懵逼,但是把它拆开来看就明白了: // connect是一个返回另外一个方法的方法 const enhance = connect(commentListSelector,commentListActions); // connect返回的方法是一个HOC组件,这个HOC组件会返回一个与Redux store相互关联的组件 const ConnectedComment = enhance(CommentList); 换一种说法, 这个结构看起来令人困惑或者没有必要,但是他有一个非常有用的特性。由 // 例子用于实现这个过程 // const EnhancedComponent = connect(commentSelector)(withRouter(WrappedComponent)) // 有一个已定义的compose(f,g,h)方法,这个方法的执行效果就是不断的包装组件 // 效果等同于 (...args) => f(g(h(...args))) const enhance = compose( // 2个参数都是一个HOC组件 connect(commentSelector),withRouter ) const EnhancedComponent = enhance(WrappedComponent) 有很多第三方库都提供了类似于compose的方法。只要我们编写的HOC组件都使用这个模式,可以很好的延伸使用下去,而不必考虑参数模式。 惯例:包装组件名称以便于调试由HOCs模式创建的包装组件很难在React Developer Tools等调试工具中与原组件关联起来。为了便于调试,需要选择一个用于显示的名称表明它是一个HOC组件。 通用的实现技巧是包装被包装组件的名称。所以如果定义的高阶组件命名为 function withSubscription(WrappedComponent) { class WithSubscription extends React.Component {/* ... */} WithSubscription.displayName = `WithSubscription(${getDisplayName(WrappedComponent)})`; return WithSubscription; } function getDisplayName(WrappedComponent) { return WrappedComponent.displayName || WrappedComponent.name || 'Component'; } HOCs的坑对于刚使用React的开发人员来说,HOCs存在的一些隐性问题需要注意。 不要在render方法中去编码HOCs模式的实现代码React的对比算法(融合算法)使用组件的标记来确定子树是需要更新还是移除重建。如果组件返回的数据和之前返回的数据相同(===),React会递归的比较子树并更新有差异的部分,如果不相同,则会移除重建整个子树。 通常在使用组件时,并不需要去了解这个情况。但是如果是编写HOC组件就非常重要,这就意味着开发人员不能在render方法中去编写实现HOC的代码: render() { // 在每次渲染时,一个新的EnhancedComponent 组件都会被创建。 // 并且每次创建的EnhancedComponent实例都不一样 const EnhancedComponent = enhance(MyComponent); // 这样会导致这个组件的子树每次都会重建! return <EnhancedComponent />; } 这个问题并不仅仅是和性能有关,每次重建一个组件会导致组件以及子组件已有的状态都会丢失。我们应该将HOCs模式应用于组件之外,以保证组件的实例只被创建一次,确保每次渲染时,他的标记都是一致的。 在某些罕见的应用下需要动态的使用HOC组件,可以在组件的生命周期方法或其构造函数中构造HOC模式相关的代码。 静态方法必须复制某些时候,在React组件中顶一个静态方法非常有用。当在某个组件上使用HOC组件时,源组件会被容器组件包装起来,这就意味着新的组件并没有源组件的静态方法。 // 定义一个静态方法 WrappedComponent.staticMethod = function() {/*...*/} // 现在提供一个HOC模式 const EnhancedComponent = enhance(WrappedComponent); // 增强组件并没有静态方法 typeof EnhancedComponent.staticMethod === 'undefined' // true 为了解决这个问题,你必须将源组件上的静态方法拷贝到容器组件上: function enhance(WrappedComponent) { class Enhance extends React.Component {/*...*/} // 必须知道哪些静态方法需要拷贝 :( Enhance.staticMethod = WrappedComponent.staticMethod; return Enhance; } 上面的例子开发人员必须提前知道哪些静态方法需要被拷贝,我们可以利用hoist-non-react-statics这个扩展工具来自动拷贝所有非React定义的静态方法: import hoistNonReactStatic from 'hoist-non-react-statics'; function enhance(WrappedComponent) { class Enhance extends React.Component {/*...*/} hoistNonReactStatic(Enhance,WrappedComponent); return Enhance; } 另外一个解决方法是由底层组件的开发者去导出静态方法: // Instead of... MyComponent.someFunction = someFunction; export default MyComponent; // ...export the method separately... export { someFunction }; // ...and in the consuming module,import both import MyComponent,{ someFunction } from './MyComponent.js'; Refs并不会被传递在前面的惯例中介绍了将所有的props属性传递给被包装子组件的实现方法,但是需要明确的是Refs并不会被传递。这是因为Refs并不是一个真正的属性,对于React来说他是一个处理器。如果你给一个HOC组件添加一个ref,这个ref指向的是外层容器组件而非被包装的组件。 如果已经在编码中出现了这个问题,明智的解决方案是找到避免使用Refs特性的方法。有时候刚开始使用React开发的编程人员更喜欢使用ref胜过props。在不得不使用Refs的情况下,我们可以考虑将ref作为一个props参数的回调方法来使用: function Field({ inputRef,...rest }) { return <input ref={inputRef} {...rest} />; } // HOC包装Field const EnhancedField = enhance(Field); // render() <EnhancedField inputRef={(inputEl) => { // 指定一个回调函数,通过这个回调将ref通过props传递到外部 this.inputEl = inputEl }} /> // 然后直接使用回调 this.inputEl.focus(); (编辑:李大同) 【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容! |