HTML代码书写规范指南
HTML代码书写规范指南
发布时间:2016-12-27 来源:查字典编辑
摘要:通用约定标签自闭合(self-closing)标签,无需闭合(例如:imginputbrhr等);可选的闭合标签(closingtag),需...

通用约定

标签

自闭合(self-closing)标签,无需闭合 ( 例如: img input br hr 等 );

可选的闭合标签(closing tag),需闭合 ( 例如:</li> 或 </body>);

尽量减少标签数量;

XML/HTML Code复制内容到剪贴板 <imgsrc="images/google.png"alt="Google"> <inputtype="text"name="title"> <ul> <li>Style</li> <li>Guide</li> </ul> <> <spanclass="avatar"> <imgsrc="..."> </span> <> <imgclass="avatar"src="...">

Class 与 ID

class 应以功能或内容命名,不以表现形式命名;

class 与 id 单词字母小写,多个单词组成时,采用中划线-分隔;

使用唯一的 id 作为 Javascript hook,同时避免创建无样式信息的 class;

XML/HTML Code复制内容到剪贴板 <> <divclass="j-hookleftcontentWrapper"></div> <> <divid="j-hook"class="sidebarcontent-wrapper"></div>

属性顺序

HTML 属性应该按照特定的顺序出现以保证易读性。

id

class

name

data-xxx

src, for, type, href

title, alt

aria-xxx, role

XML/HTML Code复制内容到剪贴板 <aid="..."class="..."data-modal="toggle"href="###"></a> <inputclass="form-control"type="text"> <imgsrc="..."alt="...">

引号

属性的定义,统一使用双引号。

XML/HTML Code复制内容到剪贴板 <> <spanid='j-hook'class=text>Google</span> <> <spanid="j-hook"class="text">Google</span>

b嵌套

a 不允许嵌套 div 这种约束属于语义嵌套约束,与之区别的约束还有严格嵌套约束,比如 a 不允许嵌套 a。

严格嵌套约束在所有的浏览器下都不被允许;而语义嵌套约束,浏览器大多会容错处理,生成的文档树可能相互不太一样。

语义嵌套约束

<li> 用于 <ul> 或 <ol> 下;

<dd>,<dt> 用于 <dl> 下;

<thead>,<tbody>,<tfoot>,<tr>,<td> 用于<table>下;

严格嵌套约束

inline-Level 元素,仅可以包含文本或其它 inline-Level 元素;

<a> 里不可以嵌套交互式元素 <a>、<button>、<select>等;

<p>里不可以嵌套块级元素<div>、<h1>~<h6>、<p>、<ul>/<ol>/<li>、<dl>/<dt>/<dd>、<form>等。

布尔值属性

HTML5 规范中 disabled、checked、selected 等属性不用设置值。

XML/HTML Code复制内容到剪贴板 <inputtype="text"disabled> <inputtype="checkbox"value="1"checked> <select> <optionvalue="1"selected>1</option> </select>

语义化

没有 CSS 的 HTML 是一个语义系统而不是 UI 系统。

通常情况下,每个标签都是有语义的,所谓语义就是你的衣服分为外套, 裤子,裙子,内裤等,各自有对应的功能和含义。所以你总不能把内裤套在脖子上吧。-- 一丝

此外语义化的 HTML 结构,有助于机器(搜索引擎)理解,另一方面多人协作时,能迅速了解开发者意图。

常见标签语义

标签 语义
<p> 段落
<h1><h2><h3>... 标题
<ul> 无序列表
<ol> 有序列表
<blockquote> 大段引用
<cite> 一般引用
<b> 为样式加粗而加粗
<storng> 为强调内容而加粗
<i> 为样式倾斜而倾斜
<em> 为强调内容而倾斜
code 代码标识
abbr 缩写

示例

将你构建的页面当作一本书,将标签的语义对应的其功能和含义;

书的名称:<h1>

书的每个章节标题: <h2>

章节内的文章标题: <h3>

