react-admin system solution
文档地址:wiki
网上react后台管理开源免费的完整版项目比较少,所以利用空余时间集成了一个版本出来,已放到GitHub 启动和打包的时间都稍长,请耐心等待两分钟
项目是用create-react-app创建的,主要还是列出新加的功能依赖包
点击名称可跳转相关网站😄😄
- react@15.5.0
- react-router@3.0.2(react路由,4.x的差异还是比较大,暂时还是3.x的版本)
- antd@2.9.3(蚂蚁金服开源的react ui组件框架)
- axios@0.16.1(http请求模块,可用于前端任何场景,很强大👍)
- echarts-for-react@1.2.0(可视化图表,别人基于react对echarts的封装,足够用了)
- recharts@0.22.3(另一个基于react封装的图表,个人觉得是没有echarts好用)
- nprogress@0.2.0(顶部加载条,蛮好用👍)
- react-draft-wysiwyg@1.9.6(别人基于react的富文本封装,如果找到其他更好的可以替换)
- react-draggable@2.2.4(拖拽模块,找了个简单版的)
- screenfull@3.2.0(全屏插件)
- photoswipe@4.1.2(图片弹层查看插件,不依赖jQuery,还是蛮好用👍)
- animate.css@3.5.1(css动画库)
- 其他小细节省略
备注:项目只引入了ant-design的部分组件,其他的组件antd官网有源码,可以直接复制到项目中使用,后续有时间补上全部组件。 项目使用了antd的自定义主题功能-->黑色,若想替换其他颜色,具体操作请查看antd官网
- 首页
- 完整布局
- 换肤(全局功能,暂时只实现了顶部导航的换肤,后续加上其他模块)
- 导航菜单
- 顶部导航(菜单伸缩,全屏功能)
- 左边菜单(增加滚动条以及适配路由的active操作)
- UI模块
- 按钮(antd组件)
- 图标(antd组件并增加彩色表情符)
- 加载中(antd组件并增加顶部加载条)
- 通知提醒框(antd组件)
- 标签页(antd组件)
- 轮播图(ant动效组件)
- 富文本
- 拖拽
- 画廊
- 动画
- 基础动画(animate.css所有动画)
- 动画案例
- 表格
- 基础表格(antd组件)
- 高级表格(antd组件)
- 异步表格(数据来自掘金酱的接口)
- 表单
- 基础表单(antd组件)
- 图表
- echarts图表
- recharts图表
- 页面
- 登录页面(包括GitHub第三方登录)
- 404页面
+-- build/ ---打包的文件目录
+-- config/ ---npm run eject 后的配置文件目录
+-- node_modules/ ---npm下载文件目录
+-- public/
| --- index.html ---首页入口html文件
| --- npm.json ---echarts测试数据
| --- weibo.json ---echarts测试数据
+-- src/ ---核心代码目录
| +-- axios ---http请求存放目录
| | --- index.js
| +-- components ---各式各样的组件存放目录
| | +-- animation ---动画组件
| | | --- ...
| | +-- charts ---图表组件
| | | --- ...
| | +-- dashboard ---首页组件
| | | --- ...
| | +-- forms ---表单组件
| | | --- ...
| | +-- pages ---页面组件
| | | --- ...
| | +-- tables ---表格组件
| | | --- ...
| | +-- ui ---ui组件
| | | --- ...
| | --- BreadcrumbCustom.jsx ---面包屑组件
| | --- HeaderCustom.jsx ---顶部导航组件
| | --- Page.jsx ---页面容器
| | --- SiderCustom.jsx ---左边菜单组件
| +-- style ---项目的样式存放目录,主要采用less编写
| +-- utils ---工具文件存放目录
| --- App.js ---组件入口文件
| --- index.js ---项目的整体js入口文件,包括路由配置等
--- .env ---启动项目自定义端口配置文件
--- .eslintrc ---自定义eslint配置文件,包括增加的react jsx语法限制
--- package.json
npm i
npm start
npm run build
- 依赖包版本升级
- react@15.6.1
- antd@2.11.2
- webpack@2.6.1
- 等等
- 引入redux系列
- redux@3.7.2
- redux-thunk@2.2.0
- react-redux@5.0.5
- 增加权限管理模块
- 使用easy-mock模拟数据模拟登录接口
- 使用redux系列将登录用户数据传递给权限组件
- 权限组件采用Render Callback的方式传递权限给需要受控制的组件(具体做法请查看源代码。)
- 用户状态保存在localStorage中
- 具体做法请运行项目查看
- PS:以上管理权限只是一种方式,但这绝对不是唯一的方式,也不是最好的方式。如果你有更好的方式,不妨加上面的群和大家一起分享下。😄😄
- 增加路径别名
- 使用@别名处理引入组件相对路径过长问题。
- 缺点:编辑器不能使用快捷提示和快捷跳转到相应的文件
- 权限管理模块增加页面跳转权限验证
- 点击权限管理的路由拦截,若没有访问权限则会跳转到404页面。
- 大致实现方式(非常简单):通过向自定义router组件传入store,登录之后可获取到redux中的权限state数据,并通过判断是否包含权限进行跳转。ps: 该demo的效果是管理员登录之后才能跳转到路由拦截页面。具体操作请拉取代码尝试。
- 增加响应式布局
- 依赖包版本升级
- antd@2.13.1(目前最新版)
- 开发环境增加react-hot-loader-保持状态刷新组件(译:实时调整组件),可参考以下相关项目
- 依赖包版本升级
- antd@3.0.1(目前最新版)
- react-router-dom@4.2.2
- 大改动
- react-router切换4.x版本,切换响应的版本路由写法(具体见代码更新日志)
- ps: react-router 3.x的版本请查看代码分支router3.x
- 增加cssmodule的支持(css, less)
- 建议用css预处理器,文件名为xxx.module.less,引入相应组件即可使用。 - 具体做法参见新增模块,路由后缀:/app/cssModule。点击访问
该项目会不定时更新,后续时间会添加更多的模块
欢迎和感谢大家PR~~👏👏
若有问题,可加QQ群264591039与我交流
ps:以上群满的时候请加群:592688854
如果对你有帮助,给个star哟~~❤️❤️❤️❤️