在过去的几年,我经手过很多大大小小的React项目,在这个过程中,我不断的重复重复,逐渐的形成了一些模式,在这里分享给大家。

如果你是刚开始接触React,能看到这篇文章,只能说你很幸运 :)。

如果你没有接触过React,你可以跳过(3,6,8,10)节。

1.数据向下和向上传递

对于刚接触React新手,我通常都会告诉他们数据的传递模式,也就是父组件向子组件传递数据(比如一个对象,一个字符串等等),也可以是一个方法,使得父组件可以得到子组件的数据。

就像把一包薯片和一个对讲机传递到被困井下的矿工手上。

下图是最简单的模式 http://p0.qhimg.com/t01f27a564f7933eda2.png

(此图胜过千言万语)

父组件在左边,子组件在右边。连接两个组件的props允许信息在两个方向任意流动。

一个 props 是items,传递信息到子组件。 一个 props 是deleteitem,给子组件一个方法来告诉父组件(“ 删除这个item ”)。

2.修复HTML的input标签

关于React组件化的一个重要方面就是,如果HTML中的标签不能按照你想要的方式工作,你可以按照你的方式定义它。

当我创建一个页面,页面有很多用户输入框,第一步先处理这些标签。

http://p0.qhimg.com/t011e72115735f17d7a.png

还需要注意:

  • 输入框应该通过onChange方法返回输入值。
  • 确保输入值的类型与onChange返回值的类型相同,如果typeof props.value的类型是number,那么就需要将e.target.value的类型转换成number。
  • 一组单选按钮的功能和<Select>一样,只是UI不同。可以在你的应用中统一成一个组件(比如),然后通过传递ui="radio" 或者 ui="dropDown"来区分。

3.为input绑定唯一的ID

我们会为input绑定唯一的ID,但是为每一个input定义一个唯一的ID很费事。

你可以为每一对input/label标签生成一个随机ID,但是客户端和服务器端渲染的HTML无法匹配

所以,你可以写一个方法自增生成ID,如下

class  Input  extends  React.Component {
    constructor(props) {
        super(props);
        this.id  =  getNextId();
        this.onChange  =  this.onChange.bind(this);
    }

    onChange(e) {
        this.props.onChange(e.target.value);
    }

    render() {
        return (
            <label htmlFor={this.id}>
              {this.props.label}
              <input
                id={this.id}
                value={this.props.value}
                onChange={this.onChange}
              />
            </label>
        );
    }
}

如果每次调用getNextId()时,仅仅是一个数字自增,那么在服务器端渲染,这个数字将会无限大。所以在每次网络请求的时候需要重置这个数字。代码如下:

let count = 1;
export const resetId = () => {
    count = 1;
 }

export const getNextId = () => {
     return `element-id-${count++}`;
}

4.用props控制CSS

如果你想把不同CSS应用在不同的实例中(比如:普通按钮和高亮按钮),你可以传props来控制CSS。

表面看起来超级简单,但我保证有很多坑等你跳的。

个人觉得有三种实现的方法:

  • 使用主题

把许多CSS打包放到一起,然后使用属性themes来控制。比如:

<Button theme="secondary">Hello</Button>
  • 设置boolean属性

比如一些特殊的按钮需要倒角,但与你定义的主题不一致。

要么你去找UI,让它设计时保持一致,要么你就设置一个值为boolean的属性来区分:

<Button theme="secondary" rounded>Hello</Button>

类似HTML的二进制属性,所以你不需要写成rounded = [true]

  • 设置属性值

在某些情况下,您可能希望直接传递CSS属性的值(在组件中,将其设置为内联样式):

<Icon width="25" height="25" type="search" />

举个例子:

假设你正在创建一个链接组件,有三种主题,是否添加下划线是可选的。

http://p0.qhimg.com/t01a713bddd6de90fef.png

代码如下:

const Link = (props) => {
    let className = `link link--${props.theme}-theme`;
    if (!props.underline) className += ' link--no-underline';
    return <a  href={props.href}  className={className}>{props.children}</a>;
};

