趁着周末偷来一点闲,总结近期的工作和学习,想着该花点心思把N3-admin这套基于N3-components的单页应用模板简单的给介绍一下。
首发于个人博客;blog.lxstart.net
项目路径: https://github.com/N3-components/N3-admin
ps: 本项目不同于vue-admin等模板项目介绍大量的组件,基础组件的用法请参考:https://n3-components.github.io/N3-components/
1、概述
首先N3-admin是一个基于vue / vuex / vue-router / N3 / axios 的单页应用,适用于单页应用的快速上手,并不仅限于N3-components的使用,而是提供一个比较完善的项目构建的思路和结构,提供给初学者学习。同时也是一套可扩展的Vue单页应用开发模板。
项目工程基于Vue-cli,因此大部分同学都能快速上手和理解,往下介绍一下特性和结构。
2、特性
[x] 项目工程相关
- [x] 开发环境;静态文件服务器、HTTP代理、热更新
- [x] 生产构建:代码编译提取压缩合并混淆hash命名base64~
- [x] eslint
- [x] babel
- [x] webpack 2.x
[x] vue
- [x] 组件分级 [路由级组件、复用型组件、基础组件(N3)]
- [x] Vue扩展 [filters、directives等]
vue-router
- [x] 二级路由
- [x] 转场动画
- [x] 路由拦截器
vuex
- [x] 多模块(module)支持
[x] axios
- [x] 支持多实例
- [x] 请求、响应拦截器
- [x] Vue 扩展,通过实例的方法可访问
- [x] layout 布局
- [x] 全局进度条 Nprogress
[x] css 预处理
- [x] less
- [x] postcss
- [] stylus <= 仅需安装预处理器和loader
- [] sass / scss <= 仅需安装预处理器和loader
[x] API 调用支持
- [x] 接口配置
- [] mock
3、布局方式
二级路由下生效
4、文件结构
.
├── README.md <= 项目介绍
├── build <= 工程构建相关 <Vue-cli>
│ ├── build.js <= 构建脚本
│ ├── check-versions.js <= Node Npm版本检查
│ ├── dev-client.js <= 开发客户端:浏览器刷新
│ ├── dev-server.js <= 开发服务器:静态文件服务器、代理、热更新
│ ├── utils.js <= utils
│ ├── webpack.base.conf.js <= webpack基础配置
│ ├── webpack.dev.conf.js <= webpack开发配置
│ └── webpack.prod.conf.js <= webpack生产配置
├── config <= 工程构建配置:开发服务器端口、代理,静态资源打包位置等
│ ├── dev.env.js <= 开发环境配置
│ ├── index.js <= 入口
│ ├── prod.env.js <= 生产环境配置
│ └── test.env.js <= 测试环境配置
├── index.html <= 单页应用入口
├── package-lock.json <= Npm Package 版本锁
├── package.json <= Npm Package 配置
├── src <= 项目源代码
│ ├── App.vue <= Vue 根组件
│ ├── api.js <= api 配置
│ ├── assets <= 静态资源
│ │ ├── font
│ │ │ ├── iconfont.eot
│ │ │ ├── iconfont.svg
│ │ │ ├── iconfont.ttf
│ │ │ └── iconfont.woff
│ │ ├── images
│ │ │ └── logo.png
│ │ ├── logo.png
│ │ └── styles
│ │ └── base.css
│ ├── config.js <= 项目配置
│ ├── extend <= Vue 扩展相关
│ │ ├── filters.js <= 全局过滤器
│ │ ├── directive.js <= 全局指令
│ │ └── index.js <= 扩展入口
│ ├── layout <= 布局组件
│ │ ├── container.vue
│ │ ├── header.vue
│ │ ├── index.vue
│ │ ├── levelbar.vue
│ │ └── navbar.vue
│ ├── main.js <= Vue 入口
│ ├── mock <= Mock
│ ├── router <= 路由配置
│ │ ├── index.js
│ │ └── routes.js
│ ├── store <= Vuex
│ │ ├── actions
│ │ │ └── user.js
│ │ ├── index.js
│ │ ├── modules
│ │ │ ├── app.js
│ │ │ └── user.js
│ │ └── mutation-types.js
│ ├── style <= 样式文件
│ │ └── define.less
│ ├── utils <= utils
│ │ ├── axios.js <= axios
│ │ ├── const.js <= 常量
│ │ ├── index.js
│ │ └── storage.js <= storage
│ └── widgets <= 可复用组件
│ └── views <= 路由级别的组件
│ ├── Login.vue
│ ├── form
│ │ └── index.vue
│ ├── table
│ │ └── index.vue
│ └── test
│ └── query.vue
├── static <= 服务器静态资源
│ └── favicon.ico
└── test <= 测试文件夹
└── unit
├── index.js
├── karma.conf.js
└── specs
└── Hello.spec.js
5、使用说明
- 开发环境
npm run dev
- 生产环境
npm run build
6、效果图
- 总览
- 登录
- Table
- Form