菜单
×
   ❮     
HTML CSS JAVASCRIPT SQL PYTHON JAVA PHP 如何 W3.CSS C C++ C# BOOTSTRAP REACT MYSQL JQUERY EXCEL XML DJANGO NUMPY PANDAS NODEJS R TYPESCRIPT ANGULAR GIT POSTGRESQL MONGODB ASP AI GO KOTLIN SASS VUE DSA GEN AI SCIPY AWS CYBERSECURITY DATA SCIENCE
     ❯   

JS 教程

JS 首页 JS 简介 JS 放置位置 JS 输出 JS 语句 JS 语法 JS 注释 JS 变量 JS Let JS Const JS 运算符 JS 算术 JS 赋值 JS 数据类型 JS 函数 JS 对象 JS 对象属性 JS 对象方法 JS 对象显示 JS 对象构造函数 JS 事件 JS 字符串 JS 字符串方法 JS 字符串搜索 JS 字符串模板 JS 数字 JS BigInt JS 数字方法 JS 数字属性 JS 数组 JS 数组方法 JS 数组搜索 JS 数组排序 JS 数组迭代 JS 数组常量 JS 日期 JS 日期格式 JS 日期获取方法 JS 日期设置方法 JS 数学 JS 随机数 JS 布尔值 JS 比较 JS If Else JS Switch JS For 循环 JS For In 循环 JS For Of 循环 JS While 循环 JS Break JS 可迭代对象 JS Set JS Set 方法 JS Map JS Map 方法 JS Typeof JS 类型转换 JS 解构 JS 位运算 JS 正则表达式 JS 优先级 JS 错误 JS 作用域 JS 提升 JS 严格模式 JS this 关键字 JS 箭头函数 JS 类 JS 模块 JS JSON JS 调试 JS 编码规范 JS 最佳实践 JS 常见错误 JS 性能 JS 保留字

JS 版本

JS 版本 JS 2009 (ES5) JS 2015 (ES6) JS 2016 JS 2017 JS 2018 JS 2019 JS 2020 JS 2021 JS 2022 JS 2023 JS 2024 JS IE / Edge JS 历史

JS 对象

对象定义 对象原型 对象方法 对象属性 对象 Get / Set 对象保护

JS 函数

函数定义 函数参数 函数调用 函数 Call 函数 Apply 函数 Bind 函数闭包

JS 类

类入门 类继承 类静态

JS 异步

JS 回调 JS 异步 JS Promises JS Async/Await

JS HTML DOM

DOM 入门 DOM 方法 DOM Document DOM 元素 DOM HTML DOM 表单 DOM CSS DOM 动画 DOM 事件 DOM 事件监听器 DOM 导航 DOM 节点 DOM 集合 DOM 节点列表

JS Browser BOM

JS Window JS Screen JS Location JS History JS Navigator JS Popup Alert JS Timing JS Cookies

JS Web APIs

Web API 入门 Web 表单 API Web History API Web Storage API Web Worker API Web Fetch API Web Geolocation API

JS AJAX

AJAX 入门 AJAX XMLHttp AJAX Request AJAX Response AJAX XML 文件 AJAX PHP AJAX ASP AJAX 数据库 AJAX 应用 AJAX 示例

JS JSON

JSON 入门 JSON 语法 JSON vs XML JSON 数据类型 JSON 解析 JSON Stringify JSON 对象 JSON 数组 JSON 服务器 JSON PHP JSON HTML JSON JSONP

JS vs jQuery

jQuery 选择器 jQuery HTML jQuery CSS jQuery DOM

JS Graphics

JS Graphics JS Canvas JS Plotly JS Chart.js JS Google Chart JS D3.js

JS 示例

JS 示例 JS HTML DOM JS HTML 输入 JS HTML 对象 JS HTML 事件 JS 浏览器 JS 编辑器 JS 练习 JS 测验 JS 网站 JS 面试准备 JS Bootcamp JS 证书

JS 参考

JavaScript 对象 HTML DOM 对象


JavaScript 编码规范


所有 JavaScript 项目请始终使用相同的编码规范。


JavaScript 编码规范

编码规范是编程的风格指南。它们通常涵盖:

  • 变量和函数的命名及声明规则。
  • 空格、缩进和注释的使用规则。
  • 编程实践和原则。

编码规范确保质量

  • 提高代码可读性
  • 使代码维护更容易

编码规范可以是团队遵循的文档化规则,也可以只是您个人的编码习惯。

本页介绍了 W3Schools 使用的通用 JavaScript 编码规范。
您还应该阅读下一章“最佳实践”,了解如何避免编码陷阱。


变量名

在 W3schools,我们使用 驼峰式命名法 (camelCase) 作为标识符名称(变量和函数)。

所有名称都以字母开头。

在本页底部,您将找到关于命名规则的更广泛讨论。

firstName = "John";
lastName = "Doe";

price = 19.90;
tax = 0.20;

fullPrice = price + (price * tax);

运算符周围的空格

始终在运算符(= + - * /)周围和逗号后添加空格

示例

let x = y + z;
const myArray = ["Volvo", "Saab", "Fiat"];


代码缩进

代码块缩进始终使用 2 个空格

函数

