1 / 22
文档名称:

HTML5页面编码规范.docx

格式:docx   大小:1,508KB   页数:22页
下载后只包含 1 个 DOCX 格式的文档,没有任何的图纸或源代码,查看文件列表

如果您已付费下载过本站文档,您可以点这里二次下载

分享

预览

HTML5页面编码规范.docx

上传人:才艺人生 2022/6/19 文件大小:1.47 MB

下载得到文件列表

HTML5页面编码规范.docx

文档介绍

文档介绍:HTML5页面编码规范
1 前言
HTML作为描述网页结构的超文本标记语言,在百度一直有着广泛的应用。本文档的目标是使HTML代码风格保持一致,容易被理解和被维护。
2 代码风格
缩进与换行
[强制] 使用 4 个示例:
<!-- good -->
<img class="avatar" src="">
<!-- bad -->
<span class="avatar">
<img src="">
</span>
属性
[强制] 属性名必须使用小写字母。
示例:
<!-- good -->
<table cellspacing="0">...</table>
<!-- bad -->
<table cellSpacing="0">...</table>
[强制] 属性值必须用双引号包围。
解释:
不允许使用单引号,不允许不使用引号。
示例:
<!-- good -->
<script src=""></script>
<!-- bad -->
<script src=''></script>
<script src=></script>
[建议] 布尔类型的属性,建议不添加属性值。
示例:
<input type="text" disabled>
<input type="checkbox" value="1" checked>
[建议] 自定义属性建议以 xxx- 为前缀,推荐使用 data-。
解释:
使用前缀有助于区分自定义属性和标准定义的属性。
示例:
<ol data-ui-type="Select"></ol>
3 通用
DOCTYPE
[强制] 使用 HTML5 的 doctype 来启用标准模式,建议使用大写的 DOCTYPE。
示例:
<!DOCTYPE html>
[建议] 启用 IE Edge 模式。
示例:
<meta http-equiv="X-UA-Compatible" content="IE=Edge">
[建议] 在 html 标签上设置正确的 lang 属性。
解释:
有助于提高页面的可访问性,如:让语音合成工具确定其所应该采用的发音,令翻译工具确定其翻译语言等。
由于历史原因,有时候不得不继续使用zh-CN。比如中文维基百科,沿用了传统的zh-CN/zh-HK/zh-SG/zh-TW(按照标准应该使用 zh-cmn-Hans-CN、zh-cmn-Hant-HK、zh-cmn-Hans-SG、zh-cmn-Hant-TW)。这时候,合理的软件行为,是将 zh-CN 等转化为 zh-cmn-Hans(即转化为最常见的误用所对应的实际标准写法)。Selectors Level 4已经加入了对BCP 47高级匹配算法的支持,即支持 :lang(*-Hans) 的写法。语言的标签表示法的国际标准是 RFC 4646
示例:
<html lang="zh-CN">
简体中文
<html lang="zh-cmn-Hans">
繁体中文
<html lang="zh-cmn-Hant">
编码
[强制] 页面必须使用精简形式,明确指定字符编码。指定字符编码的 meta 必须是 head 的第一个直接子元素。
解释:
见 HTML5 Charset能用吗 一文。
示例:
<html>
<head>
<meta charset="UTF-8">
......
</head>
<body>
......
</body>
</html>
[建议] HTML 文件使用无 BOM 的 UTF-8 编码。
解释:
UTF-8 编码具有更广泛的适应性。BOM 在使用程序或工具处理文件时可能造成不必要的干扰。
CSS和JavaScript引入
[强制] 引入 CSS 时必须指明 rel="stylesheet"。
示例:
<link rel="stylesheet" href="">
[建议] 引入 CSS 和 JavaScript 时无须指明 type 属性。
解释:
text/css 和 text/javascript 是 type 的默认值。
[建议] 展现定义放置于外部 CSS 中,行为定义放置于外部 JavaScript 中。
解释:
结构-样式-行为的代码分离,对于提高代码的可阅读性和维护性都有好处。