七天接手react项目 系列 —— react 起步
其他章节请看:
react 起步
背景
假如七天后必须接手一个 react 项目(spug - 一个开源运维平台),而笔者只会 vue,之前没有接触过 react,此刻能做的就是立刻展开一个“7天 react 扫盲活动”。
react 活动扫盲方针
- 以读懂 spug 项目为目标
- 无需对每个知识点深究
- 功能优先能实现,代码质量无需太苛刻
项目准备
将 spug 克隆到本地:
exercise> git clone https://github.com/openspug/spug spug-dev-demo
Cloning into 'spug-dev-demo'...
fatal: unable to access 'https://github.com/openspug/spug/': OpenSSL SSL_read: Connection was reset, errno 10054
克隆失败,HTTPS 模式换成 SSH 再次下载:
exercise> git clone git@github.com:openspug/spug.git spug-dev-demo
Cloning into 'spug-dev-demo'...
remote: Enumerating objects: 11675, done.
remote: Counting objects: 100% (4184/4184), done.
remote: Compressing objects: 100% (1161/1161), done.
remote: Total 11675 (delta 3157), reused 3939 (delta 2991), pack-reused 7491
Receiving objects: 100% (11675/11675), 5.09 MiB | 2.32 MiB/s, done.
Resolving deltas: 100% (8460/8460), done.
目录结构如下:
exercise\spug-dev-demo> dir
Mode LastWriteTime Length Name
---- ------------- ------ ----
d----- 2022/3/12 9:52 .github
d----- 2022/3/12 9:52 docs
d----- 2022/3/12 9:52 spug_api
d----- 2022/3/12 9:52 spug_web
-a---- 2022/3/12 9:52 9 .gitignore
-a---- 2022/3/12 9:52 35184 LICENSE
-a---- 2022/3/12 9:52 3732 README.md
我们前端主要关注 spug_web
这个项目。首先安装依赖包:
spug_web> cnpm i
/ [7/23] Installing @babel/plugin-transform-function-name@^7.8.3platform unsupported react-scripts@3.4.3 › babel-jest@24.9.0 › @jest/transform@24.9.0 › jest-haste-map@24.9.0 › fsevents@^1.2.7 Package require os(darwin) not compatible with your platform(win32)
- [7/23] Installing @babel/plugin-transform-classes@^7.16.7[fsevents@^1.2.7] optional install error: Package require os(darwin) not compatible with your platform(win32)
....
本地启动项目:
spug_web> npm run start
> spug_web@3.0.0 start
> react-app-rewired start
注:由于没有后端 api 的支持,所以不能登录进去。但至少可以从代码上分析这个前端项目。
hello-world
直接使用 script 的方式引入 react:
// 新建 hello-world.html
<body>
<div id="root">
<!-- 此元素的内容将替换为您的组件 -->
</div>
<!-- react 库 -->
<script src="https://unpkg.com/react@17/umd/react.development.js"></script>
<!-- 用于处理 Dom 的 react 包 -->
<script src="https://unpkg.com/react-dom@17/umd/react-dom.development.js"></script>
<!-- Babel 能够转换 JSX 语法 -->
<script src="https://unpkg.com/@babel/standalone/babel.min.js"></script>
<script type="text/babel">
ReactDOM.render(
// 注:无需添加字符串
<h1>Hello, world!</h1>,
document.getElementById('root')
);
</script>
</body>
访问页面,浏览器显示“Hello, world!”
这里我们引入了三个库,分别是 react 核心库、处理 dom 的 react以及用于转换 jsx。
Tip:
- 笔者在 vscode 中安装 “open in browser” 插件,直接右键选择 “Open with Live Server” 即可。
- 此示例来自 react 官网 hello-world
- React 和 ReactDOM 的 cdn 来自 react 官网-CDN 链接
- unpkg 是一个快速的全球内容交付网络,适用于 npm 上的所有内容。 使用它可以快速轻松地从任何包中加载任何文件
- react 和 vue 都是 javascript 库,都能用于构建用户界面
- React 用于构建用户界面的 JavaScript 库 —— 官网
- 渐进式 JavaScript 框架 —— Vue 官网
babel
Babel 是一个 JavaScript 编译器 —— 官网
babel 之前叫 6to5。意把 es6 转为 es5,后来目标变成支持 ECMAScript 所有语法,后来还支持将 JSX 转成 js。2015年2月,改名为 Bable。
Tip:6to5 is now Babel —— not-born-to-die
使用 Babel 最容易上手的是直接在 html 页面中通过 cdn 引入它。就像这样:
<body>
<div id="output"></div>
<!-- Load Babel -->
<script src="https://unpkg.com/@babel/standalone/babel.min.js"></script>
<!-- Your custom script here -->
<script type="text/babel">
const getMessage = () => "Hello World";
document.getElementById("output").innerHTML = getMessage();
</script>
</body>
浏览器页面显示:“Hello World”。
当在浏览器中加载时,@babel/standalone 将自动编译并执行所有类型为 text/babel 或 text/jsx 的脚本标签。
Tip:@babel/standalone 提供了一个独立的 Babel 构建,用于浏览器和其他非 Node.js 环境
为什么使用 JSX
我们建议在 React 中配合使用 JSX,JSX 可以很好地描述 UI 应该呈现出它应有交互的本质形式 —— react 官网-JSX 简介
JSX 仅仅只是 React.createElement(component, props, ...children)
函数的语法糖 —— react 官网-深入 JSX
语法糖,通常用起来更方便,功能或许也更强大。比如类(Class)只是我们自定义类的一个语法糖。jsx 是 React.createElement
的语法糖,意义应该也差不多。
在 hello-world 中我们使用的是语法糖(jsx)。就像这样:
// jsx
const reactElem = <h1>Hello, world!</h1>
ReactDOM.render(
reactElem,
document.getElementById('root')
);
若不使用语法糖(使用 React.createElement)。就像这样:
const reactElem = React.createElement(
'h1',
{/* className: 'greeting' */ },
'Hello, world!'
);
ReactDOM.render(reactElem, ...)
对比发现,jsx 更简洁。
React 元素
react 元素是创建起来开销极小的普通对象,用于描述你在屏幕上想看到的内容。与浏览器的 dom 元素不同。
react 元素是构成 React 应用的最小砖块 —— react 官网-元素渲染
注:不要混淆元素与组件,react 组件是由 react 元素构成的。
React.createElement 创建并返回指定类型的新的 react 元素。下面我们将 react 元素打印出来:
const reactElem = React.createElement(
'h1',
{},
'Hello, world!'
)
console.log('reactElem: ', reactElem)
react 元素:
reactElem: {$$typeof: Symbol(react.element), type: 'h1', key: null, ref: null, props: {…}, …}
$$typeof: Symbol(react.element)
key: null
props: {children: 'Hello, world!'}
ref: null
type: "h1"
_owner: null
_store: {validated: false}
_self: null
_source: null
[[Prototype]]: Object
Tip:使用 jsx,输出也是一样的:
const reactElem = <h1>Hello, world!</h1>
console.log('reactElem: ', reactElem)
react 元素只有极少的几个属性。而真实 dom 元素上的属性却要多得多。你可以通过浏览器运行以下代码,将鼠标移到 root
和 reactElem
对比查看属性数量。
const reactElem = <h1>Hello, world!</h1>
let root = document.getElementById('root')
// 打个断点
debugger
react 元素是不可变对象。一旦被创建,你就无法更改它的子元素或者属性。
React 只更新它需要更新的部分
React DOM 会将元素和它的子元素与它们之前的状态进行比较,并只会进行必要的更新来使 DOM 达到预期的状态。
JSX 语法规则
JSX,是一个 JavaScript 的语法扩展。JSX 可能会使人联想到模板语言,但它具有 JavaScript 的全部功能。
不要写引号
JSX 标签语法既不是字符串也不是 HTML。
// 正确。页面显示“Hello, world!”
const reactElem = <h1>Hello, world!</h1>
// 错误。页面显示“<h1>Hello, world!</h1>”
const reactElem = '<h1>Hello, world!</h1>'
引入 js 使用 {}
let _class = 'greeting'
let cnt = 'Hello, world!'
const reactElem = (
<h1 className={_class}>
{cnt.toLocaleUpperCase()}
</h1>
)
浏览器显示:”HELLO, WORLD!“。元素内容:
<h1 class="greeting">HELLO, WORLD!</h1>
样式类名请使用 className
倘若是用 class。就像这样:
const reactElem = (
<h1 class={_class}>
{cnt.toLocaleUpperCase()}
</h1>
)
元素内容正常:
<h1 class="greeting">HELLO, WORLD!</h1>
但浏览器控制台报错:Warning: Invalid DOM property 'class'. Did you mean 'className'?
内联样式请使用 style={{ color: 'pink' }}
倘若使用 style="color:pink"
:
const reactElem = (
<h1 className={_class} style="color:pink">
{cnt.toLocaleUpperCase()}
</h1>
)
控制台报错:
react-dom.development.js:2716 Uncaught Error: The 'style' prop expects a mapping from style properties to values, not a string. For example, style={{marginRight: spacing + 'em'}} when using JSX.
react-dom.development.js:2716 未捕获的错误:“样式”道具需要从样式属性到值的映射,而不是字符串。 例如,使用 JSX 时 style={{marginRight: spacing + 'em'}}。
改成 {{ color: 'pink' }}
则正常:
const reactElem = (
<h1 className={_class} style={{ color: 'pink' }}>
{cnt.toLocaleUpperCase()}
</h1>
)
只能有一个根标签
const reactElem = (
<h1 className={_class} style={{ color: 'pink' }}>
{cnt.toLocaleUpperCase()}
</h1>
<p>apple</p>
)
vscode 红波浪线提示:JSX expressions must have one parent element
(JSX 表达式必须有一个父元素)
包裹一个 div 即可。就像这样:
const reactElem = (
<div>
<h1 className={_class} style={{ color: 'pink' }}>
{cnt.toLocaleUpperCase()}
</h1>
<p>apple</p>
</div>
)
不要忘记闭合标签
<div>
<h1 className={_class} style={{ color: 'pink' }}>
{cnt.toLocaleUpperCase()}
</h1>
/* input 标签未闭合 */
<input type="text">
</div>
vscode 红波浪线提示:JSX element 'input' has no corresponding closing tag
(JSX 元素“输入”没有相应的结束标记)。
浏览器运行控制台报错:Uncaught SyntaxError: /Inline Babel script: Unterminated JSX contents(未终止的 JSX 内容)。
以下两种闭合方式都可以:
<input type="text" />
<input type="text"></input>
自定义组件使用大写字母开头
const reactElem = (
<div>
<mybutton>18</mybutton>
</div>
)
页面显示:“18”。浏览器报错:
react-dom.development.js:61 Warning: The tag <mybutton> is unrecognized in this browser. If you meant to render a React component, start its name with an uppercase letter.
react-dom.development.js:61 警告:标签 <mybutton> 在此浏览器中无法识别。 如果您打算渲染一个 React 组件,请以大写字母开头。
以小写字母开头的元素代表一个 HTML 内置组件,比如 <div>
或者 <span>
会生成相应的字符串 'div' 或者 'span' 传递给 React.createElement
(作为参数)。大写字母开头的元素则对应着在 JavaScript 引入或自定义的组件,如 <Foo />
会编译为 React.createElement(Foo)
。
JSX 括号
官网示例中的 jsx 用括号包围起来。就像这样:
// 有括号
const element = (
<h1 className="greeting">
Hello, world!
</h1>
);
感觉就是在写 html,而且还有缩进。
笔者尝试将括号去除:
const reactElem =
<h1 className="greeting">
Hello, world!
</h1>
ReactDOM.render(
reactElem,
document.getElementById('root')
)
浏览器还是正常显示:“Hello, world!”。
我们建议将内容包裹在括号中,虽然这样做不是强制要求的,但是这可以避免遇到自动插入分号陷阱 —— 官网-JSX 简介
JSX 小练习
JavaScript 表达式可以被包裹在 {}
中作为子元素。例如,以下表达式是等价的:
<MyComponent>foo</MyComponent>
<MyComponent>{'foo'}</MyComponent>
例如将下面 ul 列表改为动态:
<ul>
<li>finish doc</li>
<li>submit pr</li>
<li>nag dan to review</li>
</ul>
let todos = ['finish doc', 'submit pr', 'nag dan to review'];
const reactElem = (
<ul>
{
todos.map(item => {
return <li>{item}</li>
})
}
</ul>
)
浏览器控制台告警:
Warning: Each child in a list should have a unique "key" prop.
警告:列表中的每个孩子都应该有一个唯一的“key”属性。
添加 key
即可:
todos.map((item, index) => {
return <li key={index}>{item}</li>
})
注:用元素在数组中的下标作为 key,有时会存在问题 —— 正确使用 key
Tip:相同功能,官网(JavaScript 表达式作为子元素)是这样实现的:
function Item(props) {
return <li>{props.message}</li>;
}
function TodoList() {
const todos = ['finish doc', 'submit pr', 'nag dan to review'];
return (
<ul>
{todos.map((message) => <Item key={message} message={message} />)}
</ul>
);
}
const reactElem = TodoList()
组件
在 vue 中我们会这样使用组件:
// 注册组件
Vue.component('component-a', { /* ... */ })
Vue.component('component-b', { /* ... */ })
Vue.component('component-c', { /* ... */ })
new Vue({ el: '#app' })
<div id="app">
<component-a></component-a>
<component-b></component-b>
<component-c></component-c>
</div>
Tip:仅作示意,通常我们会使用 spa 单页面应用开发。
于是可以将应用界面抽象成一棵组件树:
对比 vue 项目和react 项目的入口文件,其实都是将 App
组件挂载到 dom 元素上:
// vue项目/main.js
import App from './App.vue'
...
new Vue({
router,
store,
// 将 App 挂载到 #app
render: h => h(App)
}).$mount('#app')
// spug_web/src/index.js
import App from './App';
...
// 将 App 挂载到 #root
ReactDOM.render(
<Router history={history}>
<ConfigProvider locale={zhCN} getPopupContainer={() => document.fullscreenElement || document.body}>
<App/>
</ConfigProvider>
</Router>,
document.getElementById('root')
);
函数组件与 class 组件
定义组件最简单的方式是使用函数
。请看示例:
<script type="text/babel">
// 函数组件
function MyComponent(props) {
return <h1>Hello, {props.name}</h1>;
}
ReactDOM.render(
<div>
<MyComponent name="peng" />
</div>,
document.getElementById('root')
);
</script>
页面显示“Hello, peng”。组件对应的 html 为:<h1>Hello, peng</h1>
。
我们还可以使用 es6 的 class
来定义组件。就像这样:
// class 组件。
class MyComponent extends React.Component {
// 必须定义 render()。否则会报错:
// MyComponent(...): No `render` method found on the returned component instance: you may have forgotten to define `render`.
render() {
return <h1>Hello, {this.props.name}</h1>
}
}
// 省略。用法相同
Tip:
- 在
React.Component
的子类中,必须定义render()
函数 - 我们强烈建议你不要创建自己的组件基类。 在 React 组件中,代码重用的主要方式是组合而不是继承。 —— 官网
- class 组件目前提供了更多的功能
组件中的 this
首先看函数组件中的 this:
// 函数组件
function MyComponent(props) {
+ console.log('this', this)
return <h1>Hello, {props.name}</h1>;
}
浏览器制台输出:this undefined
。说明没有 this。
上文我们已经在 class 组件的 render()
中使用了 this,我们将其打印出来看一下:
// class 组件
class MyComponent extends React.Component {
render() {
+ console.log('this', this)
return <h1>Hello, {this.props.name}</h1>
}
}
this MyComponent {props: {…}, context: {…}, refs: {…}, updater: {…}, _reactInternals: FiberNode, …}
context: {}
props: {name: 'peng'}
refs: {}
state: null
updater: {isMounted: ƒ, enqueueSetState: ƒ, enqueueReplaceState: ƒ, enqueueForceUpdate: ƒ}
_reactInternalInstance: {_processChildContext: ƒ}
_reactInternals: FiberNode {tag: 1, key: null, stateNode: MyComponent, elementType: ƒ, type: ƒ, …}
isMounted: (…)
replaceState: (…)
[[Prototype]]: Component
为什么函数组件中的 this 是 undifined
将函数组件 MyComponent 放入 bable 的试一试中,会被翻译成:
"use strict";
function MyComponent(props) {
console.log('this', this);
return /*#__PURE__*/React.createElement("h1", null, "Hello, ", props.name);
}
注:jsx 被 babel 识别了处理啊,因为翻译成了 React.createElement
。
严格模式下,如果没有指定 this 的话,它值是 undefined
。
我们将 class 组件 MyComponent 也翻译一下:
"use strict";
class MyComponent extends React.Component {
render() {
console.log('this', this);
return /*#__PURE__*/React.createElement("h1", null, "Hello, ", this.props.name);
}
}
props
我们首先回忆一下 vue 中的 props:
- props 用于接收来自父组件的数据。就像这样:
<div id='app'>
<button-counter :msg='message'></button-counter>
</div>
<script>
Vue.component('button-counter', {
props: ['msg'],
template: `<div>
来自父组件的信息: {{msg}}
</div>`
})
var app = new Vue({
el: '#app',
data: {
message: 'hello'
}
})
</script>
- 可以使用.sync 修饰符来实现一个 prop 进行“双向绑定”。即子组件不要直接更改父组件的这个属性,而应该通知父组件,让父组件自己去更改这个属性。
- prop 验证。就像这样:
Vue.component('my-component', {
props: {
// 基础的类型检查 (`null` 和 `undefined` 会通过任何类型验证)
propA: Number,
// 必填的字符串
propC: {
type: String,
required: true
},
// 带有默认值的数字
propD: {
type: Number,
default: 100
},
// 带有默认值的对象
propE: {
type: Object,
// 对象或数组默认值必须从一个工厂函数获取
default: function () {
return { message: 'hello' }
}
},
...
}
})
在 react 中,props 的作用也类似,即用于接收父组件传来的属性。
props 基本用法
给组件 MyComponent 定义了两个 prop(属性):
name
,字符串类型,默认值是 defaultNamesay
,函数类型,必填
<body>
<div id="root"></div>
<script src="https://unpkg.com/react@17/umd/react.development.js"></script>
<script src="https://unpkg.com/react-dom@17/umd/react-dom.development.js"></script>
<script src="https://unpkg.com/@babel/standalone/babel.min.js"></script>
<!-- 使用 PropTypes 进行类型检查 -->
<script src="https://unpkg.com/prop-types@15.6/prop-types.js"></script>
<script type="text/babel">
class MyComponent extends React.Component {
render() {
const { name, say } = this.props
return <h1>Hello, {this.props.name}, {say()}</h1>
}
}
// 属性类型
MyComponent.propTypes = {
name: PropTypes.string,
// 注:函数不是 function,而是 func
// 函数类型,并且必填
say: PropTypes.func.isRequired
}
// 默认值
MyComponent.defaultProps = {
name: 'defaultName'
}
const props2 = { say: () => 'I know you' }
ReactDOM.render(
<div>
<MyComponent name="peng" say={() => 'I love you'} />
<MyComponent {...props2} />
</div>,
document.getElementById('root')
);
</script>
</body>
页面显示:
Hello, peng, I love you
Hello, defaultName, I know you
自 React v15.5 起,React.PropTypes 已移入另一个包中。请使用 prop-types
库 代替 —— 官网
Tip:有关类型检测更多介绍请看 使用 PropTypes 进行类型检查
Props 的只读性
组件无论是使用函数声明还是通过 class 声明,都决不能修改自身的 props。倘若我们尝试修改 props 属性,就像这样:
class MyComponent extends React.Component {
render() {
+ this.props.name = 'aName'
...
}
}
浏览器控制台将报错如下:
Inline Babel script:10 Uncaught TypeError: Cannot assign to read only property 'name' of object '#<Object>'
内联 Babel 脚本:10 未捕获的类型错误:无法分配给对象 '#<Object>' 的只读属性 'name'
使用 static 优化类型检测
上文中,类型检测的相关代码,从语法上来说就是给 MyComponent 类增加两个静态属性:
// 类型检测相关代码
MyComponent.propTypes = {
name: PropTypes.string,
say: PropTypes.func.isRequired
}
MyComponent.defaultProps = {
name: 'defaultName'
}
我们可以使用 static 语法来对其优化。就像这样:
// class 组件
class MyComponent extends React.Component {
// 属性类型
static propTypes = {
name: PropTypes.string,
say: PropTypes.func.isRequired
}
// 默认值
static defaultProps = {
name: 'defaultName'
}
render() {
...
}
}
函数组件中的 props
上文我们已经使用过了:
function MyComponent(props) {
return <h1>Hello, {props.name}</h1>;
}
虽然函数组件中没有 this,不能像 class 组件那样通过 this 去使用 props(this.props.name
),但函数组件可以通过参数接收 props。
super(props)
在 React 组件挂载之前,会调用它的构造函数。在为 React.Component 子类实现构造函数时,应在其他语句之前调用 super(props)。否则,this.props 在构造函数中可能会出现未定义的 bug —— 官网
这句话什么意思?请看示例:
class MyComponent extends React.Component {
constructor(props) {
super(props)
// 输出 {}。表明 this.props 有值
console.log(this.props.name)
}
render() {
...
}
}
将 super(props)
改为 super()
:
class MyComponent extends React.Component {
constructor(props) {
super()
// 输出 undefined
console.log(this.props)
}
render() {
...
}
}
其他章节请看:
出处:https://www.cnblogs.com/pengjiali/p/16002317.html
本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接。