可靠React组件设计的7个准则之组合和复用

翻译:刘小夕

原文链接:https://dmitripavlutin.com/7-...

原文的篇幅非常长,不过内容太过于吸引我,还是忍不住要翻译出来。此篇文章对编写可重用和可维护的React组件非常有帮助。但因为篇幅实在太长,我对文章进行了分割,本篇文章重点阐述 组合和复用。因水平有限,文中部分翻译可能不够准确,如果你有更好的想法,欢迎在评论区指出。

更多文章可戳: https://github.com/YvetteLau/...

———————————————我是一条分割线————————————————

组合

一个组合式组件是由更小的特定组件组合而成的。

组合(composition)是一种通过将各组件联合在一起以创建更大组件的方式。组合是 React 的核心。

幸运的是,组合易于理解。把一组小的片段,联合起来,创建一个更大个儿。

可靠React组件设计的7个准则之组合和复用

让我们来看一个常见的前端应用组合模式。应用由头部的 header、底部的 footer、左侧的 sidebar,还有中部的有效内容联合而成:

可靠React组件设计的7个准则之组合和复用

<div id="root"></div>
function Application({ children }) {
    return (
        <div className="application box">
            <Label>Application</Label>
            {children}
        </div>
    );
}

function Header() {
    return (
        <div className="header box">
            <Label>Header</Label>
        </div>
    )
}

function Footer() {
    return (
        <div className="header box">
            <Label>Footer</Label>
        </div>
    )
}

function Sidebar({ children }) {
    return (
        <div className="sidebar box">
            <Label>Sidebar</Label>
            {children}
        </div>
    );
}

function Content({ children }) {
    return (
        <div className="content box">
            <Label>Content</Label>
            {children}
        </div>
    )
}

function Menu() {
    return (
        <div className="menu box">
            <Label>Menu</Label>
            <div className="description">
                <div className="text shorter" />
                <div className="text" />
                <div className="text shorter" />
                <div className="text shorter" />
            </div>
        </div>
    );
}

function Article() {
    return (
        <div className="article box">
            <Label>Article</Label>
            <div className="description">
                <div className="text shorter" /> <div className="text longer" />
                <div className="text shorter" /> <div className="text" />
                <div className="text shorter" /> <div className="text" />
                <div className="text" /> <div className="text shorter" />
                <div className="text shorter" /> <div className="text" />
                <div className="text" /> <div className="text shorter" />
                <div className="text shorter" /> <div className="text longer" />
                <div className="text shorter" /> <div className="longer" />
                <div className="text shorter" /> <div className="text" />
                <div className="text" /> <div className="text shorter" />
                <div className="text shorter" /> <div className="text" />
            </div>
        </div>
    );
}

function Label({ children }) {
    return <div className="label">&lt;{children}&gt;</div>
}

const app = (
    <Application>
        <Header />
        <Sidebar>
            <Menu />
        </Sidebar>
        <Content>
            <Article />
        </Content>
        <Footer />
    </Application>
);

ReactDOM.render(app, document.getElementById('root'));

应用程序演示了组合如何构建应用程序。这种组织这样组织代码即富于表现力又便于理解。

React 组件的组合是自然而然的。这个库使用了一个声明范式,从而不会抑制组合式的表现力。

<Application><Header><Sidebar> <Content><Footer> 组成. <Sidebar> 有一个 <Menu> 组件, <Content> 有一个 <Article> 组件.

那么组合与单一责任以及封装有什么联系呢?让我们一起看看:

单一责任原则描述了如何将需求拆分为组件,封装描述了如何组织这些组件,组合描述了如何将整个系统粘合在一起。

组合的好处

单一责任

组合的一个重要方面在于能够从特定的小组件组成复杂组件的能力。这种分而治之的方式帮助了被组合而成的复杂组件也能符合 SRP 原则。

回顾之前的代码片段,<Application> 负责渲染 headerfootersidebar 和主体区域。

将此职责分为四个子职责是有意义的,每个子职责由专门的组件实现,分别是<Header><Sidebar><Content><Footer>。随后,这些组件被粘合在 <Application>

现在来看看组合的好处:通过子组件分别实现单一职责的方式,使 <Application> 组件也符合单一责任原则。

可重用

组合有可重用的有点,使用组合的组件可以重用公共逻辑,

例如,组件 <Composed1><Composed2> 有一些公共代码:

const instance1 = (
    <Composed1>
    /* Specific to Composed1 code... */
    /* Common code... */
    </Composed1>
);
const instance2 = (
    <Composed2>
    /* Common code... */
    /* Specific to Composed2 code... */
    </Composed2>
);

