HTML样式指南和代码约定

2023-11-22 51

在 2000 年至 2010 年之间,许多 web 开发者从 HTML 转换为 XHTML。通过 XHTML,开发者不得不编写有效的“格式良好的”代码。HTML5 提供了更多的语义化标签和属性,使得代码更加清晰易懂。同时,它还支持 CSS3,使得样式更加丰富多样。

一、正确的文档类型

文档类型声明位于HTML文档的第一行:

<!DOCTYPE html>

如果你想跟其他标签一样使用小写,可以使用以下代码:

<!doctype html>

二、小写元素名

HTML5 元素名可以使用大写和小写字母。

推荐使用小写字母:

  • 混合了大小写的风格是非常糟糕的;
  • 开发人员通常使用小写 (类似 XHTML);
  • 小写风格看起来更加清爽;
  • 小写字母容易编写。

不推荐:

<SECTION>
<p>这是一个段落。</p>
</SECTION>

非常不推荐:

<Section>
<p>这是一个段落。</p>
</SECTION>

推荐:

<section>
<p>这是一个段落。</p>
</section>

三、关闭HTML元素

在 HTML5 中,不必关闭所有元素(例如 <p> 元素)。建议关闭所有 HTML 元素:

不推荐:

<section>
<p>This is a paragraph.
<p>This is a paragraph.
</section>

推荐:

<section>
<p>This is a paragraph.</p>
<p>This is a paragraph.</p>
</section>

四、关闭HTML空元素

在 HTML5 中,关闭空元素是可选的。允许下面两种操作:

<meta charset="utf-8">
<meta charset="utf-8" />

斜杠(/)在 XHTML 和 XML 中是必需的。如果期望 XML 软件来访问您的页面,建议保持这个良好习惯。

五、小写属性名

HTML5 允许大小写混合的属性名。建议使用小写属性名:

  • 混合属性名并不好;
  • 开发者习惯于使用小写属性名(比如在 XHTML 中);
  • 小写属性名看情况更纯净;
  • 小写属性名更易书写。

不推荐:

<div CLASS="menu">

推荐:

<div class="menu">

六、属性值加引号

HTML5 允许不加引号的属性值。推荐属性值加引号:

  • 如果属性值包含值,则必须使用引号;
  • 混合样式绝对不好;
  • 加引号的值更易阅读。

这个属性值无效,因为值中包含空格:

<table class=table striped>

这样是有效的:

<table class="table striped">

七、必需的属性

请始终对图像使用 alt 属性。当图像无法显示时该属性很重要。

<img src="html5.gif" alt="HTML5" style="width:128px;height:128px">

请始终定义图像尺寸。这样做会减少闪烁,因为浏览器会在图像加载之前为图像预留空间。

<img src="html5.gif" alt="HTML5" style="width:128px;height:128px">

八、空格和等号

等号两边的空格是合法的:

<link rel = "stylesheet" href = "styles.css">

少用空格更易读,并且更好地将实体组合在一起。

<link rel="stylesheet" href="styles.css" rel="external nofollow"  rel="external nofollow" >

九、避免长代码行

  • 当使用 HTML 编辑器时,通过左右滚动来阅读 HTML 代码很不方便;
  • 请尽量避免代码行超过 80 个字符。

十、空行和缩进

  • 为了提高可读性,请增加空行来分隔大型或逻辑代码块;
  • 为了提高可读性,请增加两个空格的缩进。请勿使用 TAB;
  • 请勿毫无理由地增加空行;
  • 请勿使用没有必要的空行和缩进。没有必要在短的和相关项目之间使用空行,也没有必要缩进每个元素:

不推荐:

<body>
<h1>Famous Cities</1>
<h2>Tokyo</h2>
<p>
Tokyo is the capital of Japan, the center of the Greater Tokyo Area,
and the most populous metropolitan area in the world.
It is the seat of the Japanese government and the Imperial Palace,
and the home of the Japanese Imperial Family.
</p>
</body>

推荐:

<body>
<h1>Famous Cities</1>
<h2>Tokyo</h2>
<p>
Tokyo is the capital of Japan, the center of the Greater Tokyo Area,
and the most populous metropolitan area in the world.
It is the seat of the Japanese government and the Imperial Palace,
and the home of the Japanese Imperial Family.
</p>
</body>

表格示例:

<table>
<tr>
<th>Name</th>
<th>Description</th>
<tr>
<tr>
<td>A</td>
<td>Description of A</td>
<tr>
<tr>
<td>B</td>
<td>Description of B</td>
<tr>
</table>

列表示例:

