动力节点首页 全国咨询热线:400-8080-105

绑定手机号,登录
手机号

验证码

微信登录
手机号登录
手机号

验证码

微信登录与注册
微信扫码登录与注册

扫码关注微信公众号完成登录与注册
手机号登录
首页 > 文章

一文学会HTML编码规范

04-23 15:20 535浏览
举报 T字号
  • 大字
  • 中字
  • 小字

HTML作为描述网页结构的超文本标记语言,在百度一直有着广泛的应用。我们学习的目标是使HTML代码风格保持一致,容易被理解和被维护。下面我们一起来学习HTML编码规范:

1.标签名必须使用小写

示例:

<!-- good --><p>Hello StyleGuide!</p>
<!-- bad --><P>Hello StyleGuide!</P>

2.对于无需自闭合的标签,必须闭合

常见无需自闭合标签有input、br、img、hr等。 示例:

<!-- good --><input type="text" name="title" />
<!-- bad --><input type="text" name="title">

3.HTML 标签的使用应该遵循标签的语义

  • p - 段落
  • h1,h2,h3,h4,h5,h6 - 层级标题
  • strong,em - 强调
  • ins - 插入
  • del - 删除
  • abbr - 缩写
  • code - 代码标识
  • cite - 引述来源作品的标题
  • q - 引用
  • blockquote - 一段或长篇引用
  • ul - 无序列表
  • ol - 有序列表
  • dl,dt,dd - 定义列表

示例:

<!-- good --><p>Esprima serves as an important <strong>building block</strong> for some JavaScript language tools.</p>
<!-- bad --><div>Esprima serves as an important <span class="strong">building block</span> for some JavaScript language tools.</div>

4.标签的使用应尽量简洁,减少不必要的标签

示例:

<!-- good --><img class="avatar" src="image.png">
<!-- bad --><span class="avatar">
    <img src="image.png"></span>

5.属性名必须使用小写字母

示例:

<!-- good --><table cellspacing="0">...</table>
<!-- bad --><table cellSpacing="0">...</table>

6.布尔类型的属性,建议不添加属性值

示例:

<input type="text" disabled><input type="checkbox" value="1" checked>

7.自定义属性建议以 xxx- 为前缀,推荐使用 data-

示例:

<ol data-ui-type="Select"></ol>复制代码

8.DOCTYPE

[强制] 使用 HTML5 的 doctype 来启用标准模式,建议使用大写的 DOCTYPE。 示例:

<!DOCTYPE html>
启用viewport模式
<meta name="viewport" content="width=device-width, initial-scale=1">
启用最新渲染模式
<meta http-equiv="X-UA-Compatible" content="chrome=1,IE=edge">

9.编码

HTML文件使用无 BOM 的 UTF-8 编码

10.CSS和JavaScript引入

[强制] 引入 CSS 时必须指明 rel="stylesheet" 引入 CSS 和 JavaScript 时无须指明 type 属性 解释:

text/css 和 text/javascript 是 type 的默认值。

在 head 中引入页面需要的所有 CSS 资源。 JavaScript 应当放在页面末尾,或采用异步加载 解释:

将 script 放在页面中间将阻断页面的渲染。出于性能方面的考虑,如非必要,请遵守此条建议。

示例:

<body>
    <!-- a lot of elements -->
    <script src="init-behavior.js"></script></body>

11. head

[强制] 页面必须包含 title 标签声明标题 [强制] title 必须作为 head 的直接子元素,并紧随 charset 声明之后 解释:

title 中如果包含 ascii 之外的字符,浏览器需要知道字符编码类型才能进行解码,否则可能导致乱码。

示例:

<head>
    <meta charset="UTF-8">
<title>页面标题</title></head>

12.favicon

[强制] 保证 favicon 可访问。

解释:

在未指定 favicon 时,大多数浏览器会请求 Web Server 根目录下的 favicon.ico 。为了保证favicon可访问,避免404,必须遵循以下两种方法之一:

在 Web Server 根目录放置 favicon.ico 文件。

使用 link 指定 favicon。

示例:

<link rel="shortcut icon" href="path/to/favicon.ico">

13.图片

[强制] 禁止 img 的 src 取值为空。延迟加载的图片也要增加默认的 src。

解释:

src 取值为空,会导致部分浏览器重新加载一次当前页面,参考:https://developer.yahoo.com/performance/rules.html#emptysrc

[建议] 避免为 img 添加不必要的 title 属性。

解释:

多余的 title 影响看图体验,并且增加了页面尺寸。

[建议] 为重要图片添加 alt 属性。

解释:

可以提高图片加载失败时的用户体验。

[建议] 添加 width 和 height 属性,以避免页面抖动。

[建议] 有下载需求的图片采用 img 标签实现,无下载需求的图片采用 CSS 背景图实现。

解释:

产品 logo、用户头像、用户产生的图片等有潜在下载需求的图片,以 img 形式实现,能方便用户下载。

无下载需求的图片,比如:icon、背景、代码使用的图片等,尽可能采用 css 背景图实现。

14 .表单

[强制] 有文本标题的控件必须使用 label 标签将其与其标题相关联 解释:

有两种方式:

将控件置于 label 内。

label 的 for 属性指向控件的 id。 推荐使用第一种,减少不必要的 id。如果 DOM 结构不允许直接嵌套,则应使用第二种。

示例:

<label><input type="checkbox" name="confirm" value="on"> 我已确认上述条款</label>
<label for="username">用户名:</label> <input type="textbox" name="username" id="username">

[强制] 使用 button 元素时必须指明 type 属性值。

解释:

button 元素的默认 type 为 submit,如果被置于 form 元素中,点击后将导致表单提交。为显示区分其作用方便理解,必须给出 type 属性。

示例:

<button type="submit">提交</button><button type="button">取消</button>

15.模板中的 HTML

[建议] 模板代码的缩进优先保证 HTML 代码的缩进规则

示例:

<!-- good -->
{if $display == true}<div>
    <ul>
    {foreach $item_list as $item}
        <li>{$item.name}<li>
    {/foreach}
    </ul></div>
{/if}
<!-- bad -->
{if $display == true}
    <div>
        <ul>
    {foreach $item_list as $item}
        <li>{$item.name}<li>
    {/foreach}
        </ul>
    </div>
{/if}

HTML编码规范我们还是十分有必要遵守的,除了能够使我们的HTML代码更加规范简洁,也能够减少我们的编程bug,给我们带来实质性的好处。

0人推荐
共同学习,写下你的评论
0条评论
代码小兵696
程序员代码小兵696

118篇文章贡献392976字

相关课程 更多>

作者相关文章更多>

推荐相关文章更多>

JavaWeb的3大组件

代码小兵49806-11 15:28

全面解析Cookie技术

代码小兵49806-11 15:51

浅谈JavaWeb架构演变

代码小兵49806-11 16:22

探讨Web开发中的Session存储与管理

代码小兵51603-29 17:28

JavaScript基础知识

 暴风城-小飞04-06 20:49

发评论

举报

0/150

取消