React 秘籍(二)
原文:
zh.annas-archive.org/md5/AADE5F3EA1B3765C530CB4A24FAA7E7E译者:飞龙
第三章:处理事件,绑定和有用的 React 包
在本章中,将涵盖以下示例:
-
使用构造函数绑定方法与使用箭头函数
-
创建带有事件的表单元素
-
使用 react-popup 在模态框中显示信息
-
实施 Airbnb React/JSX 样式指南
-
使用 React Helmet 更新我们的标题和 meta 标签
介绍
本章包含与处理事件、在 React 中绑定方法相关的示例,并且我们将实现一些最有用的 React 包。
使用构造函数绑定方法与使用箭头函数
在这个示例中,我们将学习在 React 中绑定方法的两种方式:使用构造函数和使用箭头函数。
如何做...
这个示例很简单,目标是使用类构造函数和箭头函数绑定方法:
- 让我们创建一个名为
Calculator的新组件。我们将创建一个带有两个输入和一个按钮的基本计算器。我们组件的框架如下:
import React, { Component } from 'react';
import './Calculator.css';
class Calculator extends Component {
constructor() {
super();
this.state = {
number1: 0,
number2: 0,
result: 0
};
}
render() {
return (
<div className="Calculator">
<input
name="number1"
type="text"
value={this.state.number1}
/>
{' + '}
<input
name="number2"
type="text"
value={this.state.number2}
/>
<p><button>=</button></p>
<p className="result">{this.state.result}</p>
</div>
);
}
}
export default Calculator;
文件:src/components/Calculator/Calculator.js
- 现在我们将添加两种新方法,一种用于处理输入(
onChange事件),一种用于管理结果按钮(onClick)。我们可以使用相同的handleOnChange方法来处理两个输入。由于我们有字段的名称(与状态相同),我们可以动态更新每个状态,在handleResult方法中,我们只需对两个数字求和。
handleOnChange(e) {
const { target: { value, name } } = e;
this.setState({
[name]: Number(value)
});
}
handleResult(e) {
this.setState({
result: this.state.number1 + this.state.number2
});
}
- 现在在我们的
render方法中,我们需要为输入和按钮添加事件:
render() {
return (
<div className="Calculator">
<input
onChange={this.handleOnChange}
name="number1"
type="text"
value={this.state.number1}
/>
{' + '}
<input
onChange={this.handleOnChange}
name="number2"
type="text"
value={this.state.number2}
/>
<p>
<button onClick={this.handleResult}>=</button>
</p>
<p className="result">{this.state.result}</p>
</div>
);
}
- 我们的 CSS 代码如下:
.Calculator {
margin: 0 auto;
padding: 50px;
}
.Calculator input {
border: 1px solid #eee;
font-size: 16px;
text-align: center;
height: 50px;
width: 100px;
}
.Calculator button {
background: #0072ff;
border: none;
color: #fff;
font-size: 16px;
height: 54px;
width: 150px;
}
.Calculator .result {
border: 10px solid red;
background: #eee;
margin: 0 auto;
font-size: 24px;
line-height: 100px;
height: 100px;
width: 100px;
}
文件:src/components/Calculator/Calculator.css
- 如果您现在运行应用程序,您会发现如果尝试在输入框中输入内容或单击按钮,您将收到如下错误:
- 原因是我们需要将这些方法绑定到类上才能访问它。让我们首先使用构造函数绑定我们的方法:
constructor() {
super();
this.state = {
number1: 0,
number2: 0,
result: 0
};
// Binding methods
this.handleOnChange = this.handleOnChange.bind(this);
this.handleResult = this.handleResult.bind(this);
}
- 如果您想要在组件顶部列出所有方法,使用构造函数绑定方法是一个不错的选择。如果您查看
Calculator组件,它应该是这样的:
- 现在让我们使用箭头函数来自动绑定我们的方法,而不是在构造函数中进行绑定。为此,您需要在构造函数中删除绑定方法,并将
handleOnChange和handleResult方法更改为箭头函数:
constructor() {
super();
this.state = {
number1: 0,
number2: 0,
result: 0
};
}
// Changing this method to be an arrow function
handleOnChange = e => {
const { target: { value, name } } = e;
this.setState({
[name]: Number(value)
});
}
// Changing this method to be an arrow function
handleResult = e => {
this.setState({
result: this.state.number1 + this.state.number2
});
}
- 你会得到相同的结果。我更喜欢使用箭头函数来绑定方法,因为你使用的代码更少,而且你不需要手动将方法添加到构造函数中。
它是如何工作的...
如你所见,你有两种选项来绑定你的 React 组件中的方法。目前最常用的是构造函数选项,但箭头函数变得越来越受欢迎。你可以决定哪种绑定选项你最喜欢。
使用事件创建表单元素
你可能已经注意到在上一章中,我们使用了一些简单的带有事件的表单,但在这个示例中,我们将更深入地了解这个主题。在第六章中,使用 Redux Form 创建表单,我们将学习如何处理带有 Redux Form 的表单。
如何做到...
让我们创建一个名为Person的新组件:
- 我们将在此组件中使用的骨架如下:
import React, { Component } from 'react';
import './Person.css';
class Person extends Component {
constructor() {
super();
this.state = {
firstName: '',
lastName: '',
email: '',
phone: ''
};
}
render() {
return (
<div className="Person">
</div>
);
}
}
export default Person;
文件:src/components/Person/Person.js
- 让我们向我们的表单添加
firstName,lastName,email和phone字段。render方法应该如下所示:
render() {
return (
<div className="Person">
<form>
<div>
<p><strong>First Name:</strong></p>
<p><input name="firstName" type="text" /></p>
</div>
<div>
<p><strong>Last Name:</strong></p>
<p><input name="lastName" type="text" /></p>
</div>
<div>
<p><strong>Email:</strong></p>
<p><input name="email" type="email" /></p>
</div>
<div>
<p><strong>Phone:</strong></p>
<p><input name="phone" type="tel" /></p>
</div>
<p>
<button>Save Information</button>
</p>
</form>
</div>
);
}
- 让我们为我们的表单使用这些 CSS 样式:
.Person {
margin: 0 auto;
}
.Person form input {
font-size: 16px;
height: 50px;
width: 300px;
}
.Person form button {
background: #0072ff;
border: none;
color: #fff;
font-size: 16px;
height: 50px;
width: 300px;
}
文件:src/components/Person/Person.css
- 如果你运行你的应用程序,你应该看到这个视图:
- 让我们在输入中使用我们的本地状态。在 React 中,我们从输入中检索值的唯一方法是将每个字段的值连接到特定的本地状态,就像这样:
render() {
return (
<div className="Person">
<form>
<div>
<p><strong>First Name:</strong></p>
<p>
<input
name="firstName"
type="text"
value={this.state.firstName}
/>
</p>
</div>
<div>
<p><strong>Last Name:</strong></p>
<p>
<input
name="lastName"
type="text"
value={this.state.lastName}
/>
</p>
</div>
<div>
<p><strong>Email:</strong></p>
<p>
<input
name="email"
type="email"
value={this.state.email}
/>
</p>
</div>
<div>
<p><strong>Phone:</strong></p>
<p>
<input
name="phone"
type="tel"
value={this.state.phone}
/>
</p>
</div>
<p>
<button>Save Information</button>
</p>
</form>
</div>
);
}
如果你尝试输入一些内容,你会注意到你无法写任何东西,这是因为所有的输入都连接到本地状态,我们更新本地状态的唯一方法是重新渲染已输入的文本。
- 正如你所想象的,我们更新本地状态的唯一方法是检测输入的变化,这将在用户输入时发生。让我们为
onChange事件添加一个方法:
handleOnChange = e => {
const { target: { value } } = e;
this.setState({
firstName: value
});
}
就像我在上一个示例中提到的,当我们在方法中使用箭头函数时,我们会自动将类绑定到方法。否则,你需要在构造函数中绑定方法。在我们的firstName输入中,我们需要在onChange方法中调用这个方法:
<input
name="firstName"
type="text"
value={this.state.firstName}
onChange={this.handleOnChange}
/>
- 但是这里有一个问题。如果我们有四个字段,那么您可能会认为您需要创建四种不同的方法(每个状态一个),但是有一种更好的解决方法:在
e (e.target.name)对象中获取输入名称的值。这样,我们可以使用相同的方法更新所有状态。我们的handleOnChange方法现在应该是这样的:
handleOnChange = e => {
const { target: { value, name } } = e;
this.setState({
[name]: value
});
}
- 通过对象中的
([name])语法,我们可以动态更新表单中的所有状态。现在我们需要将这个方法添加到所有输入的onChange中。完成后,您将能够在输入框中输入内容:
render() {
return (
<div className="Person">
<form>
<div>
<p><strong>First Name:</strong></p>
<p>
<input
name="firstName"
type="text"
value={this.state.firstName}
onChange={this.handleOnChange}
/>
</p>
</div>
<div>
<p><strong>Last Name:</strong></p>
<p>
<input
name="lastName"
type="text"
value={this.state.lastName}
onChange={this.handleOnChange}
/>
</p>
</div>
<div>
<p><strong>Email:</strong></p>
<p>
<input
name="email"
type="email"
value={this.state.email}
onChange={this.handleOnChange}
/>
</p>
</div>
<div>
<p><strong>Phone:</strong></p>
<p>
<input
name="phone"
type="tel"
value={this.state.phone}
onChange={this.handleOnChange}
/>
</p>
</div>
<p>
<button>Save Information</button>
</p>
</form>
</div>
);
}
- 所有表单都需要提交它们从用户那里收集到的信息。我们需要使用表单的
onSubmit事件,并调用handleOnSubmit方法通过本地状态检索所有输入值:
handleOnSubmit = e => {
// The e.preventDefault() method cancels the event if it is
// cancelable, meaning that the default action that belongs to
// the event won't occur.
e.preventDefault();
const { firstName, lastName, email, phone } = this.state;
const data = {
firstName,
lastName,
email,
phone
};
// Once we have the data collected we can call a Redux Action
// or process the data as we need it.
console.log('Data:', data);
}
- 创建完这个方法后,我们需要在
form标签的onSubmit事件上调用它:
<form onSubmit={this.handleOnSubmit}>
- 现在您可以测试这个。打开您的浏览器控制台,当您在输入框中输入一些值时,您将能够看到数据:
- 我们需要验证必填字段。假设
firstName和lastName字段是必填的。如果用户没有在字段中填写值,我们希望添加一个错误类来显示输入框周围的红色边框。您需要做的第一件事是为错误添加一个新的本地状态:
this.state = {
firstName: '',
lastName: '',
email: '',
phone: '',
errors: {
firstName: false,
lastName: false
}
};
- 您可以在这里添加任何您想要验证的字段,并且值是布尔值(
true表示有错误,false表示没有错误)。然后,在handleOnSubmit方法中,如果有错误,我们需要更新状态:
handleOnSubmit = e => {
// The e.preventDefault() method cancels the event if it is
// cancelable, meaning that the default action that belongs to
// event won't occur.
e.preventDefault();
const { firstName, lastName, email, phone } = this.state;
// If firstName or lastName is missing then we update the
// local state with true
this.setState({
errors: {
firstName: firstName === '',
lastName: lastName === ''
}
});
const data = {
firstName,
lastName,
email,
phone
};
// Once we have the data collected we can call a Redux Action
// or process the data as we need it.
console.log('Data:', data);
}
- 现在,在您的
render方法中,您需要在firstName和lastName字段的className属性中添加一个三元验证,如果您想要更花哨,您还可以在输入框下方添加一个错误消息:
render() {
return (
<div className="Person">
<form onSubmit={this.handleOnSubmit}>
<div>
<p><strong>First Name:</strong></p>
<p>
<input
name="firstName"
type="text"
value={this.state.firstName}
onChange={this.handleOnChange}
className={
this.state.errors.firstName ? 'error' : ''
}
/>
{this.state.errors.firstName
&& (<div className="errorMessage">Required
field</div>)}
</p>
</div>
<div>
<p><strong>Last Name:</strong></p>
<p>
<input
name="lastName"
type="text"
value={this.state.lastName}
onChange={this.handleOnChange}
className={
this.state.errors.lastName ? 'error' : ''
}
/>
{this.state.errors.lastName
&& <div className="errorMessage">Required
field</div>}
</p>
</div>
<div>
<p><strong>Email:</strong></p>
<p>
<input
name="email"
type="email"
value={this.state.email}
onChange={this.handleOnChange}
/>
</p>
</div>
<div>
<p><strong>Phone:</strong></p>
<p>
<input name="phone" type="tel" value=
{this.state.phone}
onChange={this.handleOnChange} />
</p>
</div>
<p>
<button>Save Information</button>
</p>
</form>
</div>
);
}
- 最后一步是添加错误类,
.error和.errorMessage:
.Person .error {
border: 1px solid red;
}
.Person .errorMessage {
color: red;
font-size: 10px;
}
- 如果您现在提交表单而没有填写
firstName或lastName,您将会得到这个视图:
- 完整的
Person组件应该是这样的:
import React, { Component } from 'react';
import './Person.css';
class Person extends Component {
constructor() {
super();
this.state = {
firstName: '',
lastName: '',
email: '',
phone: '',
errors: {
firstName: false,
lastName: false
}
};
}
handleOnChange = e => {
const { target: { value, name } } = e;
this.setState({
[name]: value
});
}
handleOnSubmit = e => {
// The e.preventDefault() method cancels the event if it is
// cancelable, meaning that the default action that belongs
// to the event won't occur.
e.preventDefault();
const { firstName, lastName, email, phone } = this.state;
// If firstName or lastName is missing we add an error class
this.setState({
errors: {
firstName: firstName === '',
lastName: lastName === ''
}
});
const data = {
firstName,
lastName,
email,
phone
};
// Once we have the data collected we can call a Redux Action
// or process the data as we need it.
console.log('Data:', data);
}
render() {
return (
<div className="Person">
<form onSubmit={this.handleOnSubmit}>
<div>
<p><strong>First Name:</strong></p>
<p>
<input
name="firstName"
type="text"
value={this.state.firstName}
onChange={this.handleOnChange}
className={
this.state.errors.firstName ? 'error' : ''
}
/>
{this.state.errors.firstName
&& <div className="errorMessage">Required
field</div>}
</p>
</div>
<div>
<p><strong>Last Name:</strong></p>
<p>
<input
name="lastName"
type="text"
value={this.state.lastName}
onChange={this.handleOnChange}
className={
this.state.errors.lastName ? 'error' : ''
}
/>
{this.state.errors.lastName
&& <div className="errorMessage">Required
field</div>}
</p>
</div>
<div>
<p><strong>Email:</strong></p>
<p>
<input
name="email"
type="email"
value={this.state.email}
onChange={this.handleOnChange}
/>
</p>
</div>
<div>
<p><strong>Phone:</strong></p>
<p>
<input
name="phone"
type="tel"
value={this.state.phone}
onChange={this.handleOnChange}
/>
</p>
</div>
<p>
<button>Save Information</button>
</p>
</form>
</div>
);
}
}
export default Person;
文件:src/components/Person/Person.js
它是如何工作的...
表单对于任何 web 应用程序都是必不可少的,使用 React 处理它们很容易,可以使用本地状态,但这不是管理它们的唯一方式。如果您的表单很复杂,有多个步骤(通常用于用户注册),您可能需要在整个过程中保留值。在这种情况下,使用 Redux Form 轻松处理表单,我们将在第六章中学习,创建 Redux Form 表单。
还有更多...
在 React 中还有更多事件可以使用:
键盘事件:
-
onKeyDown当按键被按下时执行 -
onKeyPress在释放按键后执行,但在触发onKeyUp之前 -
onKeyUp在按键按下后执行
焦点事件:
-
onFocus当控件获得焦点时执行 -
onBlur当控件失去焦点时执行
表单事件:
-
onChange当用户更改表单控件中的值时执行 -
onSubmit是<form>的一个特定属性,当按下按钮或用户在字段内按下return键时调用
鼠标事件:
-
onClick当鼠标按钮被按下并释放时 -
onContextMenu当按下右键时 -
onDoubleClick当用户执行双击时 -
onMouseDown当鼠标按钮被按下时 -
onMouseEnter当鼠标移动到元素或其子元素上时 -
onMouseLeave当鼠标离开元素时 -
onMouseMove当鼠标移动时 -
onMouseOut当鼠标移出元素或移动到其子元素上时 -
onMouseOver当鼠标移动到元素上时 -
onMouseUp当鼠标按钮释放时
拖放事件:
-
onDrag -
onDragEnd -
onDragEnter -
onDragExit -
onDragLeave -
onDragOver -
onDragStart -
onDrop
对于拖放事件,我建议使用 react-dnd (github.com/react-dnd/react-dnd) 库。
使用 react-popup 在模态框中显示信息
模态框是显示在当前窗口上的对话框/弹出窗口,几乎适用于所有项目。在这个示例中,我们将学习如何使用 react-popup 包实现一个基本的模态框。
准备就绪
对于这个示例,您需要安装 react-popup。让我们用这个命令来做:
npm install react-popup
如何做...
使用上一个示例的代码,我们将添加一个基本的弹出窗口,以显示我们在表单中注册的人的信息:
- 打开你的
App.jsx文件,并从react-popup中导入Popup对象。现在,我们将导入Popup.css(代码太大,无法放在这里,但你可以从该项目的代码库中复制和粘贴 CSS 演示代码:Chapter03/Recipe3/popup/src/components/Popup.css)。然后,在<Footer />之后添加<Popup />组件:
import React from 'react';
import Popup from 'react-popup';
import Person from './Person/Person';
import Header from '../shared/components/layout/Header';
import Content from '../shared/components/layout/Content';
import Footer from '../shared/components/layout/Footer';
import './App.css';
import './Popup.css';
const App = () => (
<div className="App">
<Header title="Personal Information" />
<Content>
<Person />
</Content>
<Footer />
<Popup />
</div>
);
export default App;
文件:src/components/App.js
- 现在,在我们的
Person.js文件中,我们也需要包含弹出窗口:
import React, { Component } from 'react';
import Popup from 'react-popup';
import './Person.css';
- 让我们修改我们的
handleOnSubmit方法来实现弹出窗口。首先,我们需要验证我们至少收到了firstName、lastName和email(电话是可选的)。如果我们得到了所有必要的信息,那么我们将创建一个弹出窗口并显示用户的信息。我喜欢react-popup的一点是它允许我们在其内容中使用 JSX 代码:
handleOnSubmit = e => {
e.preventDefault();
const {
firstName,
lastName,
email,
phone
} = this.state;
// If firstName or lastName is missing we add an error class
this.setState({
errors: {
firstName: firstName === '',
lastName: lastName === ''
}
});
// We will display the popup just if the data is received...
if (firstName !== '' && lastName !== '' && email !== '') {
Popup.create({
title: 'Person Information',
content: (
<div>
<p><strong>Name:</strong> {firstName} {lastName}</p>
<p><strong>Email:</strong> {email}</p>
{phone && <p><strong>Phone:</strong> {phone}</p>}
</div>
),
buttons: {
right: [{
text: 'Close',
action: popup => popup.close() // Closes the popup
}],
},
});
}
}
它是如何工作的...
如果你做的一切正确,你应该能够看到这样的弹出窗口:
如你在代码中所见,电话是可选的,所以如果我们不包括它,我们就不会渲染它:
还有更多...
react-popup提供配置来执行一个动作。在我们的例子中,我们使用该动作来在用户按下Close按钮时关闭弹出窗口,但我们可以传递 Redux 动作来做其他事情,比如发送一些信息,甚至在我们的弹出窗口内添加表单。
实施 Airbnb React/JSX 风格指南
Airbnb React/JSX 风格指南是 React 编码中最受欢迎的风格指南。在这个教程中,我们将实现带有 Airbnb React/JSX 风格指南规则的 ESLint。
准备工作
要实施 Airbnb React/JSX 风格指南,我们需要安装一些包,比如eslint、eslint-config-airbnb、eslint-plugin-babel和eslint-plugin-react。
我不喜欢强迫任何人使用特定的 IDE,但我想推荐一些最好的编辑器来与 React 一起工作。
-
Atom -
atom.io -
在我个人看来,Atom 是与 React 一起工作的最佳 IDE。在这个教程中,我们将使用 Atom。
-
优点:
-
MIT 许可证(开源)
-
易于安装和配置
-
有很多插件和主题
-
与 React 完美配合
-
支持 Mac、Linux 和 Windows
-
您可以使用 Nuclide 来进行 React Native 开发(nuclide.io)
-
缺点:
-
与其他 IDE 相比速度较慢(如果你有 8GB 的 RAM,应该没问题)
-
Visual Studio Code(VSC)-
code.visualstudio.com -
VSC 是另一个用于 React 的好的 IDE。
-
优点:
-
MIT 许可证(开源)
-
易于安装
-
它有很多插件和主题。
-
与 React 完美配合
-
支持 Mac、Linux 和 Windows
-
缺点:
-
微软(我不是微软的大粉丝)
-
在开始时配置可能会令人困惑
-
Sublime Text -
www.sublimetext.com -
Sublime Text 是我的初恋,但我不得不承认 Atom 已经取代了它。
-
优点:
-
易于安装
-
有很多插件和主题
-
支持 Mac、Linux 和 Windows
-
缺点:
-
不是免费的(每个许可证 80 美元)。
-
仍然不够成熟来用于 React。
-
有些插件很难配置。
安装所有必要的包:
npm install eslint eslint-config-airbnb eslint-plugin-react eslint-plugin-jsx-a11y
有一些 Airbnb React/JSX Style Guide 的规则我宁愿不使用或者稍微改变默认值,但这取决于你是否保留它们或者移除它们。
你可以在官方网站(eslint.org/docs/rules)上检查所有的 ESLint 规则,以及在github.com/yannickcr/eslint-plugin-react/tree/master/docs/rules上检查所有特殊的 React ESLint 规则。
我宁愿不使用的规则或者我宁愿改变默认值的规则如下:
-
comma-dangle: 关闭 -
arrow-parens: 关闭 -
max-len: 120 -
no-param-reassign: 关闭 -
function-paren-newline: 关闭 -
react/require-default-props: 关闭
如何做...
为了启用我们的 ESLint,我们需要创建一个.eslintrc文件,并添加我们想要关闭的规则:
- 创建
.eslintrc文件。你需要在根目录下创建一个名为.eslintrc的新文件:
{
"parser": "babel-eslint",
"extends": "airbnb",
"rules": {
"arrow-parens": "off",
"comma-dangle": "off",
"function-paren-newline": "off",
"max-len": [1, 120],
"no-param-reassign": "off",
"react/require-default-props": "off"
}
}
- 添加一个脚本来运行代码检查工具。在你的
package.json文件中,你需要添加一个新的脚本来运行代码检查工具:
{
"name": "airbnb",
"version": "0.1.0",
"private": true,
"engines": {
"node": ">= 10.8"
},
"dependencies": {
"eslint": "⁴.18.2",
"eslint-config-airbnb": "¹⁶.1.0",
"eslint-plugin-babel": "⁴.1.2",
"eslint-plugin-react": "⁷.7.0",
"prop-types": "¹⁵.6.1",
"react": "¹⁶.2.0",
"react-dom": "¹⁶.2.0",
"react-scripts": "1.1.0"
},
"scripts": {
"start": "react-scripts start",
"build": "react-scripts build",
"test": "react-scripts test --env=jsdom",
"eject": "react-scripts eject",
"lint": "eslint --ext .jsx,.js src"
}
}
- 一旦你添加了
lint脚本,你可以用这个命令运行代码检查工具验证:
npm run lint
- 现在你可以看到你项目中的代码检查工具错误:
- 现在我们需要修复代码检查工具的错误。第一个错误是 Component 应该被写成一个纯函数
react/prefer-stateless-function。这意味着我们的App组件可以被写成一个函数组件,因为我们不使用任何本地状态:
import React from 'react';
import Person from './Person/Person';
import Header from '../shared/components/layout/Header';
import Content from '../shared/components/layout/Content';
import Footer from '../shared/components/layout/Footer';
import './App.css';
const App = () => (
<div className="App">
<Header title="Personal Information" />
<Content>
<Person />
</Content>
<Footer />
</div>
);
export default App;
文件:src/components/App.js
- 接下来,我们有这个错误:不允许在扩展名为'
.js'的文件中使用 JSX/react/jsx-filename-extension。这个错误意味着在我们使用 JSX 代码的文件中,我们需要使用.jsx扩展名,而不是.js。我们有六个文件出现了这个问题(App.js,Person.js,index.js,Content.js,Footer.js和Header.js)。我们只需要重命名这些文件并将扩展名改为.jsx(App.jsx,Person.jsx,Content.jsx,Footer.jsx和Header.jsx)。由于react-scripts,我们暂时不会将我们的index.js改为index.jsx。否则,我们会得到这样的错误:
在第十章*,精通 Webpack 4.x*中,我们将能够将所有的 JSX 文件重命名为
.jsx扩展名。
- 我们需要抑制 linter 错误。我们必须在我们的
index.js文件顶部写下这个注释:
/* eslint react/jsx-filename-extension: "off" */
import React from 'react';
...
- 让我们来看看这个错误:在这个开括号后面期望有一个换行符/
object-curly-newline,以及这个错误:在这个闭括号前面期望有一个换行符/object-curly-newline。在我们的Person.jsx文件中,在handleOnChange方法中有这个对象:
const { firstName, lastName, email, phone } = this.state;
- 规则说我们需要在对象之前和之后添加一个换行符:
const {
firstName,
lastName,
email,
phone
} = this.state;
- 现在让我们看看警告:意外的控制台语句/no-console。console.log 在我们的 linter 中生成了一个警告,这不会影响我们,但如果你需要有一个控制台并且想要避免警告,你可以通过 ESLint 注释添加一个异常,就像这样:
console.log('Data:', data); // eslint-disable-line no-console
- 更多的 ESLint 注释可以做同样的事情:
// eslint-disable-next-line no-console
console.log('Data:', data);
- 如果你想在整个文件中禁用控制台,那么在文件开头你可以这样做:
/* eslint no-console: "off" */
import React, { Component } from 'react';
...
- 错误:'document'未定义/no-undef。在我们的
index.jsx中使用全局对象 document 时,有两种方法可以修复这个错误。第一种方法是添加一个特殊的注释来指定 document 对象是一个全局变量:
/* global document */
import React from 'react';
import ReactDOM from 'react-dom';
...
- 我不喜欢这种方式。我更喜欢在我们的
.eslintrc文件中添加一个globals节点:
{
"parser": "babel-eslint",
"extends": "airbnb",
"globals": {
"document": "true"
},
"rules": {
"arrow-parens": "off",
"comma-dangle": "off",
"function-paren-newline": "off",
"max-len": [1, 120],
"no-param-reassign": "off",
"react/require-default-props": "off"
}
}
它是如何工作的...
linter 验证对于任何项目都是必不可少的。有时,这是一个讨论的话题,因为大多数开发人员不喜欢遵循标准,但一旦每个人都熟悉了这个样式指南,一切都会更加舒适,你将会交付更高质量的代码。
到目前为止,我们知道如何在终端中运行 linter 验证,但你也可以将 ESLint 验证器添加到你的 IDE(Atom 和 VSC)。在这个例子中,我们将使用 Atom。
安装 Atom 插件
在 Atom(Mac 上)中,你可以转到首选项|+安装,然后你可以找到 Atom 插件。我会给你一个我用来改进我的 IDE 并提高我的生产力的插件列表:
-
linter-eslint:使用 ESLint 实时 lint JS -
editorconfig:帮助开发人员在不同的编辑器之间保持一致的编码风格 -
language-babel:支持 React 语法 -
minimap:全源代码的预览 -
pigments:在项目和文件中显示颜色的包 -
sort-lines:对你的行进行排序 -
teletype:与团队成员共享你的工作区,并允许他们实时协作编码
安装了这些包之后,如果你打开一个有 lint 错误的文件,你将能够看到它们:
配置 EditorConfig
当我们团队中的人使用不同的编辑器时,EditorConfig 也非常有用,可以帮助维护一致的编码风格。EditorConfig 得到了许多编辑器的支持。你可以在官方网站editorconfig.org上检查你的编辑器是否得到支持。
我使用的配置是这样的;你需要在你的根目录下创建一个名为.editorconfig的文件:
root = true
[*]
indent_style = space
indent_size = 2
end_of_line = lf
charset = utf-8
trim_trailing_whitespace = true
insert_final_newline = true
[*.html]
indent_size = 4
[*.css]
indent_size = 4
[*.md]
trim_trailing_whitespace = false
你可以影响所有的文件[],也可以使用[.extension]来影响特定的文件**.**
还有更多...
在我们的 IDE 中运行 linter 验证或者通过终端运行是不够的,不能确保我们将 100%验证我们的代码,并且不会向我们的 Git 存储库中注入任何 linter 错误。确保我们将经过验证的代码发送到我们的 Git 存储库的最有效方法是使用 Git hooks。这意味着你在执行提交之前(pre-commit)或推送之前(pre-push)运行 linter 验证器。我更喜欢在 pre-commit 上运行 linter,而在 pre-push 上运行单元测试(我们将在第十二章中介绍单元测试).
Husky 是我们将用来修改 Git hooks 的包;你可以使用以下命令安装它:
npm install husky
一旦我们添加了这个包,我们需要修改我们的package.json并添加新的脚本:
{
"name": "airbnb",
"version": "0.1.0",
"private": true,
"dependencies": {
"eslint": "⁴.18.2",
"eslint-config-airbnb": "¹⁶.1.0",
"eslint-plugin-babel": "⁴.1.2",
"eslint-plugin-jsx-a11y": "⁶.0.3",
"eslint-plugin-react": "⁷.7.0",
"husky": "⁰.14.3",
"prop-types": "¹⁵.6.1",
"react": "¹⁶.2.0",
"react-dom": "¹⁶.2.0",
"react-scripts": "1.1.0"
},
"scripts": {
"start": "react-scripts start",
"build": "react-scripts build",
"test": "react-scripts test --env=jsdom",
"eject": "react-scripts eject",
"lint": "eslint --ext .jsx,.js src",
"precommit": "npm run lint",
"postmerge": "npm install",
"postrewrite": "npm install",
}
}
我们使用四个脚本:
-
precommit:在执行提交之前运行。 -
postmerge:在执行合并后运行。 -
postrewrite:这个 hook 是由重写提交的命令调用的(git commit--amend,git-rebase;目前,git-filter-branch不会调用它!)。 -
*prepush:我目前没有添加这个 Git 钩子,但这对于运行我们的单元测试("prepush": "npm test")非常有用,我们将在第十二章中添加这个 Git 钩子,测试和调试,当我们涵盖单元测试主题时。
在这种情况下,在我们的precommit中,我们将运行我们的 linter 验证器,如果验证器失败,提交将不会执行,直到您修复所有 linter 错误。postmerge 和 postrewrite 钩子帮助我们同步我们的 npm 包,因此,例如,如果用户 A 添加了新的 npm 包,然后用户 B 拉取新代码,将自动运行npm install命令在用户 B 的本地机器上安装新包。
使用 React Helmet 更新我们的标题和元标记
在所有项目中,能够更改我们的站点标题和每个特定页面上的元标记以使其对 SEO 友好非常重要。
准备工作
对于这个示例,我们需要安装一个名为react-helmet的包:
npm install react-helmet
如何做...
React Helmet 是处理标题和元标记以改善我们网站 SEO 的最佳方式:
- 一旦我们使用
App.jsx的相同组件安装了react-helmet包,我们需要导入 React Helmet:
import Helmet from 'react-helmet';
- 我们可以通过将标题属性添加到
Helmet组件来更改页面的标题,就像这样:
<Helmet title="Person Information" />
- 如果您启动您的应用程序,您将在浏览器中看到标题:
- 如果您想更改您的元标记,您可以这样做:
<Helmet
title="Person Information"
meta={[
{ name: 'title', content: 'Person Information' },
{ name: 'description', content: 'This recipe talks about React
Helmet' }
]}
/>
它是如何工作的...
有了那段代码,我们将得到这个输出:
如果您想直接将 HTML 代码添加到Helmet组件中,也可以这样做:
<Helmet>
<title>Person Information</title>
<meta name="title" content="Person Information" />
<meta name="description" content="This recipe talks about React Helmet" />
</Helmet>
您可能已经注意到在页面第一次加载时标题会闪烁变化,这是因为在我们的index.html文件中,默认情况下有标题React App。您可以通过编辑此文件来更改它:
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1,
shrink-to-fit=no">
<meta name="theme-color" content="#000000">
<link rel="manifest" href="%PUBLIC_URL%/manifest.json">
<link rel="shortcut icon" href="%PUBLIC_URL%/favicon.ico">
<title>Personal Information</title>
</head>
文件:public/index.html
还有更多...
到目前为止,我们只在主组件(<App />)中更改了我们的标题,但在第四章*,使用 React Router V4 为我们的应用程序添加路由*,我们将能够根据路由在不同组件中更改我们的标题和元标记。
此外,在第十一章中,实现服务器端渲染,我们将学习如何在应用程序中实现服务器端渲染。您也可以在服务器端渲染中使用 React Helmet,但需要进行一些更改。
首先,在您的index.html文件中(注意:此文件将在第十一章*,实现服务器端渲染*中更改为 JavaScript 文件;请不要尝试将此内容添加到您当前的index.html文件中),您需要添加类似以下内容:
return `
<head>
<meta charset="utf-8">
<title>Personal Information</title>
${helmet.title.toString()}
${helmet.meta.toString()}
<link rel="shortcut icon" href="images/favicon.png"
type="image/x-icon">
</head>
`;
有了这个,我们就能够使用服务器端渲染来更新我们的标题和元标签。
第四章:使用 React Router 在我们的应用程序中添加路由
在本章中,将涵盖以下示例:
-
实现 React Router v4
-
创建嵌套路由并向我们的路径添加参数
介绍
在本章中,我们将学习如何使用 React Router v4 在我们的项目中添加动态路由。
实现 React Router v4
与 Angular 不同,React 是一个库而不是一个框架,这意味着特定功能,例如路由或propTypes,不是 React 核心的一部分。相反,路由由一个名为 React Router 的第三方库处理。
准备工作
我们将使用我们在实施 Airbnb React/JSX 样式指南(Repository: Chapter03/Recipe4/airbnb)中的代码来启用 linter 验证。
我们需要做的第一件事是安装 React Router v4,我们可以使用以下命令来完成:
npm install react-router-dom
您可能会对我们为什么安装react-router-dom而不是react-router感到困惑。React Router 包含了react-router-dom和react-router-native的所有常见组件。这意味着如果您在 Web 上使用 React,应该使用react-router-dom,如果您在使用 React Native,则需要使用react-router-native。react-router-dom包最初是为了包含版本 4,而react-router使用的是版本 3。react-router-dom比react-router有一些改进。它们在这里列出:
-
改进的
<Link>组件(渲染为<a>)。 -
包括
<BrowserRouter>,它与浏览器的window.history交互。 -
包括
<NavLink>,它是一个<Link>包装器,知道它是否处于活动状态。 -
包括
<HashRouter>,它使用 URL 中的哈希来渲染组件。如果您有一个静态页面,应该使用这个组件而不是<BrowserRouter>。
如何做...
在这个示例中,我们将根据路由显示一些组件:
-
我们需要创建四个功能组件(
About,Contact,Home和Error 404)并将它们命名为它们目录中的index.jsx。 -
创建
Home组件:
import React from 'react';
const Home = () => (
<div className="Home">
<h1>Home</h1>
</div>
);
export default Home;
文件:src/components/Home/index.jsx
- 创建
About组件:
import React from 'react';
const About = () => (
<div className="About">
<h1>About</h1>
</div>
);
export default About;
文件:src/components/About/index.jsx
- 创建
Contact组件:
import React from 'react';
const Contact = () => (
<div className="Contact">
<h1>Contact</h1>
</div>
);
export default Contact;
文件:src/components/Contact/index.jsx
- 创建
Error 404组件:
import React from 'react';
const Error404 = () => (
<div className="Error404">
<h1>Error404</h1>
</div>
);
export default Error404;
文件:src/components/Error/404.jsx
- 在我们的
src/index.js文件中,我们需要包含我们将在下一步创建的路由。我们需要从react-router-dom中导入BrowserRouter对象,并将其重命名为 Router:
import React from 'react';
import { render } from 'react-dom';
import { BrowserRouter as Router } from 'react-router-dom';
import './index.css';
// Routes
import AppRoutes from './routes';
render(
<Router>
<AppRoutes />
</Router>,
document.getElementById('root')
);
文件:src/index.js
- 现在我们需要创建
src/routes.jsx文件,我们将在其中导入我们的App和Home组件,并使用Route组件为用户访问根路径(/)时添加一个路由来执行我们的Home组件:
// Dependencies
import React from 'react';
import { Route } from 'react-router-dom';
// Components
import App from './components/App';
import Home from './components/Home';
const AppRoutes = () => (
<App>
<Route path="/" component={Home} />
</App>
);
export default AppRoutes;
文件:src/routes.jsx
- 之后,我们需要修改我们的
App.jsx文件,将路由组件渲染为子组件:
import React from 'react';
import { element } from 'prop-types';
import Header from '../shared/components/layout/Header';
import Content from '../shared/components/layout/Content';
import Footer from '../shared/components/layout/Footer';
import './App.css';
const App = props => (
<div className="App">
<Header title="Routing" />
<Content>
{props.children}
</Content>
<Footer />
</div>
);
App.propTypes = {
children: element
};
export default App;
文件:src/components/App.jsx
- 如果你运行你的应用程序,你会在根路径(/)看到
Home组件:
- 现在,让我们在用户尝试访问任何其他路由时添加我们的
Error 404:
// Dependencies
import React from 'react';
import { Route } from 'react-router-dom';
// Components
import App from './components/App';
import Home from './components/Home';
import Error404 from './components/Error/404';
const AppRoutes = () => (
<App>
<Route path="/" component={Home} />
<Route component={Error404} />
</App>
);
export default AppRoutes;
文件:src/routes.jsx
- 如果你运行应用程序,你会看到它同时渲染了两个组件(
Home和Error 404)。你可能想知道为什么:
- 这是因为我们需要使用
<Switch>组件来执行路径匹配时的一个组件。为此,我们需要导入Switch组件,并将其作为路由的包装器添加进去:
// Dependencies
import React from 'react';
import { Route, Switch } from 'react-router-dom';
// Components
import App from './components/App';
import Home from './components/Home';
import Error404 from './components/Error/404';
const AppRoutes = () => (
<App>
<Switch>
<Route path="/" component={Home} />
<Route component={Error404} />
</Switch>
</App>
);
export default AppRoutes;
文件:src/routes.jsx
- 现在,如果我们去到根路径(/),我们会看到我们的
Home组件,而Error404不会同时执行(只会执行Home组件),但如果我们去到/somefakeurl,我们会看到Home组件也被执行了,这是一个问题:
- 为了解决这个问题,我们需要在我们想要精确匹配的路由中添加 exact 属性。问题在于
/somefakeurl会匹配我们的根路径(/),但如果我们想要非常具体地匹配路径,我们需要在Home路由中添加 exact 属性:
// Dependencies
import React from 'react';
import { Route, Switch } from 'react-router-dom';
// Components
import App from './components/App';
import Home from './components/Home';
import Error404 from './components/Error/404';
const AppRoutes = () => (
<App>
<Switch>
<Route path="/" component={Home} exact />
<Route component={Error404} />
</Switch>
</App>
);
export default AppRoutes;
- 现在如果你去到
/somefakeurl,你将能够看到Error404组件:
它是如何工作的...
正如你所看到的,实现 React Router 库非常容易。现在我们可以为我们的About(/about)和Contact(/contact)组件添加更多的路由:
// Dependencies
import React from 'react';
import { Route, Switch } from 'react-router-dom';
// Components
import App from './components/App';
import About from './components/About';
import Contact from './components/Contact';
import Home from './components/Home';
import Error404 from './components/Error/404';
const AppRoutes = () => (
<App>
<Switch>
<Route path="/" component={Home} exact />
<Route path="/about" component={About} exact />
<Route path="/contact" component={Contact} exact />
<Route component={Error404} />
</Switch>
</App>
);
export default AppRoutes;
如果你去到/about,你会看到这个视图:
如果你去到/contact,你会看到这个视图:
还有更多...
到目前为止,我们已经学会了如何在我们的项目中创建简单的路由,但在下一个教程中,我们将学习如何在我们的路由中包含参数,如何添加嵌套路由,以及如何使用<Link>组件在我们的网站中导航。
向我们的路由添加参数
对于这个教程,我们将使用与上一个教程相同的代码,并添加一些参数,展示如何将它们传递到我们的组件中。
如何做...
在这个教程中,我们将创建一个简单的Notes组件,以在访问/notes路由时显示所有的笔记,但当用户访问/notes/:noteId时,我们将显示一个笔记(我们将使用noteId来过滤笔记):
- 我们需要创建一个名为 Notes 的新组件(
src/components/Notes/index.jsx),这是我们的Notes组件的骨架:
import React, { Component } from 'react';
import './Notes.css';
class Notes extends Component {
constructor() {
super();
// For now we are going to add our notes to our
// local state, but normally this should come
// from some service.
this.state = {
notes: [
{
id: 1,
title: 'My note 1'
},
{
id: 2,
title: 'My note 2'
},
{
id: 3,
title: 'My note 3'
},
]
};
}
render() {
return (
<div className="Notes">
<h1>Notes</h1>
</div>
);
}
}
export default Notes;
文件:src/components/Notes/index.jsx
- CSS 文件如下:
.Notes ul {
list-style: none;
margin: 0;
margin-bottom: 20px;
padding: 0;
}
.Notes ul li {
padding: 10px;
}
.Notes a {
color: #555;
text-decoration: none;
}
.Notes a:hover {
color: #ccc;
text-decoration: none;
}
文件:src/components/Notes/Notes.css
- 一旦我们创建了我们的
Notes组件,我们需要将它导入到我们的src/routes.jsx文件中:
// Dependencies
import React from 'react';
import { Route, Switch } from 'react-router-dom';
// Components
import App from './components/App';
import About from './components/About';
import Contact from './components/Contact';
import Home from './components/Home';
import Notes from './components/Notes';
import Error404 from './components/Error/404';
const AppRoutes = () => (
<App>
<Switch>
<Route path="/" component={Home} exact />
<Route path="/about" component={About} exact />
<Route path="/contact" component={Contact} exact />
<Route path="/notes" component={Notes} exact />
<Route component={Error404} />
</Switch>
</App>
);
export default AppRoutes;
文件:src/routes.jsx
- 现在我们可以在
/notesURL 下看到我们的 Notes 组件:
- 现在我们的
Notes组件已经连接到 React Router,让我们将我们的笔记渲染为列表:
import React, { Component } from 'react';
import { Link } from 'react-router-dom';
import './Notes.css';
class Notes extends Component {
constructor() {
super();
this.state = {
notes: [
{
id: 1,
title: 'My note 1'
},
{
id: 2,
title: 'My note 2'
},
{
id: 3,
title: 'My note 3'
},
]
};
}
renderNotes = notes => (
<ul>
{notes.map((note, key) => (
<li key={key}>
<Link to={`/notes/${note.id}`}>{note.title}</Link>
</li>
))}
</ul>
);
render() {
const { notes } = this.state;
return (
<div className="Notes">
<h1>Notes</h1>
{this.renderNotes(notes)}
</div>
);
}
}
export default Notes;
文件:src/components/Notes/index.jsx
- 你可能已经注意到我们正在使用
<Link>(这将生成一个<a>标签)组件,指向/notes/notes.id,这是因为我们将在我们的src/routes.jsx文件中添加一个新的嵌套路由来匹配笔记的id:
// Dependencies
import React from 'react';
import { Route, Switch } from 'react-router-dom';
// Components
import App from './components/App';
import About from './components/About';
import Contact from './components/Contact';
import Home from './components/Home';
import Notes from './components/Notes';
import Error404 from './components/Error/404';
const AppRoutes = () => (
<App>
<Switch>
<Route path="/" component={Home} exact />
<Route path="/about" component={About} exact />
<Route path="/contact" component={Contact} exact />
<Route path="/notes" component={Notes} exact />
<Route path="/notes/:noteId" component={Notes} exact />
<Route component={Error404} />
</Switch>
</App>
);
export default AppRoutes;
文件:src/routes.jsx
- React Router 有一个特殊的属性叫做
match,它是一个包含有关我们执行的路由的所有信息的对象,如果我们有参数,我们将能够在match对象中看到它们,就像这样:
render() {
// Let's see what contains our props object.
console.log(this.props);
// We got the noteId param from match object.
const { match: { params: { noteId } } } = this.props;
const { notes } = this.state;
// By default our selectedNote is false
let selectedNote = false;
if (noteId > 0) {
// If the note id is higher than 0 then we filter it from our
// notes array.
selectedNote = notes.filter(
note => note.id === Number(noteId)
);
}
return (
<div className="Notes">
<h1>Notes</h1>
{/* We render our selectedNote or all notes */}
{this.renderNotes(selectedNote || notes)}
</div>
);
}
文件:src/components/Notes/index.jsx
match属性看起来像这样。
它是如何工作的...
match对象包含了许多有用的信息。React Router 还包括了对象的历史和位置。正如你所看到的,我们可以在match对象中获取我们在路由中传递的所有参数。
如果你运行应用程序并转到/notesURL,你会看到这个视图:
如果你点击任何链接(我点击了我的笔记 2),你会看到这个视图:
之后,我们可以在我们的Header组件中添加一个菜单来访问所有我们的路由:
import React from 'react';
import PropTypes from 'prop-types';
import { Link } from 'react-router-dom';
import logo from '../../images/logo.svg';
// We created a component with a simple arrow function.
const Header = props => {
const {
title = 'Welcome to React',
url = 'http://localhost:3000'
} = props;
return (
<header className="App-header">
<a href={url}>
<img src={logo} className="App-logo" alt="logo" />
</a>
<h1 className="App-title">{title}</h1>
<ul>
<li><Link to="/">Home</Link></li>
<li><Link to="/about">About</Link></li>
<li><Link to="/notes">Notes</Link></li>
<li><Link to="/contact">Contact</Link></li>
</ul>
</header>
);
};
// Even with Functional Components we are able to validate our PropTypes.
Header.propTypes = {
title: PropTypes.string.isRequired,
url: PropTypes.string
};
export default Header;
文件:src/shared/components/layout/Header.jsx
之后,我们需要修改我们的src/components/App.css文件来为我们的菜单添加样式。只需在 CSS 文件的末尾添加以下代码:
.App-header ul {
margin: 0;
padding: 0;
list-style: none;
}
.App-header ul li {
display: inline-block;
padding: 0 10px;
}
.App-header ul li a {
color: #fff;
text-decoration: none;
}
.App-header ul li a:hover {
color: #ccc;
}
文件:src/components/App.css
现在你可以看到菜单像这样: