ReactJs 笔记
1. 前端开发的演变
到目前为止,前端的开发经历了四个阶段,目前处于第四个阶段。这四个阶段分别是:
1.1. 阶段一:静态页面阶段
在第一个阶段中前端页面都是静态的,所有前端代码和前端数据都是后端生成的。前端只是纯粹的展示功能,js脚本的作用只是增加一些特殊效果,比如那时很流行用脚本控制页面上飞来飞去的广告。
那时的网站开发,采用的是后端 MVC 模式。
- Model (模型层):提供/保存数据
- Controller (控制层):数据处理,实现业务逻辑
- View (视图层):展示数据,提供用户界面
前端只是后端 MVC 的 V。
1.2. 阶段二:ajax阶段
2004年,AJAX 技术诞生,改变了前端开发。Gmail 和 Google 地图这样革命性的产品出现,使得开发者发现,前端的作用不仅仅是展示页面,还可以管理数据并与用户互动。
就是从这个阶段开始,前端脚本开始变得复杂,不再仅仅是一些玩具性的功能。
1.3. 阶段三:前端MVC阶段
2010年,第一个前端 MVC 框架 Backbone.js 诞生。它基本上是把 MVC 模式搬到了前端,但是只有 M(读写数据)和 V(展示数据),没有 C(处理数据)。
有些框架提出了 MVVM模式,用 View Model 代替 Controller。Model 拿到数据以后,View Model 将数据处理成视图层(View)需要的格式,在视图层展示出来。
1.4. 阶段四:SPA阶段
前端可以做到读写数据、切换视图、用户交互,这意味着,网页其实是一个应用程序,而不是信息的纯展示。这种单张网页的应用程序称为 SPA(single-page-application)。
2010年后,前端工程师从开发页面(切模板),逐渐变成了开发“前端应用”(跑在浏览器里面的应用程序)。
目前,最流行的前端框架 Vue、Angular、React 等等,都属于 SPA 开发框架。
2. ReactJS简介
官网: https://reactjs.org/
ReactJS,就是一个用于构建用户界面的JavaScript框架,是Facebook开发的一款的JS框架。
ReactJS把复杂的页面,拆分成一个个的组件,将这些组件一个个的拼装起来,就会呈现多样的页面。ReactJS可以用于 MVC 架构,也可以用于 MVVM 架构,或者别的架构。
ReactJS圈内的一些框架简介:
- Flux
- Flux是Facebook用户建立客户端Web应用的前端架构,它通过利用一个单向的数据流补充了React的组合视图组件,这更是一种模式而非框架。
- Redux
- Redux是JavaScript状态容器,提供可预测化的状态管理。Redux可以让React组件状态共享变得简单。
- Ant Design of React
- 阿里开源的基于React的企业级后台产品,其中集成了多种框架,包含了上面提到的Flux、Redux。
- Ant Design提供了丰富的组件,包括:按钮、表单、表格、布局、分页、树组件、日历等。
3. 搭建环境(案例使用UmiJs)
3.1. 创建项目
本案例使用选择使用 UmiJS作为构建工具。
- 创建工程。(如果使用vscode,就创建空的文件夹即可)
- 在命令行窗口,在工程所在路径上输入命令,进行初始化: ``` npm init -y
<br />
3. 在命令输入如下命令,添加umi的依赖
项目中添加umi的依赖
npm add umi —dev
### 3.2. 编写HelloWorld程序
- 第一步,在工程的根目录下创建config目录,在config目录下创建config.js文件。
> 在UmiJS的约定中,config/config.js将作为UmiJS的全局配置文件。<br />
<br />
在 umi中,约定的目录结构如下:<br />

在config.js文件中输入以下内存,以便后面使用
// 导出一个对象,暂时设置为空对象,后面再填充内容 export default {};
- 第二步,创建HelloWorld.js页面文件
在umi中,约定存放页面代码的文件夹是在src/pages,可以通过`singular:false`来设置单数的命名方式,一般采用默认即可。<br />在HelloWorld.js文件中输入如下内容:
export default () => { return
**注:上面的js文件是react自创的写法,叫JSX**
- 第三步,启动服务查看页面效果
启动服务
umi dev
可以看到,通过`/HelloWorld`路径即可访问到刚刚写的HelloWorld.js文件。<br />在umi中,可以使用约定式的路由,在pages下面的JS文件都会按照文件名映射到一个路由,比如上面这个例子,访问 `/helloworld` 会对应到 HelloWorld.js。当然了,也可以自定义路由
### 3.3. 添加umi-plugin-react插件
umi-plugin-react插件是umi官方基于react封装的插件,包含了13个常用的进阶功能。<br />具体可查看:[https://umijs.org/zh/plugin/umi-plugin-react.html](0e3b1337cda0d03ef35cadf8d4c6867c)
- 在当前工程目录下,输入以下命令添加该插件依赖。成功后会在package.json文件的`dependencies`属性中增加`"umi-plugin-react": "^1.7.4"`
添加插件
npm add umi-plugin-react —dev

- 修改config.js文件,引入该插件:
export default { plugins: [ [‘umi-plugin-react’, { //暂时不启用任何功能 }] ] };
### 3.4. 构建和部署
- 通过umi是可以进行转码生成文件的
工程的目录下输入命令
umi build
- 运行命令后,会在dish文件夹中生成_index.html和umi.js_文件。umi.js文件是一个已经压缩过的文件,之前写的代码都已经被转码到此文件中。这些文件就是用于部署到生产环境中
## 4. React快速入门
### 4.1. JSX语法
-
JSX语法就是,可以在js文件中插入html片段,是React自创的一种语法。
-
JSX语法会被Babel等转码工具进行转码,得到正常的js代码再执行。
-
使用JSX语法,需要2点注意:
1. 所有的html标签必须是闭合的,如:`<div>HelloWorld</div>`的写法是正确;`<div>HelloWorld`的写法是错误的;
1. 在JSX语法中,只能有一个根标签,不能有多个。
const div1 =
#### 4.1.1. JavaScript 表达式
在JSX语法中,如果想要在html标签中插入js脚本,需要通过`{}`插入js脚本。<br />
#### 4.1.2. 样式
React 推荐使用内联样式。可以使用 camelCase 语法来设置内联样式。 React 会在指定元素数字后自动添加 px。
var myStyle = { fontSize : 100, color : “#FF0000” }; ReactDOM.render(
月の哀傷
, document.getElementById(‘example’) );
#### 4.1.3. 注释
注释需要写在花括号中
ReactDOM.render(
月の哀傷
{/注释…/}
#### 4.1.4. 数组
JSX 允许在模板中插入数组,数组会自动展开所有成员
var arr = [
月の哀傷
,Hello MooNkirA!
, ]; ReactDOM.render(
#### 4.1.5. HTML 标签与 React 组件
- React 可以渲染 HTML 标签 (strings) 或 React 组件 (classes)。要渲染 HTML 标签,只需在 JSX 里使用小写字母的标签名。
var myDivElement =
; ReactDOM.render(myDivElement, document.getElementById(‘example’));
- 要渲染 React 组件,只需创建一个大写字母开头的本地变量。
var MyComponent = React.createClass({/…/});
var myElement =
- React 的 JSX 使用大、小写的约定来区分本地组件的类和 HTML 标签。
> **注意:由于 JSX 就是 JavaScript,一些标识符像 class 和 for 不建议作为 XML 属性名。作为替代,React DOM 使用 className 和 htmlFor 来做对应的属性。**
### 4.2. 组件
组件是React中最重要也是最核心的概念,一个网页,可以被拆分成一个个的组件<br />在React中,这样定义一个组件:
import React from ‘react’; // 第一步,导入React class HelloWorld extends React.Component { // 第二步,编写类并且继承 React.Component render() { // 第三步,重写render()方法,用于渲染页面 return
**_注:页面的标签是定义在render中的return,如果是标签是多行,则需要使用“()”进行包裹_**
#### 4.2.1. 导入自定义组件
创建Show.js文件,用于测试导入组件
import React from ‘react’
import HelloWorld from ‘./HelloWorld’ // 导入HelloWorld组件
class Show extends React.Component {
render() {
return
#### 4.2.2. 组件参数
##### 4.2.2.1. 定义传递参数
组件是可以传递参数的,有2种方式传递,分别是**属性**和**标签包裹的内容**传递<br />如下例子,引入组件HelloWorld,定义name="zhangsan"就是属性传递,shanghai就是标签包裹的内容传递。
import React from ‘react’
import HelloWorld from ‘./HelloWorld’ // 导入HelloWorld组件
class Show extends React.Component {
render() {
return
##### 4.2.2.2. 接收参数
接收参数也是2种方法:
- **属性**:**`this.props.name`**接收;
- **标签内容**:**`this.props.children`**接收;
import React from ‘react’; class HelloWorld extends React.Component { render() { // 属性:this.props.name 接收; // 标签内容:this.props.children 接收; return
#### 4.2.3. 组件的状态
**每一个组件都有一个状态,其保存在this.state中,当状态值发生变化时,React框架会自动调用render()方法,重新渲染页面。**<br />其中,要注意两点:
- **一:this.state值的设置要在构造参数中完成;**
- **二:要修改this.state的值,需要调用this.setState()完成,不能直接对this.state进行修改**
案例说明:通过点击按钮,不断的更新this.state,从而反应到页面中。
import React from ‘react’ class List extends React.Component { constructor(props) { // 构造参数中必须要props参数 super(props); // 调用父类的构造方法 this.state = { // 初始化this.state dataList: [1, 2, 3], maxNum: 3 }; } render() { return (
-
{
// 遍历值
this.state.dataList.map((value, index) => {
return
- {value} }) }
- 初始状态:

- 当点击 “添加”按钮:

- 过程分析

#### 4.2.4. React 组件 API
- 设置状态:setState
- 替换状态:replaceState
- 设置属性:setProps
- 替换属性:replaceProps
- 强制更新:forceUpdate
- 获取DOM节点:findDOMNode
- 判断组件挂载状态:isMounted
##### 4.2.4.1. 设置状态:setState
setState(object nextState[, function callback])
- 参数说明
- `nextState`,将要设置的新状态,该状态会和当前的state合并
- `callback`,可选参数,回调函数。该函数会在`setState`设置成功,且组件重新渲染后调用。
- 合并`nextState`和当前`state`,并重新渲染组件。`setState`是React事件处理函数中和请求回调函数中触发UI更新的主要方法。
- 关于setState
- 不能在组件内部通过`this.state`修改状态,因为该状态会在调用`setState()`后被替换。
- `setState()`并不会立即改变this.state,而是创建一个即将处理的state。`setState()`并不一定是同步的,为了提升性能React会批量执行state和DOM渲染。
- `setState()`总是会触发一次组件重绘,除非在`shouldComponentUpdate()`中实现了一些条件渲染逻辑。
var Counter = React.createClass({ getInitialState: function () { return { clickCount: 0 }; }, handleClick: function () { this.setState(function(state) { return {clickCount: state.clickCount + 1}; }); }, render: function () { return (
点我!点击次数为: {this.state.clickCount}
); } }); ReactDOM.render(
##### 4.2.4.2. 替换状态:replaceState
replaceState(object nextState[, function callback])
- nextState,将要设置的新状态,该状态会替换当前的state。
- callback,可选参数,回调函数。该函数会在replaceState设置成功,且组件重新渲染后调用。
`replaceState()`方法与`setState()`类似,但是方法只会保留nextState中状态,原state不在nextState中的状态都会被删除
##### 4.2.4.3. 设置属性:setProps
setProps(object nextProps[, function callback])
- nextProps,将要设置的新属性,该状态会和当前的props合并
- callback,可选参数,回调函数。该函数会在setProps设置成功,且组件重新渲染后调用。
设置组件属性,并重新渲染组件。<br />props相当于组件的数据流,它总是会从父组件向下传递至所有的子组件中。当和一个外部的JavaScript应用集成时,我们可能会需要向组件传递数据或通知`React.render()`组件需要重新渲染,可以使用`setProps()`。<br />更新组件,我可以在节点上再次调用`React.render()`,也可以通过`setProps()`方法改变组件属性,触发组件重新渲染。
##### 4.2.4.4. 替换属性:replaceProps
replaceProps(object nextProps[, function callback])
- nextProps,将要设置的新属性,该属性会替换当前的props。
- callback,可选参数,回调函数。该函数会在replaceProps设置成功,且组件重新渲染后调用。
`replaceProps()`方法与`setProps`类似,但它会删除原有props
##### 4.2.4.5. 强制更新:forceUpdate
forceUpdate([function callback])
- callback,可选参数,回调函数。该函数会在组件`render()`方法调用后调用。
`forceUpdate()`方法会使组件调用自身的`render()`方法重新渲染组件,组件的子组件也会调用自己的`render()`。但是,组件重新渲染时,依然会读取`this.props`和`this.state`,如果状态没有改变,那么React只会更新DOM。<br />`forceUpdate()`方法适用于`this.props`和`this.state`之外的组件重绘(如:修改了`this.state`后),通过该方法通知React需要调用`render()`<br />一般来说,应该尽量避免使用`forceUpdate()`,而仅从`this.props`和`this.state`中读取状态并由React触发`render()`调用。
##### 4.2.4.6. 获取DOM节点:findDOMNode
DOMElement findDOMNode()
- 返回值:DOM元素DOMElement
如果组件已经挂载到 DOM 中,该方法返回对应的本地浏览器 DOM 元素。当render返回 null 或 false 时,`this.findDOMNode()`也会返回null。从 DOM 中读取值的时候,该方法很有用,如:获取表单字段的值和做一些 DOM 操作。
##### 4.2.4.7. 判断组件挂载状态:isMounted
boolean isMounted()
- 返回值:true或false,表示组件是否已挂载到DOM中
`isMounted()`方法用于判断组件是否已挂载到DOM中。可以使用该方法保证了`setState()`和`forceUpdate()`在异步场景下的调用不会出错。
#### 4.2.5. 组件的生命周期
组件的运行过程中,存在不同的阶段。React 为这些阶段提供了钩子方法,允许开发者自定义每个阶段自动执行的函数。这些方法统称为生命周期方法(lifecycle methods)。
- 组件的生命周期可分成三个状态:
- **Mounting**:已插入真实 DOM
- **Updating**:正在被重新渲染
- **Unmounting**:已移出真实 DOM
- 生命周期的方法有:
- **componentWillMount**:在渲染前调用,在客户端也在服务端。
- **componentDidMount**:在第一次渲染后调用,只在客户端。之后组件已经生成了对应的DOM结构,可以通过`this.getDOMNode()`来进行访问。 如果你想和其他JavaScript框架一起使用,可以在这个方法中调用setTimeout, setInterval或者发送AJAX请求等操作(防止异部操作阻塞UI)。
- **componentWillReceiveProps**:在组件接收到一个新的prop时被调用。这个方法在初始化render时不会被调用。
- **shouldComponentUpdate**:返回一个布尔值。在组件接收到新的props或者state时被调用。在初始化时或者使用forceUpdate时不被调用。可以在你确认不需要更新组件时使用。
- **componentWillUpdate**:在组件接收到新的props或者state但还没有render时被调用。在初始化时不会被调用。
- **componentDidUpdate**:在组件完成更新后立即调用。在初始化时不会被调用。
- **componentWillUnmount**:在组件从 DOM 中移除的时候立刻被调用。
##### 4.2.5.1. 组件生命周期图

##### 4.2.5.2. 生命周期示例
import React from ‘react’; // 导入React class LifeCycle extends React.Component { constructor(props) { super(props); // 构造方法; console.log(“constructor()”); } componentDidMount() { // 组件挂载后调用 console.log(“componentDidMount()”); } componentWillUnmount() { // 在组件从 DOM 中移除之前立刻被调用。 console.log(“componentWillUnmount()”); } componentDidUpdate() { // 在组件完成更新后立即调用。在初始化时不会被调用。 console.log(“componentDidUpdate()”); } shouldComponentUpdate(nextProps, nextState) { // 每当this.props或this.state有变化,在render方法执行之前,就会调用这个方法。 // 该方法返回一个布尔值,表示是否应该继续执行render方法,即如果返回false,UI 就不会更新,默认返回true。 // 组件挂载时,render方法的第一次执行,不会调用这个方法。 console.log(“shouldComponentUpdate()”); } render() { return (
React Life Cycle!
#### 4.2.6. React 中 Component 和 PureComponent 比较
React 15.3 中新加了一个 `PureComponent` 类,顾名思义, pure 是纯的意思, `PureComponent` 也就是纯组件,取代其前身 `PureRenderMixin`, `PureComponent` 是优化 React 应用程序最重要的方法之一,易于实施,只要把继承类从 Component 换成 PureComponent 即可,可以减少不必要的 render 操作的次数,从而提高性能,而且可以少写 `shouldComponentUpdate` 函数,节省了点代码。
import React, { PureComponent } from ‘react’; class App extends PureComponent {}
```
import React, { Component } from 'react';
class App extends Component {}
Component是React App的基本构建的单位,也是React中的基本代码复用单位。PureComponent与Component在除了其shouldComponentUpdate方法的实现之外几乎完全相同。PureComponent已经替我们实现了shouldComponentUpdate方法。
对于PureComponent而言,当其props或者state改变之时,新旧props与state将进行浅对比(shallow comparison)。另一方面,Component默认的情况下其shouldComponentUpdate方法并不进行新旧props与state的对比。
因此意味着相比于Component,PureCompoent的性能表现将会更好。但使用PureCompoent要求满足如下条件:
- props和state都必须是不可变对象(immutable object)。
- props和state不能有层级嵌套的结构,(否则对子层级的改变无法反映在浅拷贝中)。
- 如果数据改变无法反应在浅拷贝上,则应该调用forceUpdate来更新Component。
- 一个PureComponent的子Component也应当是PureComponent。
4.3. React 的 Refs 属性
4.3.1. 简述
- React 支持一种非常特殊的属性 Ref ,你可以用来绑定到
render()
输出的任何组件上。 - 这个特殊的属性允许你引用
render()
返回的相应的支撑实例(backing instance)。这样就可以确保在任何时间总是拿到正确的实例。 - ref 属性的值可以是一个字符串也可以是一个函数。
4.3.2. 使用方法
绑定一个 ref 属性到 render 的返回值上 ```
在其它代码中,可以通过 this.refs 获取对应的支撑实例
var input = this.refs.myInput; var inputValue = input.value; var inputRect = input.getBoundingClientRect();
#### 4.3.3. 示例代码
通过使用 this 来获取当前 React 组件,或使用 ref 来获取组件的引用
var MyComponent = React.createClass({ handleClick: function() { // 使用原生的 DOM API 获取焦点 this.refs.myInput.focus(); }, render: function() { // 当组件插入到 DOM 后,ref 属性添加一个组件的引用于到 this.refs return (
ReactDOM.render(
### 4.4. Model
#### 4.4.1. 数据分层

- 上图中左侧是服务端代码的层次结构,由 Controller、Service、Data Access 三层组成服务端系统
- Controller 层负责与用户直接打交道,渲染页面、提供接口等,侧重于展示型逻辑。
- Service 层负责处理业务逻辑,供 Controller 层调用。
- Data Access 层顾名思义,负责与数据源对接,进行纯粹的数据读写,供 Service 层调用。
- 上图的右侧是前端代码的结构,同样需要进行必要的分层:
- Page 负责与用户直接打交道:渲染页面、接受用户的操作输入,侧重于展示型交互性逻辑。
- Model 负责处理业务逻辑,为 Page 做数据、状态的读写、变换、暂存等。
- Service 负责与 HTTP 接口对接,进行纯粹的数据读写。
#### 4.4.2. 使用DVA框架进行数据分层管理(好客租房项目使用,其他项目不一定使用)
dva是基于 redux、redux-saga 和 react-router 的轻量级前端框架。官网:[https://dvajs.com/](https://dvajs.com/)
##### 4.4.2.1. 引入dva框架
引入dva框架,由于umi对dva进行了整合,所以导入时只需要修改umi项目中的config.js文件,进行如下配置:
export default { plugins: [ [‘umi-plugin-react’, { dva: true // 开启dva功能 }] ] };
##### 4.4.2.2. 定义state数据
创建model文件夹,在umi中,约定在src/models文件夹中定义model,所以,在该文件夹下创建ListData.js文件<br /><br />将此前定义在组件中的state剪切到ListData.js文件中
export default { namespace: ‘list’, state: { data: [1, 2, 3], maxNum: 3 } }
对之前定义的List.jsx组件进行修改
import React from ‘react’; // 引入react import { connect } from ‘dva’; // 引入dva框架
// 定义变量,需要引入的model的命名空间 const namespace = ‘list’;
const mapStateToProps = (state) => { const listData = state[namespace].data; // 获取:[1, 2, 3] return { listData }; };
/ 参数1:函数,将model中的state数据映射到this.props中 / @connect(mapStateToProps) class List extends React.Component { render() { return (
-
{
// 遍历值
this.props.listData.map((value, index) => {
return
- {value} }) }
export default List;
测试会看到遍历对应的数据<br />**流程说明:**
1. umi框架启动,会自动读取models目录下model文件,即ListData.js中的数据
1. `@connect`修饰符的第一个参数,接收一个方法,该方法必须返回`{}`对象,将接收到model数据
1. 在全局的数据中,会有很多model数据,所以需要通过namespace进行区分,然后通过`state[namespace]`进行获取数据
1. 拿到model数据中state属性下的data数据,也就是`[1, 2, 3]`数据,进行包裹`{}`后返回
1. 返回的数据,将被封装到`this.props`中,所以通过`this.props.listData`即可获取到model中的数据
##### 4.4.2.3. 更新state数据
此前通过`this.setState()`可以修改组件中的state属性值,从而使react去刷新页面。
1. 使用dva框架对modle数据进行分层后,需要在model(案例中的ListData.js)中新增reducers方法,用于更新state中的数据
export default { namespace: ‘list’, state: { data: [1, 2, 3], maxNum: 3 }, reducers: { addNewData(state) { // state是更新前的对象 let maxNum = state.maxNum + 1; // 使用…扩展运算符,创建新的数组 let list = […state.data, maxNum]; return { // 返回更新后的state对象 data: list, maxNum: maxNum } } } }
2. 修改List.js新增点击事件
import React from ‘react’; // 引入react import { connect } from ‘dva’; // 引入dva框架
// 定义变量,需要引入的model的命名空间 const namespace = ‘list’;
/ 定义映射数据的函数 / const mapStateToProps = (state) => { const listData = state[namespace].data; // 获取:[1, 2, 3] const maxNum = state[namespace].maxNum; return { listData, maxNum }; };
/ 定义映射事件(方法)的函数 / const mapDispatchToProps = (dispatch) => { // 定义方法,dispatch是内置函数 return { // 返回的这个对象将绑定到this.props对象中 addNewData: () => { // 定义方法 dispatch({ // 通过调用dispatch()方法,调用model中reducers的方法 type: namespace + “/addNewData” // 指定方法,格式:namespace/方法名 }); } } }
/**
- 参数1:函数,将model中的state属性中定义的数据映射到this.props中
- 参数2:函数,将model中reducers属性中定义的方法映射到this.props中
*/
@connect(mapStateToProps, mapDispatchToProps)
class List extends React.Component {
render() {
} }return (
<div>
<ul>
{
// 遍历值
this.props.listData.map((value, index) => {
return <li key={index}>{value}</li>
})
}
</ul>
<button onClick={() => { this.props.addNewData() }}>
添加
</button>
</div>
);
export default List;
绑定方法流程梳理如下<br />
#### 4.4.3. 在model中请求数据
实现动态查询后台获取model里的数据
1. 在src下创建util目录,新建request.js文件(用于定义异步请求后端的工具js),输入如下内容
// import fetch from ‘dva/fetch’; function checkStatus(response) { if (response.status >= 200 && response.status < 300) { return response; } const error = new Error(response.statusText); error.response = response; throw error; }
/**
- Requests a URL, returning a promise. *
- @param {string} url The URL we want to request
- @param {object} [options] The options we want to pass to “fetch”
- @return {object} An object containing either “data” or “err” */ export default async function request(url, options) { const response = await fetch(url, options); checkStatus(response); return await response.json(); }
2. 修改model(即ListData.js)中新增请求方法,需要定义effects配置,用于异步加载数据
// 导入请求工具js import request from ‘../util/request’;
export default { namespace: ‘list’, state: { data: [], maxNum: 0 }, reducers: { addNewData(state, result) { // state是更新前的对象;result就是拿到的结果数据
// 判断result中的data是否存在,如果存在,说明是初始化数据,直接返回
if (result.data) {
return result.data;
}
let maxNum = state.maxNum + 1;
// 使用...扩展运算符,创建新的数组
let list = [...state.data, maxNum];
return { // 返回更新后的state对象
data: list,
maxNum: maxNum
}
}
},
effects: { // 新增effects配置,用于异步加载数据
*initData(params, sagaEffects) { // 定义异步方法
const { call, put } = sagaEffects; // 获取到call、put方法
const url = "/ds/list"; // 定义请求的url
let data = yield call(request, url); // 执行请求
yield put({ // 调用reducers中的方法
type: "addNewData", // 指定方法名
data: data // 传递ajax回来的数据
});
}
}
}
3. 修改页面(List.jsx)逻辑
import React from ‘react’; // 引入react import { connect } from ‘dva’; // 引入dva框架
// 定义变量,需要引入的model的命名空间 const namespace = ‘list’;
/ 定义映射数据的函数 / const mapStateToProps = (state) => { const listData = state[namespace].data; // 获取:[1, 2, 3] const maxNum = state[namespace].maxNum; return { listData, maxNum }; };
/ 定义映射事件(方法)的函数 /
const mapDispatchToProps = (dispatch) => { // 定义方法,dispatch是内置函数
return { // 返回的这个对象将绑定到this.props对象中
addNewData: () => { // 定义方法
dispatch({ // 通过调用dispatch()方法,调用model中reducers的方法
type: namespace + “/addNewData” // 指定方法,格式:namespace/方法名
});
},
/ 定义model中的初始化方法 /
initData: () => {
dispatch({
type: ${namespace}/initData
// 使用ES6字符串模板标记
});
}
}
}
/**
- 参数1:函数,将model中的state属性中定义的数据映射到this.props中
参数2:函数,将model中reducers属性中定义的方法映射到this.props中 */ @connect(mapStateToProps, mapDispatchToProps) class List extends React.Component {
/ 定义生命周期的钩子方法-组件挂载后调用 / componentDidMount() {
this.props.initData(); // 组件加载完后进行初始化操作
}
render() {
return (
<div>
<ul>
{
// 遍历值
this.props.listData.map((value, index) => {
return <li key={index}>{value}</li>
})
}
</ul>
<button onClick={() => { this.props.addNewData() }}>
添加
</button>
</div>
);
} }
export default List;
测试结果,发现会报错,原因是返回的是html代码,数据不是json导致解析出错。<br /><br />
#### 4.4.4. mock数据
umi中支持对请求的模拟,当没有后端服务的时候,可以使用mock数据进行测试<br />在项目根目录下创建mock目录,然后创建MockListData.js文件,并且输入如下内容:
export default { ‘get /ds/list’: function (req, res) { // 模拟请求返回数据 res.json({ data: [1, 2, 3, 4], maxNum: 4 }); } }
## 5. Ant Design入门
### 5.1. 什么是Ant Design
- Ant Design是阿里蚂蚁金服团队基于React开发的ui组件,主要用于中后台系统的使用。
- 官网:[https://ant.design/index-cn](https://ant.design/index-cn)
- 特性:
- 提炼自企业级中后台产品的交互语言和视觉风格。
- 开箱即用的高质量 React 组件。
- 使用 TypeScript 构建,提供完整的类型定义文件。
- 全链路开发和设计工具体系。
### 5.2. 快速使用
#### 5.2.1. 引入Ant Design
Ant Design 是一个服务于企业级产品的设计体系,组件库是它的 React 实现,antd 被发布为一个 npm 包方便开发者安装并使用。<br />在umi中,你可以通过在插件集umi-plugin-react中配置antd打开antd插件,antd插件会帮你引入antd并实现按需编译。<br />在config.js文件中进行配置:
export default { plugins: [ [‘umi-plugin-react’, { dva: true, // 开启dva功能 antd: true // 开启Ant Design功能 }] ] };
#### 5.2.2. 使用antd组件
以tabs组件为例,官网组件使用示例说明:[https://ant.design/components/tabs-cn/](https://ant.design/components/tabs-cn/)<br />创建MyTabs.jsx文件,复制官网组件示例代码,修改后运行查询效果
import React from ‘react’; import { Tabs } from ‘antd’;
const TabPane = Tabs.TabPane;
const callback = (key) => { console.log(key); }
class MyTabs extends React.Component {
render() {
return(
export default MyTabs;
### 5.3. 布局
antd布局官网示例:[https://ant.design/components/layout-cn/](https://ant.design/components/layout-cn/)<br />在后台系统页面布局中,一般是经典的三部分布局<br />
#### 5.3.1. 组件概述
- `Layout` :布局容器,其下可嵌套 `Header` `Sider` `Content` `Footer` 或 `Layout` 本身,可以放在任何父容器中。
- `Header` :顶部布局,自带默认样式,其下可嵌套任何元素,只能放在Layout中。
- `Sider` :侧边栏,自带默认样式及基本功能,其下可嵌套任何元素,只能放在Layout中。
- `Content` :内容部分,自带默认样式,其下可嵌套任何元素,只能放在Layout中。
- `Footer` :底部布局,自带默认样式,其下可嵌套任何元素,只能放在Layout中
#### 5.3.2. 搭建整体框架
1. 在src目录下创建layouts目录,并且在layouts目录下创建index.jsx文件,根据官网示例,修改相应的代码:
import React from ‘react’ import { Layout } from ‘antd’;
const { Header, Footer, Sider, Content } = Layout;
class BasicLayout extends React.Component {
render() {
return (
export default BasicLayout;
> 需要特别说明的是,在umi中约定的目录结构中,layouts/index.js文件将被作为全局的布局文件
2. 配置路由:修改config.js文件(非必须)
export default { plugins: [ [‘umi-plugin-react’, { dva: true, // 开启dva功能 antd: true // 开启Ant Design功能 }] ], routes: [{ path: ‘/‘, component: ‘../layouts’ // 配置布局路由 }] };
3. 输入url:http://localhost:8000/,进行测试
#### 5.3.3. 子页面使用布局
1. 需要在布局文件中,将Content内容替换成{this.props.children},意思是引入传递的内容。
import React from ‘react’ import { Layout } from ‘antd’;
const { Header, Footer, Sider, Content } = Layout;
class BasicLayout extends React.Component {
render() {
return (
export default BasicLayout;
2. 配置路由(注意,在布局路由下面进行配置):
export default { plugins: [ [‘umi-plugin-react’, { dva: true, // 开启dva功能 antd: true // 开启Ant Design功能 }] ], routes: [{ path: ‘/‘, component: ‘../layouts’, // 配置布局路由 routes: [{ // 在这里进行配置子页面 path: ‘/myTabs’, component: ‘./MyTabs’ }] }] };
> **说明:上面的路由配置,是表明你需要通过手动配置的方式上进行访问页面,而不采用umi默认的路由方式。**
3. 输入`http://localhost:8000/myTabs`进行访问测试。
#### 5.3.4. 美化页面
import React from ‘react’ import { Layout } from ‘antd’;
const { Header, Footer, Sider, Content } = Layout;
class BasicLayout extends React.Component {
render() {
return (
export default BasicLayout;
#### 5.3.5. 引入导航条
使用Menu组件作为导航条,官网示例:[https://ant.design/components/menu-cn/](https://ant.design/components/menu-cn/)
import React from ‘react’ import { Layout, Menu, Icon, } from ‘antd’;
const { Header, Footer, Sider, Content } = Layout; const SubMenu = Menu.SubMenu;
class BasicLayout extends React.Component {
constructor(props) {
super(props);
this.state = {
collapsed: false,
}
}
render() {
return (
<Layout>
<Sider width={256} style={{ minHeight: '100vh', color: 'white' }}>
<div style={{ height: '32px', background: 'rgba(255,255,255,.2)', margin: '16px' }} />
<Menu
defaultSelectedKeys={['2']}
defaultOpenKeys={['sub1']}
mode="inline"
theme="dark"
inlineCollapsed={this.state.collapsed}
>
<Menu.Item key="1">
<Icon type="pie-chart" />
<span>Option 1</span>
</Menu.Item>
<Menu.Item key="2">
<Icon type="desktop" />
<span>Option 2</span>
</Menu.Item>
<Menu.Item key="3">
<Icon type="inbox" />
<span>Option 3</span>
</Menu.Item>
<SubMenu key="sub1" title={<span><Icon type="mail" /><span>Navigation One</span></span>}>
<Menu.Item key="5">Option 5</Menu.Item>
<Menu.Item key="6">Option 6</Menu.Item>
<Menu.Item key="7">Option 7</Menu.Item>
<Menu.Item key="8">Option 8</Menu.Item>
</SubMenu>
<SubMenu key="sub2" title={<span><Icon type="appstore" /><span>Navigation Two</span></span>}>
<Menu.Item key="9">Option 9</Menu.Item>
<Menu.Item key="10">Option 10</Menu.Item>
<SubMenu key="sub3" title="Submenu">
<Menu.Item key="11">Option 11</Menu.Item>
<Menu.Item key="12">Option 12</Menu.Item>
</SubMenu>
</SubMenu>
</Menu>
</Sider>
<Layout>
<Header style={{ background: '#fff', textAlign: 'center', padding: 0 }}>Header</Header>
<Content style={{ margin: '24px 16px 0' }}>
<div style={{ padding: 24, background: '#fff', minHeight: 360 }}>
{this.props.children}
</div>
</Content>
<Footer style={{ textAlign: 'center' }}>后台系统 ©2019Created by MooNkirA</Footer>
</Layout>
</Layout>
);
}
}
export default BasicLayout;
#### 5.3.6. 为导航添加链接
对左侧的导航条添加链接,点击相应的链接在右侧进行相应页面的显示。
1. 在src/pages目录下创建user目录,并在该目录下创建UserAdd.jsx和UserList.jsx文件,用于模拟实现新增用户和查询用户列表功能。
/ UserAdd.jsx / import React from ‘react’ class UserAdd extends React.Component { render() { return (
```
/* UserList.jsx */
import React from 'react'
class UserList extends React.Component {
render() {
return (
<div>用户列表</div>
);
}
}
export default UserList;
- 修改config.js,配置路由(如果使用umi默认的路由规则,则不需要配置,默认的路由是以pages文件夹为根目录)
```
export default {
plugins: [
], routes: [{['umi-plugin-react', {
dva: true, // 开启dva功能
antd: true // 开启Ant Design功能
}]
}] };path: '/',
component: '../layouts', // 配置布局路由
routes: [
{ // 在这里进行配置子页面
path: '/myTabs',
component: './MyTabs'
},
{
path: '/user',
routes: [
{
path: '/user/list',
component: './user/UserList'
},
{
path: '/user/add',
component: './user/UserAdd'
}
]
}
]
3. 为菜单添加链接
import React from ‘react’ import { Layout, Menu, Icon, } from ‘antd’; import Link from ‘umi/link’; // 引入umi框架的链接标签
const { Header, Footer, Sider, Content } = Layout; const SubMenu = Menu.SubMenu;
class BasicLayout extends React.Component {
constructor(props) {
super(props);
this.state = {
collapsed: false,
}
}
render() {
return (
<Layout>
<Sider width={256} style={{ minHeight: '100vh', color: 'white' }}>
<div style={{ height: '32px', background: 'rgba(255,255,255,.2)', margin: '16px' }} />
<Menu
defaultSelectedKeys={['1']} // 默认选择的菜单
defaultOpenKeys={['sub1']} // 默认展开的二级菜单
mode="inline"
theme="dark"
inlineCollapsed={this.state.collapsed}
>
<SubMenu key="sub1" title={<span><Icon type="user" /><span>用户管理</span></span>}>
<Menu.Item key="1">
<Link to="/user/list">用户列表</Link> // umi框架默认路由url是pages文件夹开始
</Menu.Item>
<Menu.Item key="2">
<Link to="/user/add">新增用户</Link>
</Menu.Item>
</SubMenu>
</Menu>
</Sider>
<Layout>
<Header style={{ background: '#fff', textAlign: 'center', padding: 0 }}>Header</Header>
<Content style={{ margin: '24px 16px 0' }}>
<div style={{ padding: 24, background: '#fff', minHeight: 360 }}>
{this.props.children}
</div>
</Content>
<Footer style={{ textAlign: 'center' }}>后台系统 ©2019Created by MooNkirA</Footer>
</Layout>
</Layout>
);
}
}
export default BasicLayout;
### 5.4. 表格
#### 5.4.1. 基本用法
- 参考官方文档进行实现:[https://ant.design/components/table-cn/](https://ant.design/components/table-cn/)
- 改造 UserList.jsx页面:
import React from ‘react’ import { Table, Divider, Tag, Pagination } from ‘antd’; const { Column } = Table; const data = [{ key: ‘1’, name: ‘张三’, age: 32, address: ‘上海市’, tags: [‘程序员’, ‘帅气’], }, { key: ‘2’, name: ‘李四’, age: 42, address: ‘北京市’, tags: [‘屌丝’], }, { key: ‘3’, name: ‘王五’, age: 32, address: ‘杭州市’, tags: [‘高富帅’, ‘富二代’], }]; class UserList extends React.Component { render() { return (
); } } export default UserList;
#### 5.4.2. 将数据分离到model中
- model的实现:在models文件夹下创建UserListData.js
import request from “../util/request”; export default { namespace: ‘userList’, state: { list: [] }, effects: { *initData(params, sagaEffects) { const { call, put } = sagaEffects; const url = “/ds/user/list”; let data = yield call(request, url); yield put({ type: “queryList”, data: data }); } }, reducers: { queryList(state, result) { let data = […result.data]; return { //更新状态值 list: data } } } }
- 修改UserList.jsx中的逻辑:
import React from ‘react’; import { connect } from ‘dva’; import { Table, Divider, Tag, Pagination } from ‘antd’; const { Column } = Table;
const namespace = ‘userList’;
@connect((state) => { return { data: state[namespace].list } }, (dispatch) => { return { initData: () => { dispatch({ type: namespace + “/initData” }); } } }) class UserList extends React.Component {
/* 加载后执行初始化数据 */
componentDidMount() {
this.props.initData();
}
render() {
return (
<div>
<Table dataSource={this.props.data} pagination=
{{ position: "bottom", total: 500, pageSize: 10, defaultCurrent: 3 }}>
<Column
title="姓名"
dataIndex="name"
key="name"
/>
<Column
title="年龄"
dataIndex="age"
key="age"
/>
<Column
title="地址"
dataIndex="address"
key="address"
/>
<Column
title="标签"
dataIndex="tags"
key="tags"
render={tags => (
<span>
{tags.map(tag => <Tag color="blue" key=
{tag}>{tag}</Tag>)}
</span>
)}
/>
<Column
title="操作"
key="action"
render={(text, record) => (
<span>
<a href="javascript:;">编辑</a>
<Divider type="vertical" />
<a href="javascript:;">删除</a>
</span>
)}
/>
</Table>
</div>
);
}
} export default UserList;
- mock数据:修改MockListData.js文件,增加用户列表的模拟数据
export default { ‘get /ds/list’: function (req, res) { // 模拟请求返回数据 res.json({ data: [1, 2, 3, 4], maxNum: 4 }); }, ‘get /ds/user/list’: function (req, res) { // 模拟请求返回数据 res.json({ key: ‘1’, name: ‘张三’, age: 32, address: ‘上海市’, tags: [‘程序员’, ‘帅气’] }, { key: ‘2’, name: ‘李四’, age: 42, address: ‘北京市’, tags: [‘屌丝’] }, { key: ‘3’, name: ‘王五’, age: 32, address: ‘杭州市’, tags: [‘高富帅’, ‘富二代’] }); } }
```