NEC html规范

HTML规范 - 整体结构

HTML基础设施

  • 文件应以“<!DOCTYPE ......>”首行顶格开始,推荐使用“<!DOCTYPE html>”。
  • 必须申明文档的编码charset,且与文件本身编码保持一致,推荐使用UTF-8编码<meta charset="utf-8"/>。
  • 根据页面内容和需求填写适当的keywords和description。
  • 页面title是极为重要的不可缺少的一项。
<!DOCTYPE html>

<html>

<head>

<meta charset="utf-8"/>

<title>NEC:更好的CSS方案</title>

<meta name="keywords" content=""/>

<meta name="description" content=""/>

<meta name="viewport" content="width=device-width"/>

<link rel="stylesheet" href="css/style.css"/>

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

<link rel="apple-touch-icon" href="img/touchicon.png"/>

</head>

<body>

</body>

</html>

结构顺序和视觉顺序基本保持一致

  • 按照从上至下、从左到右的视觉顺序书写HTML结构。
  • 有时候为了便于搜索引擎抓取,我们也会将重要内容在HTML结构顺序上提前。
  • 用div代替table布局,可以使HTML更具灵活性,也方便利用CSS控制。
  • table不建议用于布局,但表现具有明显表格形式的数据,table还是首选。

结构、表现、行为三者分离,避免内联

  • 使用link将css文件引入,并置于head中。
  • 使用script将js文件引入,并置于body底部。

保持良好的简洁的树形结构

  • 每一个块级元素都另起一行,每一行都使用Tab缩进对齐(head和body的子元素不需要缩进)。删除冗余的行尾的空格。
  • 使用4个空格代替1个Tab(大多数编辑器中可设置)。
  • 对于内容较为简单的表格,建议将tr写成单行。
  • 你也可以在大的模块之间用空行隔开,使模块更清晰。
<body>

<!-- 侧栏内容区 -->

<div class="m-side">

    <div class="side">

        <div class="sidein">

            <!-- 热门标签 -->

            <div class="sideblk">

                <div class="m-hd3"><h3 class="tit">热门标签</h3> </div>

                ...

            </div>

  

            <!-- 最热TOP5 -->

            <div class="sideblk">

                <div class="m-hd3"><h3 class="tit">最热TOP5</h3> <a href="#" class="s-fc02 f-fr">更多»</a></div>

                ...

            </div>

        </div>

    </div>

</div>

<!-- /侧栏内容区 -->

</body>

另外,请做到以下几点

  • 结构上如果可以并列书写,就不要嵌套。

如果可以写成<div></div><div></div>那么就不要写成<div><div></div></div>

  • 如果结构已经可以满足视觉和语义的要求,那么就不要有额外的冗余的结构。

比如<div><h2></h2></div>已经能满足要求,那么就不要再写成<div><div><h2></h2></div></div>

  • 一个标签上引用的className不要过多,越少越好。

比如不要出现这种情况:<div class="class1 class2 class3 class4"></div>

  • 对于一个语义化的内部标签,应尽量避免使用className。

比如在这样一个列表中,li标签中的itm应去除:<ul class="m-help"><li class="itm"></li><li class="itm"></li></ul>

HTML规范 - 代码格式

说明文案的注释方法

采用类似标签闭合的写法,与HTML统一格式;注释文案两头空格,与CSS注释统一格式。

  • 开始注释:<!-- 注释文案 -->(文案两头空格)。
  • 结束注释:<!-- /注释文案 -->(文案前加“/”符号,类似标签的闭合)。
  • 允许只有开始注释!
<!-- 头部 -->

<div class="g-hd">

    <!-- LOGO -->

    <h1 class="m-logo"><a href="#">LOGO</a></h1>

    <!-- /LOGO -->

    <!-- 导航 -->

    <ul class="m-nav">

        <li><a href="#">NAV1</a></li>

        <li><a href="#">NAV2</a></li>

        <!-- 更多导航项 -->

    </ul>

    <!-- /导航 -->

</div>

<!-- /头部 -->

代码本身的注释方法

单行代码的注释也保持同行,两端空格;多行代码的注释起始和结尾都另起一行并左缩进对齐。

HTML注释在IE6中的BUG

<!-- <h1 class="m-logo"><a href="#">LOGO</a></h1> -->

<!--

<ul class="m-nav">

    <li><a href="#">NAV1</a></li>

    <li><a href="#">NAV2</a></li>

</ul>

-->
  • 如果两个浮动元素之间存在注释,那么可能导致布局错位或文字的BUG。
  • 所以,这种情况下,我们通常将注释去掉,或者索性采用模板语言(ftl、vm)的注释。

严格的嵌套

  • 尽可能以最严格的xhtml strict标准来嵌套,比如内联元素不能包含块级元素等等。
  • 正确闭合标签且必须闭合。

