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"; // 定义请求的urllet 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 DesignAnt 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' }} /><MenudefaultSelectedKeys={['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' }} /><MenudefaultSelectedKeys={['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 }}><Columntitle="姓名"dataIndex="name"key="name"/><Columntitle="年龄"dataIndex="age"key="age"/><Columntitle="地址"dataIndex="address"key="address"/><Columntitle="标签"dataIndex="tags"key="tags"render={tags => (<span>{tags.map(tag => <Tag color="blue" key={tag}>{tag}</Tag>)}</span>)}/><Columntitle="操作"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: [‘高富帅’, ‘富二代’] }); } }
```
