编码规范_html代码规范化编写
语法
-
缩进使用soft tab(4个空格);
-
嵌套的节点应该缩进;
-
在属性上,使用双引号,不要使用单引号;
-
属性名全小写,用中划线做分隔符;
-
不要在自动闭合标签结尾处使用斜线(html5 规范 指出他们是可选的);
-
不要忽略可选的关闭标签;
html5 doctype
在页面开头使用这个简单地doctype来启用标准模式,使其在每个浏览器中尽可能一致的展现;
虽然doctype不区分大小写,但是按照惯例,doctype大写 (关于html属性,大写还是小写)。
<!DOCTYPE html>
lang属性
根据html5规范:
应在html标签上加上lang属性。这会给语音工具和翻译工具帮助,告诉它们应当怎么去发音和翻译。
更多关于 lang 属性的说明在这里;
在sitepoint上可以查到语言列表;
但sitepoint只是给出了语言的大类,例如中文只给出了zh,但是没有区分香港,台湾,大陆。而微软给出了一份更加详细的语言列表,其中细分了zh-cn, zh-hk, zh-tw。
<html lang="en-us">
字符编码
通过声明一个明确的字符编码,让浏览器轻松、快速的确定适合网页内容的渲染方式,通常指定为'UTF-8'。
<meta charset="UTF-8">
IE兼容模式
用<meta>签可以指定页面应该用什么版本的IE来渲染;
代码示例:
<meta http-equiv="X-UA-Compatible"content="IE=Edge">
引入css, js
根据html5规范, 通常在引入css和js时不需要指明 type,因为 text/css和 text/JavaScript 分别是他们的默认值。
html5 规范链接
-
使用link
-
使用style
-
使用script
<!-- External css --> <link rel="stylesheet" href="code_guide.css"> <!-- In-document css --> <style> </style> <!-- External js --> <script src="code_guide.js"></script> <!-- In-document js --> <script> </script>
属性顺序
属性应该按照特定的顺序出现以保证易读性;
-
class
-
id
-
name
-
data-*
-
src, for, type, href, value , max-length, max, min, pattern
-
placeholder, title, alt
-
aria-*, role
-
required, readonly, disabled
class是为高可复用组件设计的,所以应处在第一位;
id更加具体且应该尽量少使用,所以将它放在第二位。
<a id="..." data-modal="toggle" href="#"> Example link </a> <img src="..." alt="...">
boolean属性
boolean属性指不需要声明取值的属性,Xhtml需要每个属性声明取值,但是HTML5并不需要;boolean属性的存在表示取值为true,不存在则表示取值为false。
<input type="text" disabled> <input type="checkbox" value="1" checked> <select> <option value="1" selected>1</option> </select>
摄图网https://www.wode007.com/sites/73204.html VJ师网https://www.wode007.com/sites/73287.html
js生成标签
在js文件中生成标签让内容变得更难查找,更难编辑,性能更差。应该尽量避免这种情况的出现。
减少标签数量
在编写HTML代码时,需要尽量避免多余的父节点;
很多时候,需要通过迭代和重构来使HTML变得更少。
实用高于完美
尽量遵循HTML标准和语义,但是不应该以浪费实用性作为代价;
任何时候都要用尽量小的复杂度和尽量少的标签来解决问题。