function toCelsius(fahrenheit) {
  return (5 / 9) * (fahrenheit - 32);
}

请勿使用制表符进行缩进。不同的编辑器对制表符的解释不同。


语句规则

简单语句的通用规则

  • 简单语句始终以分号结束。

示例

const cars = ["Volvo", "Saab", "Fiat"];

const person = {
  firstName: "John",
  lastName: "Doe",
  age: 50,
  eyeColor: "blue"
};

复杂(复合)语句的通用规则

  • 将开括号放在第一行的末尾。
  • 在开括号前使用一个空格。
  • 将闭括号放在新行上,不带前导空格。
  • 复杂语句不以分号结束。

函数

function toCelsius(fahrenheit) {
  return (5 / 9) * (fahrenheit - 32);
}

循环

for (let i = 0; i < 5; i++) {
  x += i;
}

条件语句

if (time < 20) {
  greeting = "Good day";
} else {
  greeting = "Good evening";
}

对象规则

对象定义的通用规则

  • 将开括号放在对象名称的同一行。
  • 在每个属性及其值之间使用冒号加一个空格。
  • 字符串值使用引号,数字值不使用引号。
  • 最后一个属性-值对后不加逗号。
  • 将闭括号放在新行上,不带前导空格。
  • 对象定义始终以分号结束。

示例

const person = {
  firstName: "John",
  lastName: "Doe",
  age: 50,
  eyeColor: "blue"
};

短对象可以压缩写在一行上,只在属性之间使用空格,如下所示

const person = {firstName:"John", lastName:"Doe", age:50, eyeColor:"blue"};

行长度 < 80

为提高可读性,避免行长超过 80 个字符。

如果 JavaScript 语句不适合一行,最佳换行位置是在运算符或逗号之后。

示例

document.getElementById("demo").innerHTML =
"Hello Dolly.";
自己动手试一试 »

命名约定

始终对所有代码使用相同的命名约定。例如:

  • 变量和函数名称以驼峰式命名法 (camelCase) 编写
  • 全局变量以大写字母 (UPPERCASE) 编写(我们不这样做,但这很常见)
  • 常量(如 PI)以大写字母 (UPPERCASE) 编写

变量名称应该使用连字符 (hyp-hens)驼峰式命名法 (camelCase) 还是下划线 (under_scores)

这是程序员经常讨论的问题。答案取决于您问谁:

HTML 和 CSS 中的连字符

HTML5 属性可以以 data- 开头(data-quantity, data-price)。

CSS 在属性名称中使用连字符(font-size)。

连字符可能被误认为是减法操作。JavaScript 名称中不允许使用连字符。

下划线

许多程序员喜欢使用下划线(date_of_birth),尤其是在 SQL 数据库中。

PHP 文档中经常使用下划线。

帕斯卡命名法 (PascalCase)

C 程序员通常更喜欢帕斯卡命名法 (PascalCase)。

驼峰式命名法 (camelCase)

JavaScript 本身、jQuery 和其他 JavaScript 库都使用驼峰式命名法 (camelCase)。

不要以 $ 符号开头命名。这会与许多 JavaScript 库的名称冲突。


在 HTML 中加载 JavaScript

使用简单的语法加载外部脚本(不需要 type 属性)

<script src="myscript.js"></script>

访问 HTML 元素

使用“不整洁”的 HTML 样式可能会导致 JavaScript 错误。

这两个 JavaScript 语句将产生不同的结果:

const obj = getElementById("Demo")

const obj = getElementById("demo")

如果可能,请在 HTML 中使用与 JavaScript 相同的命名约定。

访问 HTML 编码规范.


文件扩展名

HTML 文件应使用 .html 扩展名(允许使用 .htm)。

CSS 文件应使用 .css 扩展名。

JavaScript 文件应使用 .js 扩展名。


使用小写文件名

大多数 Web 服务器(Apache、Unix)对文件名区分大小写

london.jpg 无法通过 London.jpg 访问。

其他 Web 服务器(Microsoft、IIS)不区分大小写

london.jpg 可以通过 London.jpg 或 london.jpg 访问。

如果您混合使用大小写,则必须保持极度一致。

如果您从不区分大小写的服务器迁移到区分大小写的服务器,即使是很小的错误也可能导致您的网站崩溃。

为避免这些问题,请始终使用小写文件名(如果可能)。


性能

编码规范不受计算机使用。大多数规则对程序的执行影响很小。

缩进和额外空格在小型脚本中不重要。

对于开发中的代码,应优先考虑可读性。较大的生产脚本应进行最小化处理。


×

联系销售

如果您想将 W3Schools 服务用于教育机构、团队或企业,请发送电子邮件给我们
sales@w3schools.com

报告错误

如果您想报告错误,或想提出建议,请发送电子邮件给我们
help@w3schools.com

W3Schools 经过优化,旨在方便学习和培训。示例可能经过简化,以提高阅读和学习体验。教程、参考资料和示例会不断审查,以避免错误,但我们无法保证所有内容的完全正确性。使用 W3Schools 即表示您已阅读并接受我们的使用条款Cookie 和隐私政策

版权所有 1999-2024 Refsnes Data。保留所有权利。W3Schools 由 W3.CSS 提供支持