Files
bea-mid/console-web/README.md
T
2019-08-26 07:25:43 +08:00

169 lines
7.2 KiB
Markdown

介绍
ecp-vue基于vue、element-ui构建开发,ecp-fast后台管理前端功能,提供一套更优的前端解决方案。
功能
- 登录/退出 (接口数据交互)
- 管理员列表 (接口数据交互)
- 角色管理 (接口数据交互)
- 菜单管理 (接口数据交互)
- SQL监控 (接口数据交互)
- 定时任务 (接口数据交互)
- 参数管理 (接口数据交互)
- 文件上传 (接口数据交互)
- 系统日志 (接口数据交互)
- 前后端分离,通过token进行数据交互,可独立部署
- 主题定制,通过scss变量统一一站式定制
- 动态菜单,通过菜单管理统一管理访问路由
- 数据切换,通过mock配置对接口数据/mock模拟数据进行切换
- 发布时,可动态配置CDN静态资源/切换新旧版本
- 更多,持续迭代中...
技术栈
你需要在本地安装 nodejs,提前了解和学习这些知识会对使用本项目有很大的帮助。
nodejs
ES6
vue-cli
vue
vue-router
vuex
axios
vue-cookie
element-ui
iconfont
目录结构
本项目已经通过vue-cli脚手架为你生产完整的开发框架(有根据业务需求做调整修改),下面是整个项目的目录结构。
├── dist // 构建打包生成部署文件
│ ├── 1805021549 // 静态资源(18年05月03日15时49分)
│ ├── config // 配置
│ ├── index.html // index.html入口
├── build // 构建相关
├── config // 构建配置相关
├── src // 源代码
│ ├── assets // 静态资源
│ ├── components // 全局公用组件
│ ├── element-ui // element-ui组件配置
│ ├── element-ui-theme // element-ui组件主题配置
│ ├── icons // 所有 svg icons
│ ├── mock // mock 模拟数据
│ ├── router // 路由
│ ├── store // 全局 store管理
│ ├── utils // 全局公用方法
│ ├── views // view
│ ├── App.vue // 入口组件
│ ├── main.js // 入口
├── static // 第三方不打包资源
│ ├── config // 全局变量配置
│ ├── plugins // 插件
├── .babelrc // babel-loader 配置
├── eslintrc.js // eslint 配置项
├── .gitignore // git 忽略项
├── favicon.ico // favicon图标
├── index.html // html模板
└── package.json // package.json
安装
安装过程中,可能会出现安装过慢、报错等情况,请尝试以下2种方式:
# 安装依赖
# 1
npm install -g cnpm --registry=https://registry.npm.taobao.org
# 2
cnpm install
# 启动服务
npm run dev
# 安装依赖
npm install
# 启动服务
npm run dev
启动完成后会自动打开浏览器访问 http://localhost:8001,你看到下面的页面就代表成功了。
布局 & 主题
整体布局包括:
头部导航条 main-navbar
左侧边栏 main-sidebar
中间内容展示 main-content
对应代码在 src/views/main.vue
ecp-fast中除去404、login页面,其它页面都是基于这个布局的。这里我将
无需嵌套上左右整体布局的路由称为“全局路由”放在globalRoutes常量中,
需嵌套上左右整体布局的路由称为“主入口路由”放在mainRoutes常量的children属性中。
对应代码在 src/router/index.js
// 全局路由(无需嵌套上左右整体布局)
const globalRoutes = [
{ path: '/404', component: _import('common/404'), name: '404', meta: { title: '404未找到' } },
{ path: '/login', component: _import('common/login'), name: 'login', meta: { title: '登录' } }
]
// 主入口路由(需嵌套上左右整体布局)
const mainRoutes = {
path: '/',
component: _import('main'),
name: 'main',
redirect: { name: 'home' },
meta: { title: '主入口整体布局' },
children: [
// 通过meta对象设置路由展示方式
// 1. isTab: 是否通过tab展示内容, true: 是, false: 否
// 2. iframeUrl: 是否通过iframe嵌套展示内容, '以http[s]://开头': 是, '': 否
{ path: '/home', component: _import('common/home'), name: 'home', meta: { title: '首页' } },
{ path: '/theme', component: _import('common/theme'), name: 'theme', meta: { title: '主题' } },
{
path: '/demo-01',
component: null, // 如需要通过iframe嵌套展示内容, 但不通过tab打开, 请自行创建组件使用iframe处理!
name: 'demo-01',
meta: {
title: '我是一个通过iframe嵌套展示内容, 并通过tab打开 demo',
isTab: true,
iframeUrl: 'http://fast.demo.ecp.io/'
}
}
],
beforeEnter (to, from, next) {
let token = Vue.cookie.get('token')
if (!token || !/\S/.test(token)) {
next({ name: 'login' })
}
next()
}
}
const router = new Router({
mode: 'hash',
scrollBehavior: () => ({ y: 0 }),
isAddDynamicMenuRoutes: false, // 是否已经添加动态(菜单)路由
routes: globalRoutes.concat(mainRoutes)
})
同时,主入口路由提供meta对象2个属性设置路由展示方式。
isTab: 是否通过tab展示内容
iframeUrl: 是否通过iframe嵌套展示内容
如需要通过iframe嵌套展示内容, 但不通过tab打开, 请自行创建组件使用iframe处理!
菜单路由
之前版本的菜单路由都需要手动在router/index.js文件中添加,这次新版本提供通过菜单管理统一管理访问路由,自动映射对应文件目录组件(配合代码生成器开发更愉快哦)。具体请点击移步动态菜单路由。
主题定制
提供12套颜色主题,进行element-ui和整站主题切换。具体切换方法如下:
修改/src/element-ui-theme/index.js文件中import './element-[#17b3a3]/index.css'[]中括号中的值,值可以在同文件中list属性中取即可。(注意:这里只是修改element-ui组件主题)
修改/src/assets/scss/_variables.scss文件中$--color-primary: [#17b3a3];[]中括号中的值,值与第一步值同步即可。(注意:这里只是修改站点主题,不包括element-ui组件主题)
主题定制具体实现方法是:
先通过element-ui官方提供的在线主题生成工具,进行切换主题色,再下载解压文件(保留fonts目录中文件和index.css即可)放置/src/element-ui-theme/目录中,使用同目录中的index.js进行统一配置管理。
再设置修改站点主题,使整站主题色统一一致。
之所以放弃之前直接在项目中通过scss一站式设置主题,是因为开发时编译太慢!同时按需求加载组件的css文件并没有比现在的index.css文件小多少kb(主要大小还是在js文件上)。考虑到大部分一个站配置一个主题色后,不会频繁修改!
网上查阅也有通过打包插件,对css添加父级id or class进行主题切换的,但是这样就相当于12套皮肤,需要将12个index.css进行合并打包发布,那文件岂不是太大了!这样的需求暂不考虑!