Ant Design Pro V2 运用点滴 [1]

github地址:https://github.com/ant-design/ant-design-pro
文档地址:https://pro.ant.design/docs/getting-started-cn

前序准备

你的本地环境需要安装 nodegit。技术栈基于 ES2015+ReactUmiJSdvag2antd

进行开发之前,你需要一定的react语法、Js(ES6)、dva的基础。看完以下链接就开始写页面吧,遇到不会的再去查,这样学比较快。

目录结构

├── config                    #umi 配置,包含路由,构建等配置
├── mock                     # 本地模拟数据
├── public
│   └── favicon.png          # Favicon
├── src
│   ├── assets               # 本地静态资源
│   ├── components           # 业务通用组件
│   ├── e2e                  # 集成测试用例
│   ├── layouts              # 通用布局
│   ├── models               # 全局 dva model
│   ├── pages                # 业务页面入口和常用模板
│   ├── services             # 后台接口服务
│   ├── utils                # 工具库
│   ├── locales              # 国际化资源
│   ├── global.less          # 全局样式
│   └── global.js            # 全局 JS
├── tests                    # 测试工具
├── README.md
└── package.json

安装

从 GitHub 仓库中直接安装最新的脚手架代码。

$ git clone --depth=1 https://github.com/ant-design/ant-design-pro.git my-project
$ cd my-project

本地开发

$ npm install    //安装依赖
$ npm start     //启动

如果网络状况不佳,可以使用 cnpm 进行加速。
启动完成后会自动打开浏览器访问 http://localhost:8000

首页截图

新建一个页面。

1.在路由中新建一条页面的配置。先不要管报错,因为路由对应的component和models你还没有,继续往下看。这个在config\router.config.js里进行添加。

      {
        name: 'book',
        icon: 'book',
        path: '/book',
        hideChildrenInMenu:true,
        routes: [
          { path: '/book', component: '/book/List' }
          {
            path: '/book/list',
            name: 'list',
            component: './Book/List',
          },
          {
            path: '/book/detail',
            name: 'list',
            component: './Book/detail',
          },
        ],
      },
      /**省略*/

。book为model,要在pages目录新建book文件夹,里面放list,detail文件
。path: '/book/list',:显示路径,
。name:菜单名称
。component: 即为该路由记录对应的实际组件
。 name 和 icon分别代表生成菜单项的图标和文本。
。 hideChildrenInMenu 用于隐藏不需要在菜单中展示的子路由。用法可以查看 分步表单 的配置
。 hideInMenu 可以在菜单中不展示这个路由,包括子路由。效果可以查看 exception/trigger页面
。 authority 用来配置这个路由的权限,如果配置了将会验证当前用户的权限,并决定是否展示
你可能注意到配置中的 name 和菜单实际展示的不同,这是因为使用了全球化组件的原因

2,新建菜单项
这个在src\locales\zh-CN.js与 src\locales\zh-CN\menu.js里进行添加。

import globalHeader from './zh-CN/globalHeader';
import login from './zh-CN/login';
import menu from './zh-CN/menu';
import monitor from './zh-CN/monitor';
import result from './zh-CN/result';
import settingDrawer from './zh-CN/settingDrawer';
import settings from './zh-CN/settings';
import pwa from './zh-CN/pwa';
import translator from './zh-CN/book';   //新增加的
export default {
  'menu.home': '首页', 
  'menu.book': '图书',          //新增加的
  'menu.book.list': '图书列表',      
  'menu.book.detail': '图书详情',
  'menu.form': '表单',
  'menu.form.basicform': '基础表单',
  'menu.form.stepform': '分步表单',
  'menu.form.stepform.info': '分步表单(填写转账信息)',
  'menu.form.stepform.confirm': '分步表单(确认转账信息)',
  'menu.form.stepform.result': '分步表单(完成)',
  'menu.form.advancedform': '高级表单',
  'menu.list': '内容',
  /**省略*/
};

3,新建Book文件夹 ,
路由增一条之后,需要去对应的路径新建页面。一般都放在pages文件夹中,在pages中主要涉及两个操作,第一个就是如何拿到数据,第二个就是如何发送同步或异步请求来更新页面数据。

  • 如何拿到数据
    在该模块中,就是每个路由所对应的页面,下面主要了解数据是如何在页面中取到的:
import { connect } from 'dva';
 
@connect(({ article,loading }) => ({
  book,
  loading: loading.models.book,
}))
export default class Problem extends PureComponent {
  render() {
    const { problem, user } = this.props;
    return (
      <div title="题目">{problem.title}</div>
    );
  }
}

从上面的代码可以看到在页面中导入了dva框架,用dva的connect方法可以拿到所有的state,我们只需要在页面中获取需要的state即可。拿到之后所有的数据都是以props的形式嵌入页面的,也就是我们就像操作props来对待这些数据即可。

  • 如何更新页面数据
    在和model关联的页面中,都会给页面传入dispatch() 这个方法,该方法就是分发的意思,可以发出一个Action,Action是Redux中的概念,发出这个Action后就会找到页面所对应的model,然后做出相应的处理。如下:
componentDidMount() {
   const { dispatch } = this.props;
   dispatch({         //dispatch相当于触发一个action
     type: 'book/fetch',   //  models文件夹下book文件里面effects下面的*fetch方法
     payload: {   //  提交的参数
       id: this.props.match.params.id,
     },
   });
 }

dispatch中的参数就是一个Action。第一个type字段由两部分组成,前半部分是model的namespace(命名空间),后半部分是该Action的处理位置,对应model中的effects(处理异步逻辑),或reducers(处理同步逻辑)。

4,新建model文件,在model中触发指定的action

import { book} from '../services/api';

export default {
  namespace: 'book',

  state: {
    data: {
      list: [],
      pagination: {},
    },
  },

  effects: {
    *fetch({ payload }, { call, put }) { 
      const response = yield call(book, payload);  // 请求services文件夹
      yield put({      // 请求成功后 执行 reducers里面的save方法
        type: 'save',
        payload: response,
      });
    },
  },

  reducers:{
      queryList(state, action){
          //将服务器的数据刷新到页面中
         return{
              ...state,
              results:action.payload, 
         };
  },
 },
};

namespace:该字段就相当于model的索引,根据该命名空间就可以找到页面对应的model;
state:表示这个models下存储的数据,
effects: 处理所有的异步逻辑,将返回结果以Action的形式交给reducer处理;
reducers:处理所有的同步逻辑,将数据返回给页面;

5,service文件夹下新建API地址
发送请求到/api/listUser这个地址,就是模仿一下后台接口的实现,对请求进行了进一步的封装。

export async function queryUser(params) {
  return request(`/api/book?${stringify(params)}`);
}

6,在目录mock文件下模拟数据,
Mock的功能就是可以在本地模拟后台的行为,

参考资料:
ant-design-pro浅析总结 https://blog.csdn.net/qq_40963664/article/details/80678884
antdpro 获取数据,触发请求到服务器 https://www.jianshu.com/p/7dd08549d450
Ant Design Pro 上手备忘录 https://segmentfault.com/a/1190000013102730?utm_source=tag-newest
使用ant design Pro开发项目的小结 https://juejin.im/post/5b4604c8f265da0f6131f27a

http://blog.poetries.top/2018/09/16/ant-design-pro/ Ant Design Pro总结篇
https://www.smwenku.com/a/5b7e83a32b7177683857c4bb/zh-cn/ 表单
https://www.cnblogs.com/xujiazheng/p/7500547.html redux的基本原理(Redux 是 JavaScript 状态容器,提供可预测化的状态管理。)
https://blog.csdn.net/u013510614/article/details/51679012 React服务器端渲染
https://github.com/dvajs/dva-example-user-dashboard 《12 步 30 分钟,完成用户管理的 CURD 应用 (react+dva+antd)》
https://blog.csdn.net/weixin_40792878/article/details/82050726 dva学习--在组件中dispatch一个action
https://blog.csdn.net/weixin_40792878/article/details/81606792 dva学习-model的数据管理
待续>>>

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,189评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,577评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,857评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,703评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,705评论 5 366
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,620评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,995评论 3 396
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,656评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,898评论 1 298
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,639评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,720评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,395评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,982评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,953评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,195评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,907评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,472评论 2 342

推荐阅读更多精彩内容