最新要闻
- 商家广告鼓励偷男友钱喝奶茶被罚 热消息
- 环球通讯!苹果推出iPad版Final Cut Pro与Logic pro:1个月免费试用
- 国人秒懂内涵 如何辨别在美国的中国人:看车牌 环球今头条
- 吸、扫、拖三合一!米家免洗扫拖机器人2正式开售:1999元
- 深圳一男子举牌相亲 月薪6千要求女方1万2:被路人质疑后神回应 世界热门
- 史诗级尴尬!马斯克驾驶Cybertruck结果趴窝:在农田里陷车
- 2023年社保缴费基数怎么调整?什么时候重新申报?_环球新资讯
- 今日热门!台式电脑有线网络怎么连接_有线网络怎么连接
- 华为将发布双旗舰笔记本 MateBook新品颜值、性能将迎全面升级
- 世界热点!任天堂Switch卖不动了?销量下降22% 还要再苟一年
- 首发9999元 小米电视ES Pro 90寸开售:1000nits高亮度
- 今日观点!希思黎京东官方自营旗舰店开业 打造全新高端奢护体验
- 环球今日报丨支持双枪快充!比亚迪赵长江:腾势N7制动距离“遥遥领先”
- 焦点热讯:首个“三体”线下项目《三体 · 引力之外》有啥不一样?
- 焦点热议:杭州:西湖景区莲花绽放 花朵水面摇曳身姿
- 全球即时看!科大智能参设新能源发展公司 经营范围含电池销售
手机
iphone11大小尺寸是多少?苹果iPhone11和iPhone13的区别是什么?
警方通报辅警执法直播中被撞飞:犯罪嫌疑人已投案
- iphone11大小尺寸是多少?苹果iPhone11和iPhone13的区别是什么?
- 警方通报辅警执法直播中被撞飞:犯罪嫌疑人已投案
- 男子被关545天申国赔:获赔18万多 驳回精神抚慰金
- 3天内26名本土感染者,辽宁确诊人数已超安徽
- 广西柳州一男子因纠纷杀害三人后自首
- 洱海坠机4名机组人员被批准为烈士 数千干部群众悼念
家电
Vue 前端开发团队风格指南(史上最全)
Vue官网的风格指南按照优先级(依次为必要、强烈推荐、推荐、谨慎使用)分类,本文根据项目实际情况整理了一份适用于团队开发的vue风格指南,供大家参考。
一、命名规范
常用的命名规范:
- camelCase(小驼峰式命名法 —— 首字母小写)
- PascalCase(大驼峰式命名法 —— 首字母大写)
- kebab-case(短横线连接式)
- Snake (下划线连接式)
1.1 项目文件命名
1.1.1 项目名
全部采用小写方式, 以短横线分隔。例:my-project-name。
1.1.2 目录名
参照项目命名规则,有复数结构时,要采用复数命名法。例:docs、assets、components、directives、mixins、utils、views。
my-project-name/|- BuildScript // 流水线部署文件目录|- docs // 项目的细化文档目录(可选)|- nginx // 部署在容器上前端项目 nginx 代理文件目录|- node_modules // 下载的依赖包|- public // 静态页面目录 |- index.html // 项目入口|- src // 源码目录 |- api // http 请求目录 |- assets // 静态资源目录,这里的资源会被wabpack构建 |- icon // icon 存放目录 |- img // 图片存放目录 |- js // 公共 js 文件目录 |- scss // 公共样式 scss 存放目录 |- frame.scss // 入口文件 |- global.scss // 公共样式 |- reset.scss // 重置样式 |- components // 组件 |- plugins // 插件 |- router // 路由 |- routes // 详细的路由拆分目录(可选) |- index.js |- store // 全局状态管理 |- utils // 工具存放目录 |- request.js // 公共请求工具 |- views // 页面存放目录 |- App.vue // 根组件 |- main.js // 入口文件 |- tests // 测试用例 |- .browserslistrc// 浏览器兼容配置文件 |- .editorconfig // 编辑器配置文件 |- .eslintignore // eslint 忽略规则 |- .eslintrc.js // eslint 规则 |- .gitignore // git 忽略规则 |- babel.config.js // babel 规则 |- Dockerfile // Docker 部署文件 |- jest.config.js |- package-lock.json |- package.json // 依赖 |- README.md // 项目 README |- vue.config.js // webpack 配置
1.1.3 图像文件名
全部采用小写方式, 优先选择单个单词命名,多个单词命名以下划线分隔。
banner_sina.gifmenu_aboutus.gifmenutitle_news.giflogo_police.giflogo_national.gifpic_people.jpgpic_TV.jpg
1.1.4 HTML 文件名
全部采用小写方式, 优先选择单个单词命名,多个单词命名以下划线分隔。
|- error_report.html|- success_report.html
1.1.5 CSS 文件名
全部采用小写方式, 优先选择单个单词命名,多个单词命名以短横线分隔。
|- normalize.less|- base.less|- date-picker.scss|- input-number.scss
1.1.6 JavaScript 文件名
全部采用小写方式, 优先选择单个单词命名,多个单词命名以短横线分隔。
|- index.js|- plugin.js|- util.js|- date-util.js|- account-model.js|- collapse-transition.js
上述规则可以快速记忆为“静态文件下划线,编译文件短横线”。
1.2 Vue 组件命名
1.2.1 单文件组件名
文件扩展名为 .vue 的 single-file components (单文件组件)。单文件组件名应该始终是单词大写开头 (PascalCase)。
components/|- MyComponent.vue
1.2.2 单例组件名
只拥有单个活跃实例的组件应该以 The 前缀命名,以示其唯一性。这不意味着组件只可用于一个单页面,而是每个页面只使用一次。这些组件永远不接受任何 prop,因为它们是为你的应用定制的。如果你发现有必要添加 prop,那就表明这实际上是一个可复用的组件,只是目前在每个页面里只使用一次。比如,头部和侧边栏组件几乎在每个页面都会使用,不接受 prop,该组件是专门为该应用所定制的。
components/|- TheHeading.vue|- TheSidebar.vue
1.2.3 基础组件名
基础组件:不包含业务,独立、具体功能的基础组件,比如日期选择器、模态框等。这类组件作为项目的基础控件,会被大量使用,因此组件的 API 进行过高强度的抽象,可以通过不同配置实现不同的功能。
应用特定样式和约定的基础组件(也就是展示类的、无逻辑的或无状态、不掺杂业务逻辑的组件) 应该全部以一个特定的前缀开头 —— Base。基础组件在一个页面内可使用多次,在不同页面内也可复用,是高可复用组件。
components/|- BaseButton.vue|- BaseTable.vue|- BaseIcon.vue
1.2.4 业务组件
业务组件:它不像基础组件只包含某个功能,而是在业务中被多个页面复用的(具有可复用性),它与基础组件的区别是,业务组件只在当前项目中会用到,不具有通用性,而且会包含一些业务,比如数据请求;而基础组件不含业务,在任何项目中都可以使用,功能单一,比如一个具有数据校验功能的输入框。
掺杂了复杂业务的组件(拥有自身 data、prop 的相关处理)即业务组件应该以 Custom 前缀命名。业务组件在一个页面内比如:某个页面内有一个卡片列表,而样式和逻辑跟业务紧密相关的卡片就是业务组件。
components/|- CustomCard.vue
1.2.5 紧密耦合的组件名
和父组件紧密耦合的子组件应该以父组件名作为前缀命名。 因为编辑器通常会按字母顺序组织文件,所以这样做可以把相关联的文件排在一起。
components/|- TodoList.vue|- TodoListItem.vue|- TodoListItemButton.vue
1.2.6 组件名中单词顺序
组件名应该以高级别的 (通常是一般化描述的) 单词开头,以描述性的修饰词结尾。 因为编辑器通常会按字母顺序组织文件,所以现在组件之间的重要关系一目了然。如下组件主要是用于搜索和设置功能。
components/|- SearchButtonClear.vue|- SearchButtonRun.vue|- SearchInputQuery.vue|- SearchInputExcludeGlob.vue|- SettingsCheckboxTerms.vue|- SettingsCheckboxLaunchOnStartup.vue
还有另一种多级目录的方式,把所有的搜索组件放到“search”目录,把所有的设置组件放到“settings”目录。我们只推荐在非常大型 (如有 100+ 个组件) 的应用下才考虑这么做,因为在多级目录间找来找去,要比在单个 components 目录下滚动查找要花费更多的精力。
1.2.7 完整单词的组件名
组件名应该倾向于完整单词而不是缩写。 编辑器中的自动补全已经让书写长命名的代价非常之低了,而其带来的明确性却是非常宝贵的。不常用的缩写尤其应该避免。
components/|- StudentDashboardSettings.vue|- UserProfileOptions.vue
1.3 代码参数命名
1.3.1 name
组件名应该始终是多个单词,应该始终是 PascalCase 的。 根组件 App 以及
export default { name: "ToDoList", // ...}
1.3.2 prop
在声明 prop 的时候,其命名应该始终使用 camelCase,而在模板和 JSX 中应该始终使用 kebab-case。我们单纯的遵循每个语言的约定,在 JavaScript 中更自然的是 camelCase。而在 HTML 中则是 kebab-case。
export default { name: "MyComponent", // ... props: { greetingText: { type: String, required: true, validator: function (value) { return ["syncing", "synced",].indexOf(value) !== -1 } } }}
1.3.3 router
Vue Router Path 命名采用 kebab-case 格式。 用 Snake(如:/user_info)或 camelCase(如:/userInfo)的单词会被当成一个单词,搜索引擎无法区分语义。
// bad{ path: "/user_info", // user_info 当成一个单词 name: "UserInfo", component: UserInfo, meta: { title: " - 用户", desc: "" }},// good{ path: "/user-info", // 能解析成 user info name: "UserInfo", component: UserInfo, meta: { title: " - 用户", desc: "" }},
1.3.4 模板中组件
对于绝大多数项目来说,在单文件组件和字符串模板中组件名应该总是 PascalCase 的,但是在 DOM 模板中总是 kebab-case 的。
1.3.5 自闭合组件
在单文件组件、字符串模板和 JSX 中没有内容的组件应该是自闭合的——但在 DOM 模板里永远不要这样做。
1.3.6 变量
- 命名方法:camelCase
- 命名规范:类型 + 对象描述或属性的方式
// badvar getTitle = "LoginTable"// goodlet tableTitle = "LoginTable"let mySchool = "我的学校"
1.3.7 常量
- 命名方法:全部大写下划线分割
- 命名规范:使用大写字母和下划线来组合命名,下划线用以分割单词
const MAX_COUNT = 10const URL = "http://test.host.com"
1.3.8 方法
- 命名方法:camelCase
- 命名规范:统一使用动词或者动词 + 名词形式
// 1、普通情况下,使用动词 + 名词形式// badgo、nextPage、show、open、login// goodjumpPage、openCarInfoDialog// 2、请求数据方法,以 data 结尾// badtakeData、confirmData、getList、postForm// goodgetListData、postFormData// 3、单个动词的情况init、refresh
动词 | 含义 | 返回值 |
---|---|---|
can | 判断是否可执行某个动作 (权 ) | 函数返回一个布尔值。true:可执行;false:不可执行; |
has | 判断是否含有某个值 | 函数返回一个布尔值。true:含有此值;false:不含有此值; |
is | 判断是否为某个值 | 函数返回一个布尔值。true:为某个值;false:不为某个值; |
get | 获取某个值 | 函数返回一个非布尔值 |
set | 设置某个值 | 无返回值、返回是否设置成功或者返回链式对象 |
1.3.9 自定义事件
自定义事件应始终使用 kebab-case 的事件名。不同于组件和 prop,事件名不存在任何自动化的大小写转换。而是触发的事件名需要完全匹配监听这个事件所用的名称。
this.$emit("my-event")
不同于组件和 prop,事件名不会被用作一个 JavaScript 变量名或 property 名,所以就没有理由使用 camelCase 或 PascalCase 了。并且 v-on 事件监听器在 DOM 模板中会被自动转换为全小写 (因为 HTML 是大小写不敏感的),所以 v-on:myEvent 将会变成 v-on:myevent——导致 myEvent 不可能被监听到。
- 原生事件参考列表由原生事件可发现其使用方式如下:
而为了区分原生事件和自定义事件在 Vue 中的使用,建议除了多单词事件名使用 kebab-case 的情况下,命名还需遵守为 on + 动词 的形式,如下:
// 子组件export default { methods: { handleTriggerItem () { this.$emit("on-clear") } }}
1.3.10 事件方法
- 命名方法:camelCase
- 命名规范:handle + 名称(可选)+ 动词
<script>export default { methods: { handleItemClick () { //... }, handleItemHover () { //... } }}</script>
二、代码规范
2.1 Vue
2.1.1 代码结构
<script>import DemoComponent from "../components/DemoComponent"export default { name: "MyComponent", components: { DemoComponent }, mixins: [], props: {}, data () { return {} }, computed: {}, watch: {} created () {}, mounted () {}, destroyed () {}, methods: {},}</script>
2.1.2 data
组件的 data 必须是一个函数。
// In a .vue fileexport default { data () { return { foo: "bar" } }}
2.1.3 prop
Prop 定义应该尽量详细。
export default { props: { status: { type: String, required: true, validator: function (value) { return [ "syncing", "synced", "version-conflict", "error" ].indexOf(value) !== -1 } } }}
2.1.4 computed
应该把复杂计算属性分割为尽可能多的更简单的属性。 小的、专注的计算属性减少了信息使用时的假设性限制,所以需求变更时也用不着那么多重构了。
// badcomputed: { price: function () { var basePrice = this.manufactureCost / (1 - this.profitMargin) return ( basePrice - basePrice * (this.discountPercent || 0) ) } }// goodcomputed: { basePrice: function () { return this.manufactureCost / (1 - this.profitMargin) }, discount: function () { return this.basePrice * (this.discountPercent || 0) }, finalPrice: function () { return this.basePrice - this.discount }}
2.1.5 为 v-for 设置键值
在组件上必须用 key 搭配 v-for,以便维护内部组件及其子树的状态。
- {{ todo.text }}
2.1.6 v-if 和 v-for 互斥
永远不要把 v-if 和 v-for 同时用在同一个元素上。
- {{ user.name }}
一般我们在两种常见的情况下会倾向于这样做:
- 为了过滤一个列表中的项目 (比如 v-for="user in users" v-if="user.isActive")。在这种情形下,请将 users 替换为一个计算属性 (比如 activeUsers),让其返回过滤后的列表。
computed: { activeUsers: function () { return this.users.filter((user) => { return user.isActive }) }}
- {{ user.name }}
- 为了避免渲染本应该被隐藏的列表 (比如 v-for="user in users" v-if="shouldShowUsers")。这种情形下,请将 v-if 移动至容器元素上 (比如 ul, ol)。
- {{ user.name }}
- {{ user.name }}
2.1.7 多个 attribute 的元素
多个 attribute 的元素应该分多行撰写,每个 attribute 一行。
2.1.8 模板中简单的表达式
组件模板应该只包含简单的表达式,复杂的表达式则应该重构为计算属性或方法。复杂表达式会让你的模板变得不那么声明式。我们应该尽量描述应该出现的是什么,而非如何计算那个值。而且计算属性和方法使得代码可以重用。
// bad{{ fullName.split(" ").map((word) => { return word[0].toUpperCase() + word.slice(1) }).join(" ")}}
更好的做法:
{{ normalizedFullName }}
// 复杂表达式已经移入一个计算属性computed: { normalizedFullName: function () { return this.fullName.split(" ").map(function (word) { return word[0].toUpperCase() + word.slice(1) }).join(" ") }}
2.1.9 带引号的 attribute 值
非空 HTML 特性值应该始终带双引号。
2.1.10 指令缩写
- 用 : 表示 v-bind:
- 用 @ 表示 v-on:
- 用 # 表示 v-slot:
Here might be a page title
Here"s some contact info
2.2 HTML
2.2.1 文件模板
HTML5 文件模板:
HTML5标准模版
移动端:
移动端HTML模版
PC 端:
PC端HTML模版
2.2.2 元素及标签闭合
HTML 元素共有以下5种:
- 空元素:area、base、br、col、command、embed、hr、img、input、keygen、link、meta、param、source、track、wbr
- 原始文本元素:script、style
- RCDATA 元素:textarea、title
- 外来元素:来自 MathML 命名空间和 SVG 命名空间的元素
- 常规元素:其他 HTML 允许的元素都称为常规元素为了能让浏览器更好的解析代码以及能让代码具有更好的可读性,有如下约定:
- 所有具有开始标签和结束标签的元素都要写上起止标签,某些允许省略开始标签或和束标签的元素亦都要写上。
- 空元素标签都不加 “/” 字符。
我是h1标题
我是一段文字,我有始有终,浏览器能正确解析
我是h1标题
我是一段文字,我有始无终,浏览器亦能正确解析
2.2.3 代码嵌套
元素嵌套规范,每个块状元素独立一行,内联元素可选。
段落元素与标题元素只能嵌套内联元素。
2.3 CSS
2.3.1 样式文件
样式文件必须写上 @charset 规则,并且一定要在样式文件的第一行首个字符位置开始写,编码名用 “UTF-8”。
- 推荐:
@charset "UTF-8";.jdc {}
- 不推荐:
/* @charset规则不在文件首行首个字符开始 */@charset "UTF-8";.jdc {}/* @charset规则没有用小写 */@CHARSET "UTF-8";.jdc {}/* 无@charset规则 */.jdc {}
2.3.2 代码格式化
样式书写一般有两种:一种是紧凑格式 (Compact),一种是展开格式(Expanded)。
- 推荐:展开格式(Expanded)
.jdc { display: block; width: 50px;}
- 不推荐:紧凑格式 (Compact)
.jdc { display: block; width: 50px;}
2.3.3 代码大小写
样式选择器,属性名,属性值关键字全部使用小写字母书写,属性字符串允许使用大小写。
- 推荐:
.jdc { display: block;}
- 不推荐:
.JDC { DISPLAY: BLOCK;}
2.3.4 代码易读性
- 左括号与类名之间一个空格,冒号与属性值之间一个空格。
- 推荐:
.jdc { width: 100%;}
- 不推荐:
.jdc{ width:100%;}
- 逗号分隔的取值,逗号之后一个空格。
- 推荐:
.jdc { box-shadow: 1px 1px 1px #333, 2px 2px 2px #ccc;}
- 不推荐:
.jdc { box-shadow: 1px 1px 1px #333,2px 2px 2px #ccc;}
- 为单个 CSS 选择器或新声明开启新行。
- 推荐:
.jdc, .jdc_logo, .jdc_hd { color: #ff0;}.nav{ color: #fff;}
- 不推荐:
.jdc, .jdc_logo, .jdc_hd { color: #ff0;}.nav{ color: #fff;}
- 颜色值 rgb() rgba() hsl() hsla() rect() 中不需有空格,且取值不要带有不必要的 0。
- 推荐:
.jdc { color: rgba(255,255,255,.5);}
- 不推荐:
.jdc { color: rgba( 255, 255, 255, 0.5 );}
- 属性值十六进制数值能用简写的尽量用简写。
- 推荐:
.jdc { color: #fff;}
- 不推荐:
.jdc { color: #ffffff;}
- 不要为 0 指明单位。
- 推荐:
.jdc { margin: 0 10px;}
- 不推荐:
.jdc { margin: 0px 10px;}
2.3.5 属性值引号
CSS 属性值需要用到引号时,统一使用单引号。
- 推荐:.jdc {font-family: "Hiragino Sans GB";}
- 不推荐:
.jdc { font-family: "Hiragino Sans GB";}
2.3.6 属性书写建议
建议遵循以下顺序:
- 布局定位属性:display / position / float / clear / visibility / overflow
- 自身属性:width / height / margin / padding / border / background
- 文本属性:color / font / text-decoration / text-align / vertical-align / white- space / break-word
- 其他属性(CSS3):content / cursor / border-radius / box-shadow / text-shadow / background: linear-gradient …
.jdc { display: block; position: relative; float: left; width: 100px; height: 100px; margin: 0 10px; padding: 20px 0; font-family: Arial, "Helvetica Neue", Helvetica, sans-serif; color: #333; background: rgba(0,0,0,.5); -webkit-border-radius: 10px; -moz-border-radius: 10px; -o-border-radius: 10px; -ms-border-radius: 10px; border-radius: 10px;}
3.3.7 CSS3 浏览器私有前缀
CSS3 浏览器私有前缀在前,标准前缀在后。
.jdc { -webkit-border-radius: 10px; -moz-border-radius: 10px; -o-border-radius: 10px; -ms-border-radius: 10px; border-radius: 10px;}
2.4 JavaScript
2.4.1 单行代码块
在单行代码块中使用空格。
- 不推荐:
function foo () {return true}if (foo) {bar = 0}
- 推荐:
function foo () { return true }if (foo) { bar = 0 }
2.4.2 大括号风格
在编程过程中,大括号风格与缩进风格紧密联系,用来描述大括号相对代码块位置的方法有很多。在 JavaScript 中,主要有三种风格,如下:
- 【推荐】One True Brace Style
if (foo) { bar()} else { baz()}
- Stroustrup
if (foo) { bar()}else { baz()}
- Allman
if (foo){ bar()}else{ baz()}
2.4.3 代码中的空格
- 逗号前后的空格可以提高代码的可读性,团队约定在逗号后面使用空格,逗号前面不加空格。
- 推荐:
var foo = 1, bar = 2
- 不推荐:
var foo = 1,bar = 2var foo = 1 , bar = 2var foo = 1 ,bar = 2
- 对象字面量的键和值之间不能存在空格,且要求对象字面量的冒号和值之间存在一个空格。
- 推荐:
var obj = { "foo": "haha" }
- 不推荐:
var obj = { "foo" : "haha" }
- 代码块前要添加空格。
- 推荐:
if (a) { b()}function a () {}
- 不推荐:
if (a){ b()}function a (){}
- 函数声明括号前要加空格。
- 推荐:
function func (x) { // ...}
- 不推荐:
function func(x) { // ...}
- 在函数调用时,禁止使用空格。
- 推荐:
fn()
- 不推荐:
fn ()fn()
- 在操作符前后都需要添加空格。
- 推荐:
var sum = 1 + 2
- 不推荐:
var sum = 1+2
三、注释规范
注释的目的:
- 提高代码的可读性,从而提高代码的可维护性注释的原则:
- 如无必要,勿增注释 ( As short as possible )
- 如有必要,尽量详尽 ( As long as necessary )
3.1 HTML 文件注释
3.1.1 单行注释
一般用于简单的描述,如某些状态描述、属性描述等。注释内容前后各一个空格字符,注释位于要注释代码的上面,单独占一行。
- 推荐:
...
- 不推荐
... ...
3.1.2 模块注释
一般用于描述模块的名称以及模块开始与结束的位置。注释内容前后各一个空格字符,模块与模块之间相隔一行。
- 推荐:
... ...
- 不推荐
... ...
3.1.3 嵌套模块注释
当模块注释内再出现模块注释的时候,为了突出主要模块,嵌套模块不再使用。
而改用
注释写在模块结尾标签底部,单独一行。
... ...
3.2 CSS 文件注释
3.2.1 单行注释
注释内容第一个字符和最后一个字符都是一个空格字符,单独占一行,行与行之间相隔一行。
- 推荐:
/* Comment Text */ .jdc {} /* Comment Text */ .jdc {}
- 不推荐:
/*Comment Text*/.jdc { display: block;}.jdc { display: block;/*Comment Text*/}
3.2.2 模块注释
注释内容第一个字符和最后一个字符都是一个空格字符,/* 与 模块信息描述占一行,多个横线分隔符 - 与 */ 占一行,行与行之间相隔两行。
- 推荐:
/* Module A---------------------------------------------------------------- */.mod_a {}/* Module B---------------------------------------------------------------- */.mod_b {}
- 不推荐:
/* Module A ---------------------------------------------------- */.mod_a {}/* Module B ---------------------------------------------------- */.mod_b {}
3.2.3 文件注释
在样式文件编码声明 @charset 语句下面注明页面名称、作者、创建日期等信息。
@charset "UTF-8";/** * @desc File Info * @author Author Name * @date 2015-10-10 */
3.3 JavaScript 文件注释
3.3.1 单行注释
单行注释使用 //,注释应单独一行写在被注释对象的上方,不要追加在某条语句的后面。
- 推荐:
// is current tabconst active = true
- 不推荐:
const active = true // is current tab
注释行的上方需要有一个空行(除非注释行上方是一个块的顶部),以增加可读性。
- 推荐:
function getType () { console.log("fetching type...") // set the default type to "no type" const type = this.type || "no type" return type}
// 注释行上面是一个块的顶部时不需要空行function getType () { // set the default type to "no type" const type = this.type || "no type" return type}
- 不推荐:
function getType () { console.log("fetching type...") // set the default type to "no type" const type = this.type || "no type" return type}
3.3.2 多行注释
多行注释使用 /** ... */,而不是多行的 //。
- 推荐:
/** * make() returns a new element * based on the passed-in tag name */function make (tag) { // ... return element}
- 不推荐:
// make() returns a new element// based on the passed in tag namefunction make (tag) { // ... return element}
3.3.3 注释空格
注释内容和注释符之间需要有一个空格,以增加可读性。eslint: spaced-comment。
- 推荐:
// is current tabconst active = true/** * make() returns a new element * based on the passed-in tag name */function make(tag) { // ... return element}
- 不推荐:
//is current tabconst active = true/** *make() returns a new element *based on the passed-in tag name */function make(tag) { // ... return element}
3.3.4 特殊标记
有时我们发现某个可能的 bug,但因为一些原因还没法修复;或者某个地方还有一些待完成的功能,这时我们需要使用相应的特殊标记注释来告知未来的自己或合作者。常用的特殊标记有两种:
- // FIXME : 说明问题是什么
- // TODO : 说明还要做什么或者问题的解决方案
class Calculator extends Abacus { constructor () { super () // FIXME: shouldn’t use a global here total = 0 // TODO: total should be configurable by an options param this.total = 0 }}
3.3.5 文档类注释
文档类注释,如函数、类、文件、事件等;都使用 jsdoc 规范。
/** * Book类,代表一个书本. * @constructor * @param {string} title - 书本的标题. * @param {string} author - 书本的作者. */function Book (title, author) { this.title = title this.author = author}Book.prototype = { /** * 获取书本的标题 * @returns {string|*} */ getTitle: function () { return this.title }, /** * 设置书本的页数 * @param pageNum {number} 页数 */ setPageNum: function (pageNum) { this.pageNum=pageNum }}
3.3.6 注释工具
ESLint 是当下最流行的 JS 代码检查工具,ESLint 中有一些注释相关的规则,用户可选择开启:
- valid-jsdoc
- require-jsdoc
- no-warning-comments
- capitalized-comments
- line-comment-position
- lines-around-comment
- multiline-comment-style
- no-inline-comments
- spaced-comment
四、其它
- 缩进换行请使用两个空格。
- 大型团队多人协作项目推荐 JavaScript 代码末尾加分号。
- 小型个人创新练手项目可尝试使用 JavaScript 代码末尾不加分号的风格,更加清爽简练。
更多技术文章请往:http://www.guosisoft.com/article,大家一起共同交流和进步呀
关键词:
-
Linux ARM架构_安装JDK8-银河麒麟V10 Kylin Linux-焦点速递
原文链接:https: blog csdn net a767815662 article details 1245799391、官网下载aarch64架构jdk包2、li
来源: Vue 前端开发团队风格指南(史上最全)
Linux ARM架构_安装JDK8-银河麒麟V10 Kylin Linux-焦点速递
PSP上哪个火影的游戏最好玩?PSP经典游戏有哪些?
商家广告鼓励偷男友钱喝奶茶被罚 热消息
环球通讯!苹果推出iPad版Final Cut Pro与Logic pro:1个月免费试用
国人秒懂内涵 如何辨别在美国的中国人:看车牌 环球今头条
吸、扫、拖三合一!米家免洗扫拖机器人2正式开售:1999元
深圳一男子举牌相亲 月薪6千要求女方1万2:被路人质疑后神回应 世界热门
史诗级尴尬!马斯克驾驶Cybertruck结果趴窝:在农田里陷车
2023年社保缴费基数怎么调整?什么时候重新申报?_环球新资讯
环球新资讯:2分钟快速上手流水线的创建与运行
当前视讯!接单日记(三)文本处理之词云生成
今日热门!台式电脑有线网络怎么连接_有线网络怎么连接
华为将发布双旗舰笔记本 MateBook新品颜值、性能将迎全面升级
世界热点!任天堂Switch卖不动了?销量下降22% 还要再苟一年
首发9999元 小米电视ES Pro 90寸开售:1000nits高亮度
今日观点!希思黎京东官方自营旗舰店开业 打造全新高端奢护体验
环球今日报丨支持双枪快充!比亚迪赵长江:腾势N7制动距离“遥遥领先”
焦点热讯:首个“三体”线下项目《三体 · 引力之外》有啥不一样?
焦点热议:杭州:西湖景区莲花绽放 花朵水面摇曳身姿
全球即时看!科大智能参设新能源发展公司 经营范围含电池销售
今日快讯:3D建模师用AI把自己变美少女 大叔成偶像
理想老板怒斥媒体人:隔壁吉利的高管羡慕坏了
多家挖呀挖公司注册成立:涉及零售业、服务业-每日资讯
环球滚动:50万级老板专属座驾 新一代国产奔驰E级亮相:车身、轴距全加长
249元 小米智能摄像机3开售:3K超清画质 支持双向语音通话
听说你还回忆我小说 听说你还回忆我
高效c语言1快速入门|焦点热闻
使用IDEA远程Debug调试(详细)|今日快讯
Echarts引入——绘制一个简单的图表|环球信息
世界热点评!豫能控股拟30亿布局新能源转型待考 煤炭涨价助推成本上升两年累亏逾40亿
头条:国内“老头乐一哥”!雷丁汽车申请破产:曾被经销商举报为诈骗
七彩虹发布新款隐星游戏本:RTX 4060首发5999元
【世界聚看点】百万级越野车!仰望U8申报信息公布:搭比亚迪最强2.0T发动机
全球聚焦:蔚来车主 绑架李斌?
比亚迪海豚最强对手来了!五菱宝骏云朵亮相:10万级大五座_热消息
今日视点:再动员再部署!龙湾全面推进这项工作!
VM虚拟机去虚拟化 玩游戏多开 过检测 tp vmp cf dnf
中信证券:下半年全球新能源汽车及储能有望延续高增长
AMD RDNA3甜点卡RX 7600到货了:价格不友好
热资讯!杭州女生地铁上隔空收到陌生信息 果粉热议常被此折磨:苹果回应给解决办法
你遇到没?苹果iPhone天气又崩了:用户吐槽不如安卓
爱犬跳车乱蹿 摩托车骑手高速路上抓狗:险象环生-视点
扫码才能点餐缴费?市消协劝喻商家:不得强制消费者关注公众号或用小程序_当前视讯
聚焦重点靶向发力 万亿税费红利加快释放 全球热文
环球观察:韩国最新民调:尹锡悦就职一周年,施政差评率60%
iOS 16.5 RC准正式版推送!iOS 16系统更新要绝唱了 每日速讯
华为Mate X3国际版亮相:系统是EMUI 13.1
学系统集成项目管理工程师(中项)系列19b_成本管理(下)_世界看点
新坎特伯利传说_关于新坎特伯利传说简介
捡漏上瘾!印度仍在抢购廉价俄油 全球油价将大涨价 环球关注
网友第一次装机遇到这些问题:好像当年的自己_每日热议
即时:滴滴一面:BigKey问题很致命,如何排查和处理?
“下沉式旅游”的信号,小城市接收到了吗? 焦点简讯
天天短讯!微信5个超实用隐藏功能 很多人都不会用!看完涨知识
最强高端旗舰手表 华为WATCH 4系列全球首发亮相:腕上健康管家
全球焦点!开发者称《王国之泪》主题是"手":让林克更具辨识度
代工厂搞出“雷军电动车”的老头乐一哥 死了:因为想好好做车
4.1Pb/s!中国创造光纤传输新纪录 世界观点
“基金公司”APP上买理财,血本无归?法院判了
欧冠半决赛晋级率:本菲卡居首,米兰、利物浦、尤文列前四|全球看点
指标到校和统招的区别_指标到校与统招的区别
谁抢到了五月天门票?网友吐槽:黄牛加价可随便买 最新资讯
国产SSD继续卷:梵想S690 2TB到手价499元 4800MB/s
拍照机皇再次易主 华为P60 Pro拿下DXO手机影像全球第一:156分-全球看点
美国布法罗枪击案一周年之际专家发声:消除种族歧视收效甚微 问题由来已久
操作系统作业常见算法-个人复习用
Spring AOP官方文档学习笔记(四)之Spring AOP的其他知识点 快播
当前视讯!打破苹果垄断,华为、小米携手共进,夺回国产手机高端份额!
环球观焦点:在华停产新车 日系汽车巨头三菱退出中国?回应来了:没有计划
抄袭风波后 吉利、长安宣布战略合作:共推中国汽车产业升级_天天快报
让平板再次伟大 苹果生产力软件FinalCut Pro、Logic Pro支持iPad电脑
看热讯:C#设计模式09——组合模式的写法
R数据分析:生存数据预测模型的建立和评价(二)timeROC与决策曲线
汽车大灯清洗功能有用吗_汽车大灯清洗功能什么作用
诺贝尔经济学奖得主称美国可能债务违约
每日关注!韩系车中国市场遇冷!悦达起亚被曝管理岗轮休 一休就一年
理想L8成中保研碰撞史最佳SUV:“堡垒车身”功不可没_世界速递
TCL发布Mini LED电视Q10H:疯狂3000尼特亮度 98寸售价29999元
贵南县气象台发布暴雪蓝色预警信号【2023-05-09】|天天观察
Linux 处理CPU和内存参数的方式总结
越南央行可能会在银行挤兑现象中尽早采取行动。
播报:机械盘真的没人买了 HDD出货量再次暴跌:价格神奇上涨
SSD价格见底了!再下降后果危险:闪存厂商要破产 世界热讯
环球观天下!海洋气息渐浓 新款比亚迪宋PLUS DM-i申报: 装上海豹同款大灯
真的在做了!任天堂官方回应新一代Switch消息:细节无可奉告_全球新要闻
首发4999元 KTC新款电竞显示器上架:2K OLED高刷屏 四轴调色|每日热讯
【开源游戏】Legends-Of-Heroes 基于ET 7.2的双端C#(.net7 + Unity3d)多人在线英雄联盟风格的球球大作战游戏。|全球简讯
世界快看:数据结构与算法大作业:走迷宫程序(C语言,DFS)(代码以及思路)
全球今日讯!祥鑫科技:5月8日接受机构调研,信达证券、华安基金等多家机构参与
天天日报丨谷爱凌:90%网络传言都是假的 不会为负面评价难过
午睡过久会长胖吗?研究发现:午睡时长影响健康 30分钟是关键点-全球最新
曾被称为格力接班人!格力直播间孟羽童视频被删除 天天动态
淄博90后女店主2个月瘦了10斤:1天烤鸡腿上千个 世界快讯
天天热点评!苹果在iPhone 14上挤牙膏!果粉立马用脚投票:好评率跌了
前法鹰主管:当年签镰田大地时他还很年轻,但能力让我想到齐达内
华为云数据库首席专家谈分布式数据应用挑战和发展建议 天天报资讯
如何完整地掌握一个机器学习模型 世界观点
数据结构与算法大作业:走迷宫程序(实验报告)_快资讯
Ubuntu20