HTML规范 - 整体结构

HTML基础设施

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

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

<!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写成单行。
  • 你也可以在大的模块之间用空行隔开，使模块更清晰。

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

<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注释统一格式。

  • 开始注释：<!-- 注释文案 -->（文案两头空格）。
  • 结束注释：<!-- /注释文案 -->（文案前加“/”符号，类似标签的闭合）。
  • 允许只有开始注释！

1

2

3

4

5

6

7

8

9

10

11

12

13

14

<!-- 头部 -->

<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>

<!-- /头部 -->

代码本身的注释方法

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

1

2

3

4

5

6

7

<!-- <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>

-->

HTML注释在IE6中的BUG

  • 如果两个浮动元素之间存在注释，那么可能导致布局错位或文字的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等无语义标签。

1

2

3

4

5

6

7

8

9

10

11

12

13

14

<!-- 根节点 -->

<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和他的父元素或子元素上。

1

2

3

<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！！！

1

2

3

4

5

6

7

8

9

10

11

<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即可。

1

2

3

4

5

<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框架 来创建邮件内容。

NEC html规范的更多相关文章

  1. NEC 工程师规范

    工程师规范 - 开发准备 了解产品和设计 参加需求.交互.视觉会议,了解产品设计和项目成员. 了解产品面向的设备和平台. 了解产品对兼容性的要求以及是否采用响应式设计等. 了解产品要使用的技术(WEB ...

  2. NEC css规范

    CSS规范 - 分类方法 SS文件的分类和引用顺序 通常,一个项目我们只引用一个CSS,但是对于较大的项目,我们需要把CSS文件进行分类. 我们按照CSS的性质和用途,将CSS文件分成“公共型样式”. ...

  3. NEC 框架规范 template media

    <!DOCTYPE html><html><head><meta charset="utf-8"/><title>NEC ...

  4. NEC 框架规范 animation

    /* animation *//* 淡入 */.a-fadein{-webkit-animation-name:fadein;-moz-animation-name:fadein;-ms-animat ...

  5. NEC 框架规范 css function

    /* function */.f-cb:after,.f-cbli li:after{display:block;clear:both;visibility:hidden;height:0;overf ...

  6. NEC 框架规范 css reset

    /* reset */html,body,h1,h2,h3,h4,h5,h6,div,dl,dt,dd,ul,ol,li,p,blockquote,pre,hr,figure,table,captio ...

  7. CSS的编写规范

    一.前言 如上图,页面在渲染和画图时,耗时还是比较多的,这就对我们的编写要求愈加严格. 我们有很多方法来减少上图所示的页面加载耗时的,比如 但是更多的还是在于平时的编写规范,我们需要了解浏览器,让他更 ...

  8. 前端开发工程师 - 04.页面架构 - CSS Reset & 布局解决方案 & 响应式 & 页面优化 &规范与模块化

    04.页面架构 第1章--CSS Reset 第2章--布局解决方案 居中布局 课堂交流区 水平列表的底部对齐 如图所示,一个水平排列的列表,每项高度都未知,但要求底部对齐,有哪些方法可以解决呢? & ...

  9. stc89c52开发板遥控器解码 红外线发射 内置 eeprom 存储 串口显示编码

    单片机,大概三年前,就买了一本 <爱上单片机> 最后就学会,用面包板了,编程书上基本没讲. 看原理图,看时序图,看数据手册, 都没讲. 而且书上自带的代码写的很烂. 1,缩近控制不好 2, ...

随机推荐

  1. Android界面编程--使用活动条（ActionBar）--添加Action View

    ActionBar除了显示Action Item 外,还能显示普通的ui组件 2种方式添加Action View 1.指定ActionView的实现类 2.指定ActionView对应的视图资源 实现 ...

  2. node.js发邮件

    在node上使用第三方类库(nodemailer)发邮件是一件很esay的事情:) app.js   以QQ邮箱为例 var nodemailer = require('nodemailer'); v ...

  3. python学习（六）--正则的一些例子

    import re #正则表达式#compile函数,--将正则表达式转变为内部函数,提高执行效率strr = "python123456"pattern = "Pyth ...

  4. java程序: 从kernel.ubuntu.com下载kernel - HttpURLConnection

    用java实现从kernel.ubuntu.com下载内核的小工具 现在的最新的LTS版本是4.19,目前已经更新到4.19.13了. Kernel的更新通知里,经常有下面的陈述: 作为一个听劝的人, ...

  5. python的if语句

    1.条件测试 (1)概念: 每条if语句的核心都是一个值为True或False的表达式,这种表达式被称为条件测试.Python 根据条件测试的值为True还是False来决定是否执行if语句中的代码. ...

  6. 清除canvas画布内容--点擦除+线擦除

    清空canvas画布内容 1.重置宽或高 由于canvas每当高度或宽度被重设时,画布内容就会被清空,因此可以用以下方法清空:(此方法仅限需要清除全部内容的情况) var c=document.get ...

  7. 移动Web布局

    移动Web开发之移动页面布局 前言 本文针对手机设备设计的页面,并非兼容全设备的响应式布局,常见的MobileWeb页面如H5页面.手机页面.WAP页.webview页面等等.在不同尺寸的手机设备上, ...

  8. js实现螺旋纹理特效

    效果如下       实现代码如下: <!doctype html> <html> <head> <meta charset="UTF-8" ...

  9. DevExpress控件水印文字提示 z

    ButtonEdit.Properties.NullValuePrompt = "提示"; ButtonEdit.Properties.NullValuePromptShowFor ...

  10. ubuntu16.4 修改菜单到下方 错误：GLib-GIO-Message: Using the 'memory' GSettings backend. Your settings will not be saved or shared with other applications.

    1.修改命令 #在终端输入 gsettings set com.canonical.Unity.Launcher launcher-position Bottom 2.如果遇错 GLib-GIO-Me ...