Link.propTypes = {
    theme: PropTypes.oneOf([
        'default', // primary color, no underline
        'blend', // inherit surrounding styles
        'primary-button', // primary color, solid block
    ]),

    underline: PropTypes.bool,
    href: PropTypes.string.isRequired,
    children: PropTypes.oneOfType([
        PropTypes.element,
        PropTypes.array,
        PropTypes.string,
    ]).isRequired,
};

Link.defaultProps = {
    theme: 'default',
    underline: false,
};

CSS:

.link--default-theme,
.link--blend-theme:hover {
    color: #D84315;
}

.link--blend-theme {
    color: inherit;
}

.link--default-theme:hover,
.link--blend-theme:hover {
    text-decoration: underline;
}

.link--primary-button-theme {
    display: inline-block;
    padding: 12px 25px;
    font-size: 18px;
    background: #D84315;
    color: white;
}

.link--no-underline {
    text-decoration: none;
}

5.动态组件

动态组件可以渲染任何一个组件。 它可以是一个动态的页面组件,来展示一堆页面中的某一个页面,比如:

import  HomePage  from  './HomePage.jsx';
import  AboutPage  from  './AboutPage.jsx';
import  UserPage  from  './UserPage.jsx';
import  FourOhFourPage  from  './FourOhFourPage.jsx';

const PAGES = {
    home: HomePage,
    about: AboutPage,
    user: UserPage,
};

const Page = (props) => {
    const Handler = PAGES[props.page] || FourOhFourPage;
    return  <Handler {...props} />
};

Page.propTypes  = {
    page:  PropTypes.oneOf(Object.keys(PAGES)).isRequired,
};

如果你把home,about 和 user 换成/,/about 和 /user,恭喜你,你已经把它变成了半个路由器了。

6.优化组件

当打开一个页面,input输入框自动获取光标,这会大大提升用户体验。

比如打开一个注册页面,光标自动获取到用户名输入栏。

有人在写这个组件的时候会想到,为input绑定一个id,然后通过document.getElementById('user-name-input').focus()来实现。

但我认为这并不是一个很好的方式,我有一个更好的实现方式:

class Input extends Component {
    focus() {
        this.el.focus();
    }

    render() {
        return (
            <input
                ref={el=> { this.el = el; }}
            />
        );
    }
}

ok,一个拥有focus()方法的Input组件完成了。

在父亲组件中,我们可以调到子组件的focus() 方法:

class SignInModal extends Component {
  componentDidMount() {
      this.InputComponent.focus();
  }

  render() {
      return (
          <div>
              <label>User name: </label>
              <Input
                  ref={comp => { this.InputComponent = comp; }}
              />
          </div>
      )
  }
}

注意,当您在一个组件上使用ref时,它是对组件(而不是底层元素)的引用,因此您可以访问它的方法。

7.别过早组件化

一个搜索组件,当你输入的时候,可以看到模糊查询到的列表,如下:

http://p0.qhimg.com/t0139015b40f8eabc37.png

当设计这个组件的时候,你可能会想:是否需要新建一个搜索结果组件searchResult来展示搜索结果,这个组件可能只需要几行HTML和CSS代码……但我曾告诫自己,当自己犹豫是否要新建的时候,就别新建。

这种情况我不会新建一个独立的组件,而是添加一个renderSearchResult方法,返回相应的DOM。如下:

const SearchSuggestions = (props) => {
    // renderSearchSuggestion() behaves as a pseduo SearchSuggestion component
    // keep it self contained and it should be easy to extract later if needed
    const renderSearchSuggestion = listItem => (
        <li  key={listItem.id}>{listItem.name} {listItem.id}</li>
    );

    return (
        <ul>
            {props.listItems.map(renderSearchSuggestion)}
        </ul>
    );
}

如果其他组件也有类似的需求,你应该复制粘贴代码到那个组件,而不是过早的组件化。

8.用于文本格式化的组件

这是一个Price组件,将数字处理成含或者不含小数点或者$符号的字符串。

const Price = (props) => {
    const price = props.children.toLocaleString('en', {
        style: props.showSymbol ? 'currency' : undefined,
        currency: props.showSymbol ? 'USD' : undefined,
        maximumFractionDigits: props.showDecimals ? 2 : 0,
    });
    return <span  className={props.className}>{price}</span>
};