严格的属性

  • 属性和值全部小写,每个属性都必须有一个值,每个值必须加双引号。
  • 没有值的属性必须使用自己的名称做为值(checked、disabled、readonly、selected等等)。
  • 可以省略style标签和script标签的type属性。

常用的标签

常见标签表

标签

语义

嵌套常见错误

常用属性(加粗的为不可缺少的或建议的)

<a></a>

超链接/锚

a不可嵌套a

href,name,title,rel,target

<br />

换行

<button></button>

按钮

不可嵌套表单元素

type,disabled

<dd></dd>

定义列表中的定义(描述内容)

只能以dl为父容器,对应一个dt

<del></del>

文本删除

<div></div>

块级容器

<dl></dl>

定义列表

只能嵌套dt和dd

<dt></dt>

定义列表中的定义术语

只能以dl为父容器,对应多个dd

<em></em>

强调文本

<form></form>

表单

action,target,method,name

<h1></h1>

标题

从h1到h6,不可嵌套块级元素

<iframe></iframe>

内嵌一个网页

frameborder,width,height,src,scrolling,name

<img />

图像

alt,src,width,height

<input />

各种表单控件

type,name,value,checked,disabled,maxlength,readonly,accesskey

<label></label>

标签为input元素定义标注

for

<li></li>

列表项

只能以ul或ol为父容器

<link />

引用样式或icon

不可嵌套任何元素

type,rel,href

<meta />

文档信息

只用于head

content,http-equiv,name

<ol></ol>

有序列表

只能嵌套li

<option></option>

select中的一个选项

仅用于select

value,selected,disabled

<p></p>

段落

不能嵌套块级元素

<script></script>

引用脚本

不可嵌套任何元素

type,src

<select></select>

列表框或下拉框

只能嵌套option或optgroup

name,disabled,multiple

<span></span>

内联容器

<strong></strong>

强调文本

<style></style>

引用样式

不可嵌套任何元素

type,media

<sub></sub>

下标

<sup></sup>

上标

<table></table>

表格

只可嵌套表格元素

width,align,background,cellpadding,cellspacing,summary,border

<tbody></tbody>

表格主体

只用于table

<td></td>

表格中的单元格

只用于tr

colspan,rowspan

<textarea></textarea>

多行文本输入控件

name,accesskey,disabled,readonly,rows,cols

<tfoot></tfoot>

表格表尾

只用于table

<th></th>

表格中的标题单元格

只用于tr

colspan,rowspan

<thead></thead>

表格表头

只用于table

<title></title>

文档标题

只用于head

<tr></tr>

表格行

嵌套于table或thead、tbody、tfoot

<ul></ul>

无序列表

只能嵌套li

HTML规范 - 内容语义

内容类型决定使用的语义标签

在网页中某种类型的内容必定需要某种特定的HTML标签来承载,也就是我们常常提到的根据你的内容语义化HTML结构。

加强“资源型”内容的可访问性和可用性

在资源型的内容上加入描述文案,比如给img添加alt属性,在audio内加入文案和链接等等。

加强“不可见”内容的可访问性

背景图上的文字应该同时写在html中,并使用css使其不可见,有利于搜索引擎抓取你的内容,也可以在css失效的情况下看到内容。

适当使用实体

以实体代替与HTML语法相同的字符,避免浏览解析错误。

HTML规范 - 邮件内容

邮件环境

邮件内容所在上下文或者说所在外部容器(以下简称环境)都是由邮箱服务商决定的,这就要求邮件内容需要在任何一种情况下都要正确显示。

这些环境可能是以下某几种情况:

  • 可能是个iframe,你的内容是被放在body里面的;可能只是个div,你的内容就被放在这个div里面。
  • 可能邮箱自身设置了些css,他可能对你产生未知的影响。
  • 可能根本没有申明doctype,即使申明了,也不是你想要的doctype。

避免被嵌套在不正确的容器里

惑:因为容器可能是body或div,所以,我们邮件内容不应该是一个完整的html。

解:所以邮件内容应该是以div为根节点的html片段。

避免css冲突或被覆盖

惑:因为环境中可能已经设置了css,比如一些reset、一些.class。

解:所以我们只能使用行内style来确保我们的效果,并且在内容根节点上设置基础style,并且尽量使用div、span等无语义标签。

<!-- 根节点 -->

<div style="width:600px;text-align:left;color:#000;font:normal 12px/15px arial,simsun;background:#fff;">

    内容区域

</div>

<!-- 根节点-邮件内容居中 -->

<div style="text-align:center;">

    <div style="width:600px;margin:0 auto;text-align:left;color:#000;font:normal 12px/15px arial,simsun;background:#fff;">

        内容区域

    </div>

</div>

<!-- 如果使用语义化标签,那么需要多写一些style,以避免被环境中的css覆盖 -->