小标题 / 副标题: <h4> <h5> <h6>

章节的段落: <p>

HEAD

文档类型

为每个 HTML 页面的第一行添加标准模式(standard mode)的声明, 这样能够确保在每个浏览器中拥有一致的表现。

XML/HTML Code复制内容到剪贴板 <!DOCTYPEhtml> 语言属性 <> <htmllang="zh-Hans"> <> <htmllang="zh-cmn-Hans"> <> <htmllang="zh-cmn-Hant"> <> <htmllang="en">

字符编码

以无 BOM 的 utf-8 编码作为文件格式;

指定字符编码的 meta 必须是 head 的第一个直接子元素

XML/HTML Code复制内容到剪贴板 <html> <head> <metacharset="utf-8"> ...... </head> <body> ...... </body> </html>

IE 兼容模式

优先使用最新版本的 IE 和 Chrome 内核。

XML/HTML Code复制内容到剪贴板 <metahttp-equiv="X-UA-Compatible"content="IE=edge,chrome=1">

SEO 优化

XML/HTML Code复制内容到剪贴板 <head> <metacharset="utf-8"> <metahttp-equiv="X-UA-Compatible"content="IE=edge,chrome=1"> <> <title>StyleGuide</title> <metaname="keywords"content="yourkeywords"> <metaname="description"content="yourdescription"> <metaname="author"content="author,emailaddress"> </head>

viewport

viewport: 一般指的是浏览器窗口内容区的大小,不包含工具条、选项卡等内容;

width: 浏览器宽度,输出设备中的页面可见区域宽度;

device-width: 设备分辨率宽度,输出设备的屏幕可见宽度;

initial-scale: 初始缩放比例;

maximum-scale: 最大缩放比例;

为移动端设备优化,设置可见区域的宽度和初始缩放比例。

XML/HTML Code复制内容到剪贴板 <metaname="viewport"content="width=device-width,initial-scale=1.0">

iOS 图标

apple-touch-icon 图片自动处理成圆角和高光等效果;

apple-touch-icon-precomposed 禁止系统自动添加效果,直接显示设计原图;

XML/HTML Code复制内容到剪贴板 <> <linkrel="apple-touch-icon-precomposed"href="/apple-touch-icon-57x57-precomposed.png"> <> <linkrel="apple-touch-icon-precomposed"href="/apple-touch-icon-72x72-precomposed.png"sizes="72x72"> <> <linkrel="apple-touch-icon-precomposed"href="/apple-touch-icon-114x114-precomposed.png"sizes="114x114"> <> <linkrel="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;

XML/HTML Code复制内容到剪贴板 <linkrel="shortcuticon"href="path/to/favicon.ico">

HEAD 模板

XML/HTML Code复制内容到剪贴板 <!DOCTYPEhtml> <htmllang="zh-cmn-Hans"> <head> <metacharset="utf-8"> <metahttp-equiv="X-UA-Compatible"content="IE=edge,chrome=1"> <title>StyleGuide</title> <metaname="description"content="不超过150个字符"> <metaname="keywords"content=""> <metaname="author"content="name,email@gmail.com"> <> <metaname="viewport"content="width=device-width,initial-scale=1.0"> <> <linkrel="apple-touch-icon-precomposed"href="/apple-touch-icon-57x57-precomposed.png"> <linkrel="alternate"type="application/rss+xml"title="RSS"href="/rss.xml"/> <linkrel="shortcuticon"href="path/to/favicon.ico"> </head>

HTML 注释

模块注释

XML/HTML Code复制内容到剪贴板 <> <divclass="article-list"> ... </div> 区块注释 <!-- @name:DropDownMenu @description:Styleoftopbardropdownmenu. @author:Ashu(Aaaaaashu@gmail.com) -->

推荐文章
猜你喜欢
附近的人在看
推荐阅读
拓展阅读
相关阅读
网友关注
最新XHTML学习
热门XHTML学习
网页设计子分类