Price.propTypes = {
    className: React.PropTypes.string,
    children: React.PropTypes.number,
    showDecimals: React.PropTypes.bool,
    showSymbol: React.PropTypes.bool,
};

Price.defaultProps = {
    children: 0,
    showDecimals: true,
    showSymbol: true,
};

const Page = () => {
    const lambPrice = 1234.567;
    const jetPrice = 999999.99;
    const bootPrice = 34.567;
    return (
        <div>
            <p>One lamb is <Price  className="expensive">{lambPrice}</Price></p>
            <p>One jet is <Price  showDecimals={false}>{jetPrice}</Price></p>
            <p>Those gumboots will set ya back <Price  showDecimals={false}  showSymbol={false}>{bootPrice}</Price> bucks.</p>
        </div>
    );
};

正如你所看到的,我用使用了一个强大的字符串格式化库,链接在这里

用更少的代码实现(我不是很喜欢):

function numberToPrice(num, options = {}) {
    const showSymbol = options.showSymbol !== false;
    const showDecimals = options.showDecimals !== false;
    return num.toLocaleString('en', {
        style: showSymbol ? 'currency' : undefined,
        currency: showSymbol ? 'USD' : undefined,
        maximumFractionDigits: showDecimals ? 2 : 0,
    });
}

const Page = () => {
    const lambPrice = 1234.567;
    const jetPrice = 999999.99;
    const bootPrice = 34.567;
    return (
    <div>
        <p>One lamb is <span  className="expensive">{numberToPrice(lambPrice)}</span></p>
        <p>One jet is {numberToPrice(jetPrice, { showDecimals: false })}</p>
        <p>Those gumboots will set ya back {numberToPrice(bootPrice, { showDecimals: false, showSymbol: false })} bucks.</p>
    </div>

    );

};

注意:我并没有检查传入数字的的有效性,是因为…………lan。

9.降低组件复杂度

我可能写过上千次这种判断:

if (props.user.signInStatus === SIGN_IN_STATUSES.SIGNED_IN)...

这是一个错误示范,我应该判断“用户是否登录”而不是判断“用户登录状态===登录”

我的组件已经够复杂了,不应该让它去考虑传入的价格是不是数字,亦或者boolean值是否是‘true’。

正如你所见,如果你的数据store和你的组件是相匹配的,那么你的组件将会简单得多。我以前就说过,“复杂”是bug的藏身之处。组件越简单,出bug的概率就越小。

但是“复杂”无法避免,如何处理呢?

我建议创建一个模块,来专门处理输入数据,比如重命名props,字符串转成数字,对象转成数组,数据字符串转成数据对象,等等。

全部在一个地方处理和测试。

如果你设置react/redux,你应该这样在action中写请求搜索结果:

fetch(`/api/search?${queryParams}`) 

    .then(response => response.json()) 

    .then(normalizeSearchResultsApiData) // 处理所有数据 

    .then(normalData => { 

    // 得到处理后的数据

});

这样会大大降低组件的复杂度。

10.不用相对路径来导入组件

别这样写:

**import** Button **from** '../../../../Button/Button.jsx';
**import** Icon **from** '../../../../Icon/Icon.jsx';
**import** Footer **from** '../../Footer/Footer.jsx';

要这样写:

import {Button, Icon, Footer} from 'Components';

理论上你可以这样实现:

  • 创建一个index.js做索引,让你所有的组件可以被引用。
  • 使用Webpack的 resolve.alias 来重定向组件的索引文件

我按照以上理论实现的时候发现这样做并不好,有三个原因:

  • Webpack 2删除了alias方法
  • eslint会报错,因为组件并没有在node_modules中。
  • 如果你用WebStorm,cmd/ctrl + 左键组件名的时候,会自动打开该组件文件。但是这个功能将会失效。

http://p0.qhimg.com/t01342d22dcd842d257.png

( 编辑: matthew hsiung 找到了eslint 和 WebStorm的解决方案。)

最后

写了很多,希望对您有帮助!

转载,原文链接