JavaScript 教程

JS 教程 JS 简介 JS 如何使用 JS 输出 JS 语句 JS 语法 JS 注释 JS 变量 JS 运算符 JS 算法 JS 赋值 JS 数据类型 JS 函数 JS 对象 JS 事件 JS 字符串 JS 字符串方法 JS 数值 JS 数值方法 JS 数组 JS 数组方法 JS 数组排序 JS 数组迭代 JS 日期 JS 日期格式 JS 日期获取方法 JS 日期设置方法 JS 数学运算 JS 随机数 JS 布尔运算符 JS 比较运算符 JS 条件语句 JS Switch 语句 JS For 循环 JS While 循环 JS Break JS 类型转换 JS 位运算符 JS 正则表达式 JS 错误处理 JS 作用域 JS Hoisting JS 严格模式 JS this 关键词 JS Let 关键词 JS Const 关键词 JS 箭头函数 JS 类 JS 调试 JS 样式指南 JS 最佳实践 JS 常见错误 JS 性能优化 JS 保留关键词 JS 版本 JS ES5 JS ES6 JS JSON

JS 表单

JS Forms Forms API

JS 对象

Object 对象定义 Object 对象属性 Object 对象方法 Object Display Object 对象访问器 Object 对象构造器 Object 对象原型 Object ECMAScript 5

JS 函数

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

JS 类库

Class 类简介 Class 类继承 Class Static

JS 异步

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

JS HTML DOM

DOM 简介 DOM 方法 DOM 文档 DOM 元素 DOM HTML DOM CSS DOM 动画 DOM 事件 DOM 事件监听 DOM 导航 DOM 节点 DOM 集合 DOM 节点列表

JS 浏览器 BOM

JS Window JS Screen JS Location JS History JS Navigator JS 弹出框 JS Timing JS Cookies

JS AJAX

AJAX 简介 AJAX XMLHttp AJAX 请求 AJAX 响应 AJAX XML 文件 AJAX PHP AJAX ASP AJAX 数据库 AJAX 应用程序 AJAX 实例

JS JSON

JSON 简介 JSON 语法 JSON vs XML JSON 数据类型 JSON 解析 JSON 字符串化 JSON 对象 JSON 数组 JSON PHP JSON HTML JSON JSONP

JS Web APIs

Web API 简介 Web History API Web Storage API Web Geolocation API

JS vs jQuery

jQuery 选择器 jQuery HTML jQuery CSS jQuery DOM

JS 实例

JS 实例 JS HTML DOM JS HTML 输入 JS HTML 对象 JS HTML 事件 JS Browser JS 编辑器 JS 练习 JS 测验

JS 参考手册

JS 对象 HTML DOM 对象



JavaScript 样式指南

请始终为您所有的 JavaScript 项目使用相同的代码约定。


JavaScript 代码约定

代码约定(Coding conventions)指的是编程的样式指导方针。这些原则大体上包括:

  • 变量和函数的命名和声明规则
  • 使用空格、缩进和注释的规则
  • 编程习惯和准则

代码约定确保质量

  • 改善代码可读性
  • 提升代码可维护性

代码约定可以是团队遵守的成文规则,也可以是您个人的编码习惯。

本页介绍 W3Schools 使用的通用 JavaScript 代码约定。

您应该继续阅读下一章"最佳实践",学习如何避免编码陷阱。


变量名

在 W3Schools,我们对标识符名称(变量和函数)使用了驼峰式大小写

所有名称以字母开头。

在本页的底部,我们会更广泛地讨论命名规则。

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

price = 19.90;
tax = 0.20;

fullPrice = price + (price * tax);

运算符周围的空格

请始终在运算符( = + - * / )周围以及逗号之后添加空格:

实例:

var x = y + z;
var values = ["Volvo", "Saab", "Fiat"];


代码缩进

请始终使用对代码块缩进使用 4 个空格:

函数

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

请不要对缩进使用制表符。不同的编辑器对 tab 的解释也不尽相同。


语句规则

简单语句的通用规则:

    请始终以分号结束单条语句:

实例:

var values = ["Volvo", "Saab", "Fiat"];

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

针对复杂语句(compound)的通用规则:

  • 请在第一行的结尾处写开括号
  • 请在开括号前使用一个空格
  • 请在新行上写闭括号,不带前导空格
  • 请不要以分号来结束复杂语句

函数:

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

循环:

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

条件:

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

对象规则

针对对象定义的通用规则:

  • 把开括号与对象名放在同一行
  • 在每个属性与其值之间使用冒号加一个空格
  • 不要在最后一个属性值对后面写逗号
  • 请在新行上写闭括号,不带前导空格
  • 请始终以分号结束对象定义

实例

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

可以对短对象在一行中进行压缩,只在属性之间使用空格,就像这样:

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

行长度小于 80

为了提高可读性,请避免每行的长度超过 80 个字符。

如果 JavaScript 语句超过一行的长度,换行的最佳位置是运算符或逗号之后。

实例

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

命名约定

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

  • 变量和函数名以驼峰大小写来写
  • 全局变量使用大写(我们不这样做,但是相当普遍)
  • 常量(比如 PI)使用大写

我们是否应在变量名中使用连字符驼峰大小写下划线吗?

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

HTML 和 CSS 中的连字符:

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

CSS 在 property-names 中使用连字符(font-size)。

Hyphens 可被错误地视为减法运算符。JavaScript 命名不允许使用连字符。

下划线:

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

下划线经常被用在 PHP 参考资料中。

帕斯卡命名法(PascalCase):

C 语言程序员经常使用帕斯卡命名法。

驼峰大小写(camelCase):

JavaScript 本身、jQuery 以及其他 JavaScript 库使用驼峰大小写。

JavaScript 命名请不要以 $ 符号开头。此举会引起 JavaScript 库名称冲突。


在 HTML 中加载 JavaScript

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

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

访问 HTML 元素

使用"不整洁的" HTML 样式的后果,也许是导致 JavaScript 错误。

这两条 JavaScript 语句会产生不同的结果:

var obj = getElementById("Demo")

var obj = getElementById("demo")

如果可能,请在 HTML 中使用相同的命名约定(就像 JavaScript 那样)。

访问 HTML 样式指南


文件扩展名

HTML 文件应该使用 .html 扩展名(而非 .htm)。

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

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


使用小写文件名

大多数 web 服务器(Apache、Unix)对文件名的大小写敏感:

london.jpg 无法视作 London.jpg 进行访问。

其他 web 服务器(微软的 IIS)对大小写不敏感:

london.jpg 能够以 London.jpg 或 london.jpg 来访问。

如果您混合使用大小写,则必须严格保持连续和一致。

如果您将站点从大小写不敏感的服务器转移至对大小写敏感的服务器,即使这种小错误也可能破坏您的网站。

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


性能

计算机不会使用代码约定。大部分规则对程序的执行影响很小。

缩进和额外的空格对小段脚本并不重要。

对于开发中的脚本,应该优先考虑可读性。应该缩小更大型的生产脚本。