文案的注释方法
采用类似标签闭合的写法,与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>
<!-- /头部 -->
代码本身的注释方法
单行代码的注释也保持同行,两端空格;多行代码的注释起始和结尾都另起一行并左缩进对齐。
<!-- <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>
-->
严格的嵌套
- 尽可能以最严格的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 |
下标 | * | * | |
上标 | * | * | |
<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 | * |
网友评论