摘要:入口文件,影响全局,作用是引入全局使用的库公共的样式和方法设置路由等。项目里总会有一些复用的组件,例如弹出框发送手机验证码图片上传等,将它们作为通用组件,避免重复工作结构如下可以根据功能模块建立文件夹,放置本功能会用到的通用组件。
上一篇文章 https://segmentfault.com/a/11... 介绍了项目里文件夹的分类和作用,这次主要说明 src 文件夹里具体的文件分类和内容。
先上 src 文件夹的结构图:
文件及文件夹作用 App.vueApp.vue: 根组件,pages 里的组件会被插入此组件中,此组件再插入 index.html 文件里,形成单页面应用
根组件里面是这样子的:
其中,
基本上根组件没什么交互要做,底部的样式其实也可以放在全局的样式表里。
main.js: 入口 js 文件,影响全局,作用是引入全局使用的库、公共的样式和方法、设置路由等。
这个是负责配置影响全局的内容的文件,具体会有以下几种作用:
1、引入vue 以及相关的库
import Vue from "vue" //引入 vue import store from "./store" //引入 vuex import router from "./router"; //引入路由配置文件 import App from "./App" //引入根组件
2、 引入需要用到的第三方库(注意注册使用方式的区别)
// 引入element-ui import ElementUI from "element-ui"; import "element-ui/lib/theme-default/index.css"; Vue.use(ElementUI); // 引入字体图标样式,这里使用了阿里妈妈的 iconfont 字体库 import "@assets/iconfont/iconfont.css"; import "@assets/iconfont/iconfont.js"; // 引入copy 信息组件 import VueClipboards from "vue-clipboards"; Vue.use(VueClipboards); // 引入 axios 库 import axios from "axios" // 引入 d3 图形库 import * as d3 from "d3" // 引入国际化的库 import VueI18n from "vue-i18n"; Vue.use(VueI18n); //引入自定义的 json 格式中英文对照文件 import zh from "@assets/lang/zh-CN" import en from "@assets/lang/en-US" Vue.config.lang = "zh-cn" //设置默认中文 Vue.locale("zh-cn", zh) Vue.locale("en", en) // 引入时间转换模块 import moment from "moment"; moment.locale("zh-cn"); Vue.prototype.$moment = moment; //将 moment 模块转换成 Vue 的原型方法,在组件里可以直接使用 this.$moment(time) // 引入图表 import ECharts from "vue-echarts"; Vue.component("chart", ECharts); //注册 Echarts 成为全局组件,在组件里可以直接调用
3、 引入自定义的库
// 引入银行卡图标样式 import "@assets/icon-bank/iconfont.js"; // iconfont 上收集的银行卡图标 // 引入自定义的http模块 import { AjaxApi } from "@http/AjaxApi.js"; //http 文件夹里自定义的处理 api 接口的文件,导出一个包含所有与后台接口交流的函数的对象 Vue.prototype.$axios = AjaxApi; //加入 Vue 原型方法,组件里通过 this.$axios.xxx() 调用 // 引入公共方法 import commonMixins from "@mixins/common-mixins.js"; //mixins 文件夹里自定义的通用函数的集合 Vue.mixin(commonMixins); //全局注册混合
4、 引入自定义的公共样式,使得组件内可以用scoped定义自身的样式
// 引入公共样式以及修改过的 element 样式 import "@assets/css/common.less" import "@assets/css/theme.less"
5、 定义一些简短的不需要多带带引入的全局修改
// 在html5 history 模式下,在form表单的组件(input输入框等)里点击enter,会自动将表单数据以get的方式发送到后台,需要阻止默认事件 document.onkeydown = function(e) { var e = e || event; if(e.keyCode == 13) { e.preventDefault ? e.preventDefault() : (e.returnValue = false); } }; // 格式化金额,每三位加逗号,可选保留几位小数 Number.prototype.format = function(n, x) { var re = "d(?=(d{" + (x || 3) + "})+" + (n > 0 ? "." : "$") + ")"; return this.toFixed(Math.max(0, ~~n)).replace(new RegExp(re, "g"), "$&,"); };
6、 设置vue的全局配置,在启动应用前应用
Vue.config.productionTip = false; // 阻止 vue 在启动时生成生产提示
7、 指定渲染的文件
new Vue({ el: "#app", template: "" , router, store, components: { App } })
assets: 放置静态资源,包括公共的 css 文件、 js 文件、iconfont 字体文件、img 图片文件以及其他资源类文件。
结构如下:
css 文件夹里会有重置 css 样式的文件以及其他全局样式文件。
js 文件夹里放置了包含银行字典和全国省市的字典文件,在组件里引用之后遍历获取数据。
components: 放置通用模块组件。项目里总会有一些复用的组件,例如弹出框、发送手机验证码、图片上传等,将它们作为通用组件,避免重复工作;
结构如下:
可以根据功能模块建立文件夹,放置本功能会用到的通用组件。例如 login 文件夹里可以放置注册、登录、重置密码这几个功能会用的共同模块文件(账号、密码、图形验证码、短信验证码); account-center 文件夹放置修改账号相关的模块。
全局通用的公共模块可以不需要建立文件夹。
http: 放置与后台 api 相关的文件。这里面有 axios 库的实例配置文件、使用配置的 axios 实例接入 api 获取数据的函数的集合的文件;
结构如下:
config.js 是根据项目需求配置的 axios 实例文件,通过 axios.create([config]) 创建,可以配置诸如指定成功的状态码、序列化 params、设置 headers 、修改 token 、设置全局请求/响应拦截器、设置 baseURL 等。
AjaxApi.js 是通过导入 config.js 实例,传入 API 和其他参数,给每个 API 配置一个专属函数,再集合导出成对象的文件。例子如下:
mixins: 放置混合选项的文件。具体来说,相当于是公用函数的集合,在组件中引用时,可以作用于组件而不必书写重复的方法
个人认为,相当于是没有 和 的组件,例子如下:
pages: 放置主要页面的组件。例如登录页、用户信息页等。通常是这里的组件本身写入一些结构,再引入通用模块组件,形成完整的页面
这里面就是会被插入根组件的
都是单文件组件,没有特殊的结构,就不放图了。
router: 放置路由设置文件,指定路由对应的组件,设置路由钩子
例子如下:
import Vue from "vue"; import Router from "vue-router"; import Tab from "@pages/tab"; import { MessageBox } from "element-ui"; Vue.use(Router); const router = new Router({ //新建路由 routes: [ { path: "/", redirect: "/signin" //重定向路由 }, { path: "/signin", name: "signIn", //命名路由 component: (resolve) => { //按需加载 require(["@pages/sign-in"], resolve); } }, { path: "/signup", name: "signUp", component: (resolve) => { require(["@pages/sign-up"], resolve); } }, { path: "/tab", component: Tab, children: [ //嵌套路由 { path: "index", name: "index", component: (resolve) => { require(["@pages/index"], resolve); } } ] } ] }); router.beforeEach((to, from, next) => { //检测 token ,跳转登录页 if (checkPathRequiredAuth(to.path) && !sessionStorage.token) { sessionStorage.clear(); MessageBox({ title: "跳转提示", message: "用户认证已过期或不存在,确认后跳转到登录页", confirmButtonText: "确定", type: "warning", callback: action => { next({ path: "/signin" }); } }); } else { next(); } }); export default router;
store: 放置 vuex 需要的状态关联文件,设置公共的 state、mutations 等
1、如果项目结构不是很复杂,多是父子组件的通信,可以使用 props 传递数据,$emit 和 on 事件通信,store 文件夹里就只需创建 js 文件。
结构如下:
2、反之,主要使用 vuex 来传递数据和通信的话,需要按照模块来划分 modules 。store 文件夹里除了有index.js 和全局相关的 js 文件外,还有 modules 文件夹, 在 modules 文件夹里根据模块创建对应的 js 文件,导出,最后在 store 文件夹下一级的 index.js 里导入。
store 结构如下:
modules 结构如下:
sign-in.js:
index.js:
要注意的是,使用 modules 分割模块后,组件里获取 state 时要指明对应的 modules。
computed: { ...mapState({ data: state => state.signIn.data, //sign-in.js 里的 state user: state => state.user //index.js 里的 state }) }
文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。
转载请注明本文地址:https://www.ucloud.cn/yun/54504.html
摘要:入口文件,影响全局,作用是引入全局使用的库公共的样式和方法设置路由等。项目里总会有一些复用的组件,例如弹出框发送手机验证码图片上传等,将它们作为通用组件,避免重复工作结构如下可以根据功能模块建立文件夹,放置本功能会用到的通用组件。 上一篇文章 https://segmentfault.com/a/11... 介绍了项目里文件夹的分类和作用,这次主要说明 src 文件夹里具体的文件分类和...
摘要:文件夹结构文件夹里的文件夹设置是灵活的,可以根据自己的习惯进行,不必雷同。对文件夹配置的总结先到此为止,下一篇文章会是对文件夹里具体文件的配置和例子总结,有需要的可以去看看。 之前一段时间都在使用 vue 开发后台管理系统,在摸索的过程中对 vue 本身和模块化、规范化开发有了更深的认知,现在记录下来,希望对其他需要开发项目的人有帮助。 项目配置 首先,在确定好使用的框架和组件库后,先...
摘要:文件夹结构文件夹里的文件夹设置是灵活的,可以根据自己的习惯进行,不必雷同。对文件夹配置的总结先到此为止,下一篇文章会是对文件夹里具体文件的配置和例子总结,有需要的可以去看看。 之前一段时间都在使用 vue 开发后台管理系统,在摸索的过程中对 vue 本身和模块化、规范化开发有了更深的认知,现在记录下来,希望对其他需要开发项目的人有帮助。 项目配置 首先,在确定好使用的框架和组件库后,先...
阅读 3611·2021-10-12 10:11
阅读 993·2021-09-22 15:42
阅读 3442·2019-08-30 13:06
阅读 889·2019-08-29 17:05
阅读 1629·2019-08-29 12:21
阅读 2360·2019-08-29 11:31
阅读 1117·2019-08-23 18:37
阅读 1237·2019-08-23 14:58