【前言】
找了很多Admin模板,最后还是看中了AntDesignPro这个阿里巴巴开源的Admin框架,长这样(还行吧,目前挺主流的):
官网地址:https://pro.ant.design/index-cn
该套模板是使用了React开发框架作为基础,AntDesign(蚂蚁金服开源UI组件库)作为UI库,集成了Dva,Umi,Mock等库,如果不是很了解这些内容,门槛还是比较高的,下面我们梳理一下从零开始运行起来这个项目的过程。
【准备环境】
- node js 安装最新版即可
我的nodejs版本 v12.18.3 - npm npm服务器在国外,访问比较慢,可以更换成国内源:
npm config set registry https://registry.npm.taobao.org
当然也可以安装cnpm(采用的国内源),使用时需要npm命令的地方都换成cnpm
npm install -g cnpm --registry=https://registry.npm.taobao.org
【开始整Antd Pro】
Ant Design Pro的安装方式有几种,可以自行选择:
1. git clone(稳定,没啥坑,速度偏慢github)
git clone https://github.com/ant-design/ant-design-pro.git
cd ant-design-pro
npm install
npm start
2. 官网推荐的方法
新建一个空的文件夹作为项目目录,并在目录下执行:
npm create umi
然后等待安装依赖,完毕后会提示选择模板,我们选择第一个 ant-design-pro(完整的pro模板):
Select the boilerplate type (Use arrow keys)
❯ ant-design-pro - Create project with an layout-only ant-design-pro boilerplate, use together with umi block.
app - Create project with a simple boilerplate, support typescript.
block - Create a umi block.
library - Create a library with umi.
plugin - Create a umi plugin.
选择模板后,会弹出选择版本,我们选择v5(v5默认是typescript版本,也是antd pro的最新开发模式,v4可以选择javascript/typescript两种版本,如果不想用typescript方式,可以选择v4,然后再选择javascript即可。
Ant Design Pro 脚手架将会自动安装...
运行Antd Pro(Ant Design Pro,下文简称Antd Pro)
安装教授架完毕后,执行命令:
npm install
npm start
如果重试几次还报错,可以考虑换cnpm试试,我这就cnpm好使
cnpm install
cnpm start
等待webpack building完成
我们打开浏览器输入 http://localhost:8000 即可看到初始页面,大概长这样:
可能我们想参考官网展示的大量组件的代码,那么,我们如何得到官网这个较为完整的效果呢?
其实很简单,在启动的时候,我们加个参数 fetch:blocks ,会自动安装完整的组件到我们的代码中
cnpm run fetch:blocks
输入命令会执行漫长地下载安装过程,安装完毕后,重新启动即可
【简单介绍一下】
目录结构
Antd Pro 已经为你生成了一个完整的开发框架,提供了涵盖中后台开发的各类功能和坑位,下面是整个项目的目录结构。
├── config # umi 配置,包含路由,构建等配置
├── mock # 本地模拟数据
├── public
│ └── favicon.png # Favicon
├── src
│ ├── assets # 本地静态资源
│ ├── components # 业务通用组件
│ ├── e2e # 集成测试用例
│ ├── layouts # 通用布局
│ ├── models # 全局 dva model
│ ├── pages # 业务页面入口和常用模板
│ ├── services # 后台接口服务,请求服务端接口的都放在这里
│ ├── utils # 工具库
│ ├── locales # 国际化资源
│ ├── global.less # 全局样式
│ └── global.ts # 全局 JS
├── tests # 测试工具
├── README.md
└── package.json
内置模板
- Dashboard
- 分析页
- 监控页
- 工作台
- 表单页
- 基础表单页
- 分步表单页
- 高级表单页
- 列表页
- 查询表格
- 标准列表
- 卡片列表
- 搜索列表(项目/应用/文章)
- 详情页
- 基础详情页
- 高级详情页
- 结果
- 成功页
- 失败页
- 异常
- 403 无权限
- 404 找不到
- 500 服务器出错
- 个人页
- 个人中心
- 个人设置
- 图形编辑器
- 流程图编辑器
- 脑图编辑器
- 拓扑编辑器
- 帐户
- 登录
- 注册
- 注册成功
代码结构基本长这样
模板内建了模拟数据、HMR 实时预览、状态管理、国际化、全局路由等等各种实用的功能辅助开发,想要了解更多可以访问官网(目前比较粗糙)
官网地址:https://pro.ant.design/index-cn