Fork me on GitHub

React开发常用设计模式-集成第三方库

React 或许是构建 UI 的最佳选择之一。良好的设计与强大的支持,还有庞大的社区。但是,有些情况下,想要使用外部服务或想要集成一些完全不同的东西。众所周知,React 在底层与实际 DOM 有大量的交互并控制页面上渲染什么,基本上它是开发者与实际 DOM 间的桥梁。这也正是为什么 React 集成第三方组件有些麻烦的地方。

React

集成第三方库

接下来介绍如何安全地混用 React 和 jQuery 的 UI 插件。

示例

这个示例挑选了 tag-it 这个 jQuery 插件。它将无序列表转换成可以管理标签的输入框:

1
2
3
4
<ul>
<li>JavaScript</li>
<li>CSS</li>
</ul>

转换成:

react

要运行起来,需要引入 jQueyr、jQuery UI 和 tag-it插件。这是运行的代码

1
$('<dom element selector>').tagit();

选择 DOM 元素,然后调用 tagit()

现在,来创建一个简单的 React 应用,它将使用 jQuery 插件:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// Tags.jsx
class Tags extends React.Component {
render() {
return (
<ul>
{
this.props.tags.map(
(tag, i) => <li key={ i }>{ tag } </li>
)
}
</ul>
);
}
};

// App.jsx
class App extends React.Component {
constructor(props) {
super(props);

this.state = { tags: ['JavaScript', 'CSS' ] };
}
render() {
return (
<div>
<Tags tags={ this.state.tags } />
</div>
);
}
}

ReactDOM.render(<App />, document.querySelector('#container'));

App 类是入口。它使用了Tags组件,Tags 组件会根据传入的 tags 属性来展示无序列表。当 React 在页面上渲染列表时就有了<ul>标签,这样就可以和 jQuery 插件连接起来。

强制单通道渲染

首先,要做的就是强制 Tags 组件进行单通道渲染。这是因为当 React 在实际 DOM中添加完容器元素后,想将控制权交给 jQuery 。如果不做控制的话,那么 React 和 jQuery 将会操纵同一个 DOM 元素而彼此之间不知情。要实现单通道渲染,需要使用生命周期方法 shouldComponentUpdate,像这样:

1
2
3
4
5
6

class Tags extends React.Component {
shouldComponentUpdate() {
return false;
}
...

这里永远都返回 false ,想让组件知道永远不进行重新渲染。定义 shouldComponentUpdate 对于 React 组件来说,是让其知道是否触发 render 方法。这适用于的场景,因为想使用 React 来添加 HTML 标记,添加完后就不想再依靠 React 。

初始化插件

React 提供了 API 来访问实际 DOM 节点。需要在相应的节点上使用 ref 属性,稍后可以通过 this.refs 来访问 DOM 。componentDidMount 是最适合初始化 tag-it 插件的生命周期方法。这是因为当 React 将 render 方法返回的结果挂载到 DOM 时才调用此方法。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
class Tags extends React.Component {
...
componentDidMount() {
this.list = $(this.refs.list);
this.list.tagit();
}
render() {
return (
<ul ref='list'>
{
this.props.tags.map(
(tag, i) => <li key={ i }>{ tag } </li>
)
}
</ul>
);
}
...

上面的代码和 shouldComponentUpdate 一起使用就会使 React 渲染出有两项的 <ul>,然后 tag-it 会其转换成标签可编辑的插件。

使用 React 控制插件

假如说我们想要通过代码来为已经运行的 tag-it 插件添加新标签。这种操作将由 React 组件触发,并需要使用 jQuery API 。我们需要找到一种方式将数据传递给 Tags 组件,但同时还要保持单通道渲染。

为了说明整个过程,我们需要在 App 类中添加一个输入框和按钮,点击按钮时将输入框的值传给 Tags 组件。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
class App extends React.Component {
constructor(props) {
super(props);

this._addNewTag = this._addNewTag.bind(this);
this.state = {
tags: ['JavaScript', 'CSS' ],
newTag: null
};
}
_addNewTag() {
this.setState({ newTag: this.refs.field.value });
}
render() {
return (
<div>
<p>Add new tag:</p>
<div>
<input type='text' ref='field' />
<button onClick={ this._addNewTag }>Add</button>
</div>
<Tags
tags={ this.state.tags }
newTag={ this.state.newTag } />
</div>
);
}
}

我们使用内部状态来存储新添加的标签名称。每次点击按钮时,我就更新状态并触发 Tags 组件的重新渲染。但由于 shouldComponentUpdate的存在,页面上不会有任何的更新。唯一的变化就是得到 newTag属性的新值,另一个生命周期方法 componentWillReceiveProps 会捕获到属性的新值:

1
2
3
4
5
6
class Tags extends React.Component {
...
componentWillReceiveProps(newProps) {
this.list.tagit('createTag', newProps.newTag);
}
...

.tagit('createTag', newProps.newTag)是纯粹的 jQuery 代码。如果想调用第三方库的方法,componentWillReceiveProps是个不错的选择。

下面是 Tags 组件的完整代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
class Tags extends React.Component {
componentDidMount() {
this.list = $(this.refs.list);
this.list.tagit();
}
shouldComponentUpdate() {
return false;
}
componentWillReceiveProps(newProps) {
this.list.tagit('createTag', newProps.newTag);
}
render() {
return (
<ul ref='list'>
{
this.props.tags.map(
(tag, i) => <li key={ i }>{ tag } </li>
)
}
</ul>
);
}
};

结语

尽管 React 承担了操纵 DOM 树的工作,但仍可以集成第三方的库和服务。生命周期方法让在渲染过程中可以进行足够的控制,这样才能够完美地连接 React 和非 React 世界。

总结

React 已然成为最流行的 UI 构建库。它自带的 API 很棒,简单而强大。麻烦的部分是构建复杂应用的话, React 本身往往并不足够。有些概念必须要知道,才能做出正确的选择。由社区所提出的这些设计模式在大规模应用中运行良好。

本文标题:React开发常用设计模式-集成第三方库

文章作者:DRLong

发布时间:2018年06月14日 - 23:06

原始链接:https://duanruilong.github.io/2018/06/14/React开发常用设计模式-集成第三方库/ 复制文章链接==>

-------------我是一条分割线感谢您的阅读-------------
DRLong WeChat Pay

微信打赏

DRLong Alipay

支付宝打赏