html 注释_HTML 规范（附带教程）

摘要

优秀的项目源码，即使是多人开发，看代码也如出一人之手。统一的编码规范，可使代码更易于阅读，易于理解，易于维护

HTML 规范

缩进

统一两个空格缩进

命名规范

class 应以功能或内容命名，不以表现形式命名；class 与 id 单词字母小写，多个单词组成时，采用中划线-分隔；使用唯一的 id 作为 Javascript hook, 同时避免创建无样式信息的 class；

DOCTYPE 声明

HTML 文件必须加上 DOCTYPE 声明，并统一使用 HTML5 的文档声明：

<!DOCTYPE html> meta 标签统一使用 “UTF-8” 编码 <meta charset="utf-8"> SEO 优化 <meta name ="keywords" content =""/><meta name ="description" content =""><meta name ="author" content =""> 优先使用 IE 最新版本和 Chrome <meta http-equiv ="X-UA-Compatible" content ="IE = edge，chrome = 1"> 为移动设备添加视口 <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=no"> 禁止自动识别页面中有可能是电话格式的数字 <meta name="format-detection" content="telephone=no">

团队约定：

pc 端：

移动端：

标签

html 标签分为以下几类：

自闭合标签（self-closing），无需闭合。例如：area、base、br、col、command、embed、hr、img、input、keygen、link、meta、param、source、track、wbr 等 )闭合标签（closing tag），需闭合。例如：textarea、title、h、div、span 等

团队约定：

所有具有开始标签和结束标签的元素都必须要写上起止标签，某些允许省略开始标签或和束标签的元素亦都要写上自闭合标签不要加上结束标签自定义标签的名字必须包含一个破折号（-），<x-tags>、<my-element>和<my-awesome-app>都是正确的名字，而<tabs>和<foo_bar>是不正确的。这样的限制使得 HTML 解析器可以分辨那些是标准元素，哪些是自定义元素自定义标签必须写上开始标签和闭合标签尽量减少标签数量元素属性元素属性值使用双引号语法

推荐：

不推荐：

代码嵌套

块元素可以包含内联元素或某些块元素，但内联元素却不能包含块元素，它只能包含其它的内联元素

标题和段落中不能包含块，如：h1、h2、h3、h4、h5、h6、p、dt

块与内联不能并列，块级元素与块级元素并列、内嵌元素与内嵌元素并列

有些标签是固定的嵌套规则，比如 ul 包含 li、ol 包含 li、dl 包含 dt 和 dd 等等。

灵活使用伪类

不要让非内容信息污染了你的 HTML，打乱了 HTML 结构。可以使用:before、:after 等伪类元素

推荐：

HTML 代码

<span class="text-box"> See the square next to me?</span>

CSS 代码：

/* We use a :before pseudo element to solve the design problem of placing a colored square in front of the text content */.text-box:before { content: ''; display: inline-block; width: 1rem; height: 1rem; background-color: red;}

不推荐：

HTML 代码：

<span class="text-box"> <span class="square"></span> See the square next to me?</span>

CSS 代码：

.text-box > .square { display: inline-block; width: 1rem; height: 1rem; background-color: red;} 特殊符号必须使用转义符

纯数字输入框

使用 type=“tel” 而不是 type=“number”

<input type="tel"> 类型属性

不需要为 CSS、JS 指定类型属性，HTML5 中默认已包含。

推荐：

不推荐：

单行注释

一般用于简单的描述，如某些状态描述、属性描述等注释内容前后各一个空格字符，注释位于要注释代码的上面，单独占一行

推荐：

<div>...</div>

不推荐：

模块注释

注释内容前后各一个空格字符表示模块开始表示模块结束，模块与模块之间相隔一行模块注释内部嵌套模块注释，

推荐：

<div class="mod_a"> <div class="mod_b"> ... </div>  <div class="mod_c"> ... </div> </div><div class="mod_d"> ...</div> 语义化没有 CSS 的 HTML 是一个语义系统而不是 UI 系统通常情况下，每个标签都是有语义的语义化的 HTML 结构，有助于机器（搜索引擎）理解，另一方面多人协作时，能迅速了解开发者意图建议页面中多使用语义化标签，而不是整个页面以 div 构成常见标签语义：

作者：JavaScript语言

来源：CSDN

原文：https://blog.csdn.net/nnnn1235657/article/details/94763262

附带教程：

课程目标：学习完本课程,可以熟练掌握网页的开发,各种常用标记的使用；

适用人群：本课程适合于零基础的人群学习.由浅入深,循序渐进；

课程概述：超级文本标记语言是标准通用标记语言下的一个应用，也是一种规范，一种标准，它通过标记符号来标记要显示的网页中的各个部分。网页文件本身是一种文本文件，通过在文本文件中添加标记符，可以告诉浏览器如何显示其中的内容（如：文字如何处理，画面如何安排，图片如何显示等）。浏览器按顺序阅读网页文件，然后根据标记符解释和显示其标记的内容，对书写出错的标记将不指出其错误，且不停止其解释执行过程，编制者只能通过显示效果来分析出错原因和出错部位。但需要注意的是，对于不同的浏览器，对同一标记符可能会有不完全相同的解释，因而可能会有不同的显示效果。

环境参数：Windows 32位或 64位

快速掌握HTML|HTML视频课程 - 蛙课视频www.wkcto.com