当前位置:首页 » 《休闲阅读》 » 正文

前端编码规范

19 人参与  2024年10月11日 16:01  分类 : 《休闲阅读》  评论

点击全文阅读


1、开发规范

1.1、新增 view

在 @/views (opens new window)文件下 创建对应的文件夹,一般性一个路由对应一个文件, 该模块下的功能就建议在本文件夹下创建一个新文件夹,各个功能模块维护自己的utils或components组件。

1.2、新增 api

在 @/api (opens new window)文件夹下创建本模块对应的 api 服务。

1.3、新增组件

在全局的 @/components (opens new window)写一些全局的组件,如富文本,各种搜索组件,封装的分页组件等等能被公用的组件。 每个页面或者模块特定的业务组件则会写在当前 @/views (opens new window)下面。

如:@/views/system/user/components/xxx.vue。这样拆分大大减轻了维护成本。

1.4、新增样式

页面的样式和组件是一个道理,全局的 @/style (opens new window)放置一下全局公用的样式,每一个页面的样式就写在当前 views下面,请记住加上scoped 就只会作用在当前组件内了,避免造成全局的样式污染。

/* 编译前 */

.example {

  color: red;

}

/* 编译后 */

.example[_v-f3f3eg9] {

  color: red;

}

2、目录结构规范

├── build                      // 构建相关  

├── config                     // 配置相关

├── layout                     // 版面编排

│   ├── index                             // 版面主文件 加载版面各个模块组件

│   ├── component             // 版面模块组件

├── src                        // 源代码

│   ├── api                    // 所有请求

      └── test.js                  // 与views模块一致

│   ├── assets                 // 主题 字体等静态资源

│   ├── components             // 全局公用组件

│   ├── directive              // 全局指令

│   ├── filtres                // 全局 过滤器

│   ├── icons                  // 项目所有 svg icons

│   ├── lang                   // 国际化 language

│   ├── mock                   // 项目mock 模拟数据

│   ├── router                 // 路由

│   ├── store                  // 全局 store管理

│   ├── styles                 // 全局样式

│   ├── utils                  // 全局公用方法

│   ├── vendor                 // 公用vendor

│   ├── views                   // view页面

└── test                  //包名就是模块名,小写字母,多单词中划线

└── Index.vue                 //模块主页 文件名开头字母大写,多单词中划线

└── components       //模块业务组件目录

└── com-page.vue  //模块业务组件文件夹,开头字母小写,多单词中划线

└── comPage.vue    //模块业务组件,开头字母小写,多单词中划线

│   ├── App.vue                 // 入口页面

│   ├── main.js                  // 入口 加载组件 初始化等

│   └── permission.js            // 权限管理

├── static                       // 第三方不打包资源

│   └── Tinymce                 // 富文本

├── .env.development            //开发打包环境

├── .env.production              //生产打包环境

├── .env.staging                 //测试打包环境

├── .babelrc                   // babel-loader 配置

├── eslintrc.js                // eslint 配置项

├── .gitignore                 // git 忽略项

├── favicon.ico                // favicon图标

├── index.html                 // html模板

└── package.json               // package.json

3、注意:禁止一个模块不拆分,要分父子组件

错误方式的目录:

Index.vue包括了所有的功能(列表、新增、详情、编辑……)

缺点:难维护,冗余,文件行数太多,不轻便。

规范目录:

因按功能区分子组件。

这样拆分父子组件,每个文件,代码行数差不多都是一两百行。

注释:

函数使用多行注释

/** * * @param {*} query * @returns */

参数说明使用单行注释

//注释内容

页面标签使用标签注释

 <!—注释内容 -->

命名:

Index.vue和APP.vue固定命名,其他包名文件名全部小写字母开头,多单词包名使用“-” test-page, 多单词文件名驼峰testPage。参考目录结构规范。


点击全文阅读


本文链接:http://m.zhangshiyu.com/post/170638.html

<< 上一篇 下一篇 >>

  • 评论(0)
  • 赞助本站

◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。

最新文章

  • 祖母寿宴,侯府冒牌嫡女被打脸了(沈屿安秦秀婉)阅读 -
  • 《雕花锦年,昭都旧梦》(裴辞鹤昭都)完结版小说全文免费阅读_最新热门小说《雕花锦年,昭都旧梦》(裴辞鹤昭都) -
  • 郊区41号(许洛竹王云云)完整版免费阅读_最新全本小说郊区41号(许洛竹王云云) -
  • 负我情深几许(白诗茵陆司宴)完结版小说阅读_最热门小说排行榜负我情深几许白诗茵陆司宴 -
  • 九胞胎孕妇赖上我萱萱蓉蓉免费阅读全文_免费小说在线看九胞胎孕妇赖上我萱萱蓉蓉 -
  • 为保白月光,侯爷拿我抵了债(谢景安花田)小说完结版_完结版小说全文免费阅读为保白月光,侯爷拿我抵了债谢景安花田 -
  • 陆望程映川上官硕《我的阿爹是带攻略系统的替身》最新章节阅读_(我的阿爹是带攻略系统的替身)全章节免费在线阅读陆望程映川上官硕
  • 郑雅琴魏旭明免费阅读_郑雅琴魏旭明小说全文阅读笔趣阁
  • 头条热门小说《乔书意贺宴临(乔书意贺宴临)》乔书意贺宴临(全集完整小说大结局)全文阅读笔趣阁
  • 完结好看小说跨年夜,老婆初恋送儿子故意出车祸_沈月柔林瀚枫完结的小说免费阅读推荐
  • 热推《郑雅琴魏旭明》郑雅琴魏旭明~小说全文阅读~完本【已完结】笔趣阁
  • 《你的遗憾与我无关》宋怀川冯洛洛无弹窗小说免费阅读_免费小说大全《你的遗憾与我无关》宋怀川冯洛洛 -

    关于我们 | 我要投稿 | 免责申明

    Copyright © 2020-2022 ZhangShiYu.com Rights Reserved.豫ICP备2022013469号-1