<ol>
<li>LondonA</li>
<li>Paris</li>
<li>Tokyo</li>
</ol>

十一、省略html和body

在 HTML5 标准中,能够省略 <html> 标签和 <body> 标签。

以下代码作为 HTML5 进行验证:

<!DOCTYPE html>
<head>
<title>Page Title</title>
</head>
<h1>This is a heading</h1>
<p>This is a paragraph.</p>

但是我们不推荐省略 <html> 和 <body> 标签。<html> 元素是文本的根元素。它是规定页面语言的理想位置。

<!DOCTYPE html>
<html lang="en-US">

对于可访问应用程序(屏幕阅读器)和搜索引擎,声明语言很重要。

  • 省略 <html> 或 <body> c可令 DOM 和 XML 软件崩溃;
  • 省略 <body> 会在老式浏览器(IE9)中产生错误。

十二、省略head

在 HTML5 标准中,<head> 标签也能够被省略。默认地,浏览器会把 <body> 之前的所有元素添加到默认的 <head> 元素。

通过省略 <head> 标签,您能够降低 HTML 的复杂性:

<!DOCTYPE html>
<html>
<title>Page Title</title>
<body>
<h1>This is a heading</h1>
<p>This is a paragraph.</p>
</body>
</html>

十三、元数据

<title> 元素在 HTML5 中是必需的。请尽可能制作有意义的标题。

<title>HTML5 Syntax and Coding Style</title>

为了确保恰当的解释,以及正确的搜索引擎索引,在文档中对语言和字符编码的定义越早越好:

<!DOCTYPE html>
<html lang="en-US">
<head>
<meta charset="UTF-8">
<title>HTML5 Syntax and Coding Style</title>
</head>

十四、HTML注释

1、短注释

短注释应该在单行中书写,并在 <!– 之后增加一个空格,在 –> 之前增加一个空格:

<!-- This is a comment -->

2、长注释

长注释,跨越多行,应该通过 <!– 和 –> 在独立的行中书写:

<!-- 
This is a long comment example. This is a long comment example. This is a long comment example.
This is a long comment example. This is a long comment example. This is a long comment example.
-->

如果被缩进两个空格的话长注释更易观察。

十五、样式表

请使用简单的语法来链接样式表(type 属性不是必需的):

<link rel="stylesheet" href="styles.css" rel="external nofollow"  rel="external nofollow" >

短规则可以压缩为一行,就像这样:

p.into {font-family:"Verdana"; font-size:16em;}

长规则应该分为多行:

body {
background-color: lightgrey;
font-family: "Arial Black", Helvetica, sans-serif;
font-size: 16em;
color: black;
}
  • 开括号与选择器位于同一行;
  • 在开括号之前用一个空格;
  • 使用两个字符的缩进;
  • 在每个属性与其值之间使用冒号加一个空格;
  • 在每个逗号或分号之后使用空格;
  • 在每个属性值对(包括最后一个)之后使用分号;
  • 只在值包含空格时使用引号来包围值;
  • 把闭括号放在新的一行,之前不用空格;
  • 避免每行超过 80 个字符。

注意:在逗号或分号之后添加空格,是所有书写类型的通用规则。

十六、加载JavaScript

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

<script src="myscript.js">

十七、JavaScript访问HTML元素

使用“不整洁”的 HTML 样式的后果,是可能会导致 JavaScript 错误。这两个 JavaScript 语句会产生不同的结果:

var obj = getElementById("Demo")
var obj = getElementById("demo")

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

十八、小写文件名

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

  • 不能以 london.jpg 访问 London.jpg;
  • 其他 web 服务器(微软,IIS)对大小写不敏感;
  • 能够以 london.jpg 或 London.jpg 访问 London.jpg;
  • 如果使用混合大小写,那么您必须保持高度的一致性;
  • 如果从对大小写不敏感的服务器转到一台对大小写敏感的服务器上,这些小错误将破坏您的网站。

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

十九、文件扩展名

  • HTML 文件名应该使用扩展名 .html(而不是 .htm);
  • CSS 文件应该使用扩展名 .css;
  • JavaScript 文件应该使用扩展名 .js。
  • 广告合作

  • QQ群号:707632017

温馨提示:
1、本网站发布的内容(图片、视频和文字)以原创、转载和分享网络内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。邮箱:2942802716#qq.com(#改为@)。 2、本站原创内容未经允许不得转裁,转载请注明出处“站长百科”和原文地址。
HTML样式指南和代码约定
上一篇: HTML响应式Web设计
HTML样式指南和代码约定
下一篇: HTML和XHTML