);
盡量減少標籤數量;
<img src="images/google.png" alt="Google"> <input type="text" name="title"> <ul> <li>Style</li> <li>Guide</li> </ul> <!-- Not recommended --> <span class="avatar"> <img src="..."> </span> <!-- Recommended --> <img class="avatar" src="...">
Class 與ID
class 應以功能或內容命名,不以表現形式命名;
class 與id 單字字母小寫,多個單字組成時,採用中劃線-分隔;
使用唯一的id 作為Javascript hook,同時避免建立無樣式資訊的class;
<!-- Not recommended --> <p class="j-hook left contentWrapper"></p> <!-- Recommended --> <p id="j-hook" class="sidebar content-wrapper"></p>
屬性順序
HTML 屬性應該按照特定的順序出現以確保易讀性。
id
class
name
data-xxx
src, for, type, href
title, alt
aria-xxx, role
<a id="..." class="..." data-modal="toggle" href="###"></a> <input class="form-control" type="text"> <img src="..." alt="...">
引號
屬性的定義,並統一使用雙引號。
<!-- Not recommended --> <span id='j-hook' class=text>Google</span> <!-- Recommended --> <span id="j-hook" class="text">Google</span>
b巢狀
a 不允許巢狀p 此約束屬於語意巢狀約束,與之區別的限制還有嚴格嵌套約束,例如a 不允許嵌套a。
嚴格巢狀約束在所有的瀏覽器下都不被允許;而語意嵌套約束,瀏覽器大多會容錯處理,產生的文件樹可能相互不太一樣。
語意嵌套約束
#f | 語義 |
段落 | |
... | 標題 |
#無序列表 | |
有序列表 | |
大段引用 | |
為樣式加粗而加粗 | |
為強調內容而加粗 | |
為樣式傾斜而傾斜 | |
#code | |
示例
将你构建的页面当作一本书,将标签的语义对应的其功能和含义;
书的名称:
HEAD
文档类型
为每个 HTML 页面的第一行添加标准模式(standard mode)的声明, 这样能够确保在每个浏览器中拥有一致的表现。
<!DOCTYPE html> 语言属性 <!-- 中文 --> <html lang="zh-Hans"> <!-- 简体中文 --> <html lang="zh-cmn-Hans"> <!-- 繁体中文 --> <html lang="zh-cmn-Hant"> <!-- English --> <html lang="en">
字符编码
以无 BOM 的 utf-8 编码作为文件格式;
指定字符编码的 meta 必须是 head 的第一个直接子元素
<html> <head> <meta charset="utf-8"> ...... </head> <body> ...... </body> </html>
IE 兼容模式
优先使用最新版本的 IE 和 Chrome 内核。
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
SEO 优化
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">Style Guide
viewport
viewport: 一般指的是浏览器窗口内容区的大小,不包含工具条、选项卡等内容;
width: 浏览器宽度,输出设备中的页面可见区域宽度;
device-width: 设备分辨率宽度,输出设备的屏幕可见宽度;
initial-scale: 初始缩放比例;
maximum-scale: 最大缩放比例;
为移动端设备优化,设置可见区域的宽度和初始缩放比例。
<meta name="viewport" content="width=device-width, initial-scale=1.0">
iOS 图标
apple-touch-icon 图片自动处理成圆角和高光等效果;
apple-touch-icon-precomposed 禁止系统自动添加效果,直接显示设计原图;
<!-- iPhone 和 iTouch,默认 57x57 像素,必须有 --> <link rel="apple-touch-icon-precomposed" href="/apple-touch-icon-57x57-precomposed.png"> <!-- iPad,72x72 像素,可以没有,但推荐有 --> <link rel="apple-touch-icon-precomposed" href="/apple-touch-icon-72x72-precomposed.png" sizes="72x72"> <!-- Retina iPhone 和 Retina iTouch,114x114 像素,可以没有,但推荐有 --> <link rel="apple-touch-icon-precomposed" href="/apple-touch-icon-114x114-precomposed.png" sizes="114x114"> <!-- Retina iPad,144x144 像素,可以没有,但推荐有 --> <link rel="apple-touch-icon-precomposed" href="/apple-touch-icon-144x144-precomposed.png" sizes="144x144">
favicon
在未指定 favicon 时,大多数浏览器会请求 Web Server 根目录下的 favicon.ico。为了保证 favicon 可访问,避免 404,必须遵循以下两种方法之一:
在 Web Server 根目录放置 favicon.ico 文件;
使用 link 指定 favicon;
<link rel="shortcut icon" href="path/to/favicon.ico">
HEAD 模板
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">Style Guide <meta name="viewport" content="width=device-width, initial-scale=1.0"> <link rel="shortcut icon" href="path/to/favicon.ico">
HTML 注释
模块注释
<!-- 文章列表列表模块 --> <p class="article-list"> ... </p> 区块注释 <!-- @name: Drop Down Menu @description: Style of top bar drop down menu. @author: Ashu(Aaaaaashu@gmail.com) -->
更多HTML代码书写规范指南相关文章请关注PHP中文网!