<h2 style="width:100px;height:100px;margin:0;padding:0;fong-weight:normal;font-size:12px;"></h2>

<!-- 而使用无语义标签,就可以省下很多style -->

<div style="width:100px;height:100px;"></div>

避免盒模型错误

惑:因为doctype的不确定性,我们在写style的时候,应该考虑无论doctype是什么情况,都可以正常显示,doctype影响最大的就是盒模型的解析。

解:所以我们要将盒模型拆分开来写,比如我们将原本要定义在某个div上的height和padding分别写到这个div和他的父元素或子元素上。

<div style="height:100px;padding:20px 0;">内容</div>

<!-- 上面的写法应该改成以下写法 -->

<div style="padding:20px 0;"><div style="height:100px;">内容</div></div>

其他注意事项

  • 因为只能使用行内style,所以清除浮动需要使用额外标签。
  • 避免使用绝对定位,可能会被过滤。
  • 避免使用js,可能会被过滤。
  • 避免使用table布局,不易于修改维护。
  • 背景图片或内容图片上的文字信息,必须在代码中可见。
  • 如果没有特殊要求,所有a链接都要从新窗口打开,即target="_blank",且a标签内容不能为空。
  • 所有链接必须设置使用颜色、是否下划线,即style="text-decoration:;color:;"。
  • 重点检查ie!!!
<div style="width:600px;text-align:left;color:#000;font:normal 12px/15px simsun;background:#d9d9d9;">

    <div style="height:268px;background:url(images/bg1.jpg) no-repeat;">

        <div style="height:228px;">

            <div style="padding:21px 0 0 21px;">

                <a href="http://yuedu.163.com/" target="_blank" style="display:block;width:111px;height:28px;overflow:hidden;text-indent:-2000px;text-decoration:none;" title="网易阅读-随时随地品质阅读">网易阅读-随时随地品质阅读</a>

            </div>

            <h2 style="margin:0;padding:0;width:0;height:0;overflow:hidden;text-indent:-2000px;">你的iPad够有料吗?iPad不等于愤怒的小鸟!不等于切水果!下载网易阅读,给你的iPad添点料,打造你独一无二的iPad!</h2>

        </div>

        <div style="padding:0 0 0 35px;"><a href="http://itunes.apple.com/cn/app/id421092396?mt=8" target="_blank" style="color:#f00;text-decoration:none;" title="下载网易阅读">下载网易阅读</a></div>

    </div>

</div>

发现的问题及解决方案

问题:部分智能手机的邮件客户端可能会有只显示部分的bug(宽度被截)。

解决:在外面套一个同宽的table即可。

<table width="600" cellpadding="0" cellspacing="0" border="0"><tr><td>

    <div style="width:600px;text-align:left;color:#000;font:normal 12px/15px simsun;background:#d9d9d9;">

        ......

    </div>

</td></tr></table>

使用框架

推荐使用 email框架 来创建邮件内容。

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏九彩拼盘的叨叨叨

jQuery 最佳实践(译)

原文 http://shichuan.github.io/javascript-patterns/#jquery-patterns

7930
来自专栏nimomeng的自我进阶

View官方文档

16420
来自专栏HTML5学堂

如何优化前端页面 / 如何优化网页

HTML5学堂:如何优化前端页面 / 如何优化网页。作为前端开发人员来说,不但要开发出能兼容各大主流浏览器的页面,而且还需要懂得去优化前端页面。本文主要给大家讲...

47680
来自专栏逸鹏说道

Markdown基础(内含:锚点使用,使用HTML,新页面跳转,目录生成)

如果要语法高亮就在```后面加小写语言名,eg:html,css,javascript,python,cs(csharp)等等

627110
来自专栏王磊的博客

史上最易懂——ReactNative分组列表SectionList使用详情及示例详解

React Native系列 《逻辑性最强的React Native环境搭建与调试》 《ReactNative开发工具有这一篇足矣》 《解决React N...

930140
来自专栏web编程技术分享

HTML&CSS Table元素详细解说

40680
来自专栏大数据钻研

HTML5学习笔记(一)

1.什么是 HTML5? HTML5 将成为 HTML、XHTML 以及 HTML DOM 的新标准。 HTML 的上一个版本诞生于 1999 年。自从那以后,...

39950
来自专栏从零开始学 Web 前端

从零开始学 Web 之 DOM(五)元素的创建

11820
来自专栏更流畅、简洁的软件开发方式

表单控件续(1)——应用接口来简化和分散代码

上次有点仓促,有几个地方没有明确。 后者是整个流程,前者是其中的一个步骤,是一个简单的思路说明,其中前三段代码都是表单控件里面的。 2、我要写的是一个表单控...

20590
来自专栏hightopo

基于 HTML5 的电力接线图 SCADA 应用

16730

扫码关注云+社区

领取腾讯云代金券