代码复制是一个不好的实践(例如更改 Composed1 的代码时,也需要去更改Composed2 中的代码),那么如何使组件重用公共代码?

首先,将共同代码封装到一个新组件中,如 <Common> 中,然后

首先,在新组件中封装公共代码。其次,<Composed1><Composed2> 应该使用组合的方式来包含 <Common>组件,以避免代码重复,如下:

const instance1 = (
    <Composed1>
        <Piece1 />
        <Common />
    </Composed1>
);
const instance2 = (
    <Composed2>
        <Common />
        <Piece2 />
    </Composed2>
);

可重用的组件符合不重复自己(Don't repeat yourself)的原则。这种做法可以节省你的精力和时间,并且在后期,有利于代码维护。

灵活

react 中,一个组合式的组件通过给子组件传递 props 的方式,来控制其子组件。这就带来了灵活性的好处。

例如,有一个组件,它需要根据用户的设备显示信息,使用组合可以灵活地实现这个需求:

function ByDevice({ children: { mobile, other } }) {
    return Utils.isMobile() ? mobile : other;
}

<ByDevice>{{
    mobile: <div>Mobile detected!</div>,
    other: <div>Not a mobile device</div>
}}</ByDevice>

<ByDevice> 组合组件,对于移动设备,显示: Mobile detected!; 对于非移动设备,显示 Not a mobile device"

高效

用户界面可组合的层次结构,因此,组件的组合是一种构建用户界面的有效的方式。

注:DRY 原则理论上来说是没有问题的,但在实际应用是切忌死搬教条。它只能起指导作用,没有量化标准,否则的话理论上一个程序每一行代码都只能出现一次才行,这是非常荒谬的,其它的原则也是一样,起到的也只是指导性的作用。

复用

可重用的组件,一次编写多次使用。

想象一下,如果软件开发总是重复造轮子。那么当你编写代码时,不能使用任何已有库或工具。甚至在同一个应用中你都不能使用已经编写过的代码。在这种环境中,是否有可能在合理的时间内编写出一个应用呢?绝无可能。

此时应该到认识重用的重要性,使用已有的库或代码,而不是重复造轮子。

应用内的复用

根据“不要重复自己”(DRY)原则,每一条知识都必须在系统中具有单一,明确,权威的表示。这个原则建议避免重复。

代码重复增加了复杂性和维护工作,但没有增加显著的价值。逻辑更新迫使您修改应用程序中的所有重复代码。

重复问题可以用可复用组件来解决。一次编写,多次使用。

但是,复用并非毫无成本。只有一个组件符合单一责任原则并且具有合理的封装时,它是可复用的。

符合单一职责原则是必须的:

复用一个组件实际上就意味着复用其职责

只有一个职责的组件是最容易复用的。

但是,当一个组件错误地具有多个职责时,它的复用会增加大量的开销。你只想复用一个职责实现,但也会得到不必要的职责实现。比如,你只是想要一个香蕉,但是在你得到一个香蕉的同时,不得不被迫接受所有的丛林。

合理封装的组件。隐藏了内部实现,并且有明确的 props ,使得组件可以使用与多种需要复用的场合。

复用第三方库

某个工作日,你刚刚收到了为应用增加新特性的任务,在撩起袖子狂敲代码之前,先稍等几分钟。

你要做的工作在很大概率上已经被解决了。由于 react 非常流行以及其非常棒的开源社区,先搜索一下是否有已存在的解决方案是明智之举。

查看 brillout/awesome-react-components ,它有一个可复用的组件列表。

优秀的第三方库有结构性的影响,并且会推广最佳实践。以我的经验而言,最有影响的当属 react-routerredux

react-router 使用了声明式的路由来构建一个单页应用。使用 <Route>URL 和组件关联起来。当用户访问匹配的 URL 时,路由将渲染相应的组件。

reduxreact-redux 引入了单向和可预测的应用状态管理。可以将异步的和非纯的代码(例如 HTTP 请求)从组件中提取出来,从而符合单一职责原则并创建出 纯(pure)组件 或 几乎纯(almost-pure)的组件。

这里是一份检查清单可以确定第三方库是否值得使用,:
  • 文档:检查库是否具备有意义的 README.md 文件和详细的文档
  • 测试过的:可信赖库的一个显著特征就是有高的测试覆盖率
  • 维护:看看库作者创建新特性、修改bug及日常维护的频率

最后谢谢各位小伙伴愿意花费宝贵的时间阅读本文,如果本文给了您一点帮助或者是启发,请不要吝啬你的赞和Star,您的肯定是我前进的最大动力。https://github.com/YvetteLau/...

相关推荐