HTML和CSS编码规范内容

一、HTML规范

二、CSS规范

三、注意事项：

四、常用的命名规则

五、CSS样式表文件命名

六、文件命名规则

一、HTML规范：

1.代码规范

页面的第一行添加标准模式声明 <!DOCTYPE html>
代码缩进：tab键设置四个空格（通常在软件右下角设置相应空格大小）
html中除了开头的DOC和 'UTF-8'或者head里特殊情况可以大写外，其他都为小写，css类都为小写
建议为 html 根元素指定 lang 属性，从而为文档设置正确的语言 lang="zh-CN"
不同doctype在不同浏览器下会触发不同的渲染模式 <meta http-equiv="X-UA-Compatible" content="IE=Edge">
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=Edge">
</head>
....
</html>
不要使用@import 
与 <link> 标签相比，@import 指令要慢很多，不光增加了额外的请求次数，还会导致不可预料的问题。替代办法有以下几种：
使用多个 <link> 元素
通过 Sass 或 Less 类似的 CSS 预处理器将多个 CSS 文件编译为一个文件
通过 Rails、Jekyll 或其他系统中提供过 CSS 文件合并功能
<!-- Use link elements -->
<link rel="stylesheet" href="core.css">
 
<!-- Avoid @imports -->
<style>
@import url("more.css");
</style>
 
引入 CSS 和 JavaScript 文件
根据HTML5规范, 通常在引入CSS和JS时不需要指明 type，因为 text/css 和 text/javascript 分别是他们的默认值
<!-- External CSS -->
<link rel="stylesheet" href="code-guide.css">
 
<!-- In-document CSS -->
<style>
/* ... */
</style>
 
<!-- JavaScript -->
<script src="code-guide.js"></script>
 

2.注释

<!--注释内容--!>
注意：--后不要留空格，若留空格，其他注释全加空格（方便后续程序开发）换句话说，注释要全局统一
eg:
<!-- Better --!>
<!--S 注释内容--!>
为书写规范，最好每一个需要注释都需要开头和结尾，减少后续麻烦和错误。不要换行。CSS、JS注释亦然。 <!--E 注释内容--!>
<!-- No so great --!>
<!--
S 注释内容
--!>
为书写规范，最好每一个需要注释都需要开头和结尾，减少后续麻烦和错误。不要换行。CSS、JS注释亦然。 <!--
E 注释内容--
!>

3.命名规范

class用 “-” ；ID用 “_” ；name:data-自定义名；
根据内容书写语义化编码：可用以项目名简写开头-语义化名称
eg: class="tb-head"; id="tb_head"; data-head="tb-head";

4.属性排序

（方便后台程序员整理代码)
1、根据属性定义排序 : class,id,name排序 （建议用此方法）
(class用于标识高度可复用组件，因此排首位，id用于标识具体组件，慎用，因此排第二位)
class [强制]class用中划线 ' - ' 区分
id, name [强制]ID用下划线 ' _ ' 区分
data-*
src, for, type, href
title, alt
aria-*, role
eg:
<a class="..." id="..." data-modal="toggle" href="#">
Example link
</a>
 
<input class="form-control" type="text">
 
<img src="..." alt="...">
 
2、特殊属性可根据元素跟随排序，后根据（1）方法排序
eg:
<a href="#" class="..." id="..."</a>
Example link
</a>
 
<input type="text" class="...">
3、根据字母开头顺序排序
eg:
<a class="bfl-head" data-head="bfl-head" href="javascript:;" id="bfl_head"></a>
根据自己理解排序。

5.减少标签量

<!-- Not so great -->
<span class="avatar">
<img src="...">
</span>
 
<!-- Better -->
<img class="avatar" src="...">

6.布尔型属性

布尔型属性可以在声明时不赋值。XHTML 规范要求为其赋值，但是 HTML5 规范不需要。换句话说，不用赋值。
<input type="text" disabled>
 
<input type="checkbox" value="1" checked>
 
<select>
<option value="1" selected>1</option>
</select>
 

二、css规范

1、语法

1.1、缩进
[强制]使用 4 个空格做为一个缩进层级，不允许使用 2 个空格 或 tab 字符。

1.2、空格

[强制]为了代码易读性，每个声明块的左花括号前添加一个空格
[强制]每条声明语句的" : "后应该插一个空格
[强制]属性多值每个逗号后应该插入空格 eg:box-shadow,border-image
[强制]不要在rgb()、rgba()、hsl()、hsla() 或 rect() 值的内部的逗号后面插入空格
对于属性值或颜色参数，省略小于 1 的小数前面的 0 （例如，.5 代替 0.5；-.5px 代,替 -0.5px）

1.3、选择器

[强制]为选择器分组时，将单独的选择器单独存放在一行 eg:tr,td{}
[强制] >、+、~ 选择器的两边各保留一个空格。
[强制]为选择器中的属性添加双引号 不允许单引号
例如，input[type="text"]。只有在某些情况下是可选的，但是，为了代码的一致性，建议都加上双引号。
[强制] 如无必要，不得为 id、class 选择器添加类型选择器进行限定。
[建议] 选择器的嵌套层级应不大于 3 级，位置靠后的限定条件应尽可能精确。
eg:
/* good */
#error,
.danger-message {
font-color: #c00;
}
#username input {}
.comment .avatar {}
 
/* bad */
dialog#error,
p.danger-message {
font-color: #c00;
}
.page .header .login #username input {}
.comment div * {}

1.4、行

[强制]每行不得超过 120 个字符，除非单行不可分割。
[强制]声明块右花括号应当成行
[建议] 对于超长的样式，在样式值的 空格 处或 , 后换行，建议按逻辑分组。
eg:background:url(....) 此处应有换行 no-repeat;

1.5、属性

[强制] 属性定义必须另起一行。
[强制] 属性定义后必须以分号结尾。
即每条声明应单独成行，以分号结尾
[建议] 在可以使用缩写的情况下，尽量使用属性缩写。
eg:font: 12px/1.5 arial, sans-serif;

1.6、前缀

[强制] 带私有前缀的属性由长到短排列，按冒号位置对齐。
[建议] 可以给选择器添加一个表示状态的前缀，让语义更明了，比如下图是添加了“.is-”前缀。

1.7、简写

十六进制值应该全部小写,尽可能简写 eg:#fff
.避免为 0 值指定单位
例如，用 margin: 0; 代替 margin: 0px;
/* Bad CSS */
main>nav {
padding: 10px;
}
.selector, .selector-secondary, .selector[type=text] {
 
padding:15px;
margin:0px 0px 15px;
background-color:rgba(0, 0, 0, 0.5);
box-shadow:0px 1px 2px #CCC,inset 0 1px 0 #FFFFFF
}
.selector, .selector-secondary, .selector[type=text] {padding:15px;margin:0px 0px 15px;}
 
/* Good CSS */
main > nav {
padding: 10px;
}
.selector,
.selector-secondary,
.selector[type="text"] {
padding: 15px;
margin-bottom: 15px;
background-color: rgba(0,0,0,.5);
background:
transparent url(aVeryVeryVeryLongUrlIsPlacedHere)
no-repeat 0 0;
box-shadow: 0 1px 2px #ccc, inset 0 1px 0 #fff;
}
 

2.注释

/* 注释内容 */
注意：*后不要留空格，若留空格，其他注释全加空格（方便后续程序开发）换句话说，注释要全局统一
eg: /* S 注释内容 */
为书写规范，最好每一个需要注释都需要开头和结尾，减少后续麻烦和错误。不要翻行。CSS、JS注释亦然。
/* E 注释内容 */
 

3.命名规范

1.应用 英文缩写命名法，杜绝用中文拼音或者中文拼音缩写（这是因为英文具有简易性，必要时可上网搜索国际缩写英文）
2. 只能出现小写字符或者中划线（破折号符），不用下划线，驼峰命名法。
eg: .btn 或者 .btn-danger
3.避免过度任意的简写。.btn 代表 button，但是 .s 不能表达任何意思
4.class 名称应当尽可能短，并且意义明确。
使用有意义的名称。使用有组织的或目的明确的名称，不要使用表现形式（presentational）的名称。
基于最近的父 class 或基本（base） class 作为新 class 的前缀。
使用 .js-* class 来标识行为（与样式相对），并且不要将这些 class 包含到 CSS 文件中。
在为 Sass 和 Less 变量命名是也可以参考上面列出的各项规范。
/* Bad example */
.t { ... }
.red { ... }
.header { ... }
 
/* Good example */
.tweet { ... }
.important { ... }
.tweet-header { ... }
 

4.选择器

对于通用元素使用 class ，这样利于渲染性能的优化。
对于经常出现的组件，避免使用属性选择器（例如，[class="..."]）。浏览器的性能会受到这些因素的影响。
选择器要尽可能短，并且尽量限制组成选择器的元素个数，建议不要超过 3 。
只有在必要的时候才将 class 限制在最近的父元素内（也就是后代选择器）（例如，不使用带前缀的 class 时 -- 前缀类似于命名空间）。
/* Bad example */
span { ... }
.page-container #stream .stream-item .tweet .tweet-header .username { ... }
.avatar { ... }
 
/* Good example */
.avatar { ... }
.tweet-header .username { ... } //不要超过3个
.tweet .avatar { ... }

5.声明顺序

5.1. 相关的属性声明应当归为一组，并按照下面的顺序排列：
* Positioning
* Box model
* Typographic
* Visual
由于定位（positioning）可以从正常的文档流中移除元素，并且还能覆盖盒模型（box model）相关的样式，因此排在首位。盒模型排在第二位，因为它决定了组件的尺寸和位置。
其他属性只是影响组件的内部（inside）或者是不影响前两组属性，因此排在后面。 eg:
.declaration-order {
/* Positioning */
position: absolute;
top: 0;
right: 0;
bottom: 0;
left: 0;
z-index: 100;
 
/* Box-model */ display: block;
float: right;
width: 100px;
height: 100px;
 
/* Typography */
font: normal 13px "Helvetica Neue", sans-serif;
line-height: 1.5;
color: #333;
text-align: center;
 
/* Visual */
background-color: #f5f5f5;
border: 1px solid #e5e5e5;
border-radius: 3px;
 
/* Misc */
opacity: 1;
}

5.2.设置盒子模型 - 是否脱离标准（子絶父相）- 其他属性

注意兼容性写法（纯属个人习惯）
盒子模型
1.设置是否需要浮动元素 或者 转块(float,display)
2.设置盒子边框、背景颜色、字体颜色（border,background，font,color）
3.设置宽高大小（width,height）
4.文字垂直居中（line-hight,text-align,vertical-align等等）
5.设置margin、padding值
标准流（子絶父相）
position ：relative、absolute、static、fixed
left/top/right/bottom
z-index
其他属性
opcaity、cursor等
css3新属性
transition、transform、animation等
每个范围可由首字母开头为排序：
eg:盒子模型中的第2条中，可由background,border,color等首字母为先排序; 但有些例外，如position肯定排先，后定义left等方向位属性
ps:需要用到媒体查询，将媒体查询放在尽可能相关规则的附近
eg:
.declaration-order {
display: block;
float: right;
background-color: #f5f5f5;
border: 1px solid #e5e5e5;
border-radius: 3px;
color: #333;
font: normal 13px "Helvetica Neue", sans-serif;
 
width: 100px;
height: 100px;
text-align: center;
line-height: 100px;
 
margin: 0 auto;
padding: 10px 0;
 
position: absolute;
top: 0;
right: 0;
bottom: 0;
left: 0;
z-index: 100;
opacity: 1;
 
transtion: all .5s ease 0s;
animation: name initial 2s;
}
@keyframes name{
0%{}
100{}
///
from{}
to{}
}
@media screen and (min-width) and (max-width){
and左右之间要留空格
}

5.3.按照首字母排列顺序编写

 

注意事项：

1. 尽量不使用 !important 声明。

[建议] 当需要强制指定样式且不允许任何场景覆盖时，通过标签内联和 !important 定义样式。

2.媒体查询（Media query）的位置

将媒体查询放在尽可能相关规则的附近。不要将他们打包放在一个单一样式文件中或者放在文档底部。如果你把他们分开了，将来只会被大家遗忘。

3.带前缀的属性

当使用特定厂商的带有前缀的属性时，通过缩进的方式，让每个属性的值在垂直方向对齐，这样便于多行编辑。
在 Textmate 中，使用 Text → Edit Each Line in Selection (⌃⌘A)。在 Sublime Text 2 中，使用 Selection → Add Previous Line (⌃⇧↑) 和 Selection → Add Next Line (⌃⇧↓)。
Prefixed properties */ lector { webkit-box-shadow: 0 1px 2px rgba(0,0,0,.15); box-shadow: 0 1px 2px rgba(0,0,0,.15);

4.单行规则声明

对于只包含一条声明的样式，为了易读性和便于快速编辑，建议将语句放在同一行 (能仔细分析，检测错误)

5.简写形式的属性声明

在需要显示地设置所有值的情况下，应当尽量限制使用简写形式的属性声明。常见的滥用简写属性声明的情况如下：
padding
margin
font
background
border
border-radius
/* Bad example */
.element {
margin: 0 0 10px;
background: red;
background: url("image.jpg");
border-radius: 3px 3px 0 0;
}
 
/* Good example */
.element {
margin-bottom: 10px;
background-color: red;
background-image: url("image.jpg");
border-top-left-radius: 3px;
border-top-right-radius: 3px;
}

6.Less 和 Sass 中的嵌套

避免非必要的嵌套。这是因为虽然你可以使用嵌套，但是并不意味着应该使用嵌套。只有在必须将样式限制在父元素内（也就是后代选择器），并且存在多个需要嵌套的元素时才使用嵌套。
// Without nesting
.table > thead > tr > th { … }
.table > thead > tr > td { … }
 
// With nesting
.table > thead > tr {
> th { … }
> td { … }
}
了解更多请点击，本文更多参照此文章

常用的命名规则

class的命名

用中划线 ' - '

头：header
内容：content/container
尾：footer
导航：nav
侧栏：sidebar
栏目：column
页面外围控制整体佈局宽度：wrapper
左右中：left right center
登录条：loginbar
标志：logo
广告：banner
页面主体：main
热点：hot
新闻：news
下载：download
子导航：subnav
菜单：menu
子菜单：submenu
搜索：search
友情链接：friendlink
页脚：footer
版权：copyright
滚动：scroll
内容：content
标签：tags
文章列表：list
提示信息：msg
小技巧：tips
栏目标题：title
加入：joinus
指南：guide
服务：service
注册：regsiter
状态：status
投票：vote
合作伙伴：partner

Id的命名:

用下划线 ' _ '

1)页面结构
容器: container 页头：header 内容：content/container 页面主体：main 页尾：footer 导航：nav 侧栏：sidebar 栏目：column 页面外围控制整体佈局宽度：wrapper 左右中：left right center
(2)导航
导航：nav 主导航：mainnav 子导航：subnav 顶导航：topnav 边导航：sidebar 左导航：leftsidebar 右导航：rightsidebar 菜单：menu 子菜单：submenu 标题: title 摘要: summary
(3)功能
标志：logo 广告：banner 登陆：login 登录条：loginbar 注册：register 搜索：search 功能区：shop 标题：title 加入：joinus 状态：status 按钮：btn 滚动：scroll 标籤页：tab 文章列表：list 提示信息：msg 当前的: current 小技巧：tips 图标: icon 注释：note 指南：guild 服务：service 热点：hot 新闻：news 下载：download 投票：vote 合作伙伴：partner 友情链接：link 版权：copyright

CSS样式表文件命名

主要的 master.css
模块 module.css
基本共用 base.css
布局、版面 layout.css
主题 themes.css
专栏 columns.css
文字 font.css
表单 forms.css
补丁 mend.css
打印 print.css

文件命名规则

项目命名 全部采用小写方式，以下划线分隔 例：my_project_name 目录命名
参照项目命名规则；
有复数结构时，要采用复数命名法。
例：scripts, styles, images, data_models JS文件命名
参照项目命名规则。
例：account_model.js CSS, SCSS文件命名
参照项目命名规则。
例：retina_sprites.scss HTML文件命名
参照项目命名规则。
例：error_report.html
 
鸣谢：小码农雯

HTML编写规范的更多相关文章

  1. 20151009 C# 第一篇 程序编写规范

    20151009 程序编写规范 1. 代码书写规则: 1).尽量使用接口,然后使用类实现接口. 2).关键语句写注释 3).避免写超过5个参数的方法,如果要传递多个参数,则使用结构 4).避免代码量过 ...

  2. .NET代码编写规范 整理

    .NET代码编写规范 整理 .NET代码编写规范 - [ASP.NET] 2009-02-26 | Tag: 版权声明:转载时请以超链接形式标明文章原始出处和作者信息及本声明 http://lensp ...

  3. MarkDown编写规范指南

    Markdown 编写规范指南 简介: Markdown的目标是实现「易读易写」,成为一种适用于网络的「书写语言」. 一份使用Markdown格式撰写的文件可以直接以纯文本发布,它的最大灵感来源其实是 ...

  4. 代码编写规范说明书（c#.net与asp.net）

    代码编写规范说明书(c#.net与asp.net) 目 录1 目的2 范围3 注释规范3.1 概述3.2 自建代码文件注释3.3 模块(类)注释3.4 类属性注释3.5 方法注释3.6 代码间注释4 ...

  5. Markdown 编写规范

    说明及目的 作为一个在博客园混迹了俩三年的人,一直在这里看别人的博客,现在准备开始写自己的博客,目的呢,就是一下几点吧: 项目过程中的历史经验教训积累记载,吃一堑长一智,不想在同一个坑掉进去好几次 学 ...

  6. Python代码编写规范

    Python代码编写规范 编码: a)     如无特殊情况,文件一律使用UTF-8编码 b)     如无需特殊情况,文件头部必须加入#-*-coding:utf-8-*- 缩进 a)     统一 ...

  7. 【转】python编写规范——中标软件有限公司测试中心

    [转]python编写规范 一.说明 二.内容 1. 代码布局 1.1 缩进 1.2 表达式和语句中的空格 1.3 行的最大长度 1.4 空行... 1.5 编码... 2. 语句... 2.1 标准 ...

  8. 内核知识第六讲,内核编写规范,以及获取GDT表

    内核知识第六讲,内核编写规范,以及获取GDT表 一丶内核驱动编写规范 我们都知道,在ring3下,如果我们的程序出错了.那么就崩溃了.但是在ring0下,只要我们的程序崩溃了.那么直接就蓝屏了. 那么 ...

  9. 个人css编写规范

    前言:最近在做微信小程序,因为公司小,就我一个人弄前端的东西,js和页面都是我来弄,结果那天后台的人看到我的js代码,说我的代码写得不规范,函数什么的都很乱,弄得我羞愧难当,幸亏没看我的css,其实我 ...

  10. 接口测试Case之面向页面对象编写规范

    一.什么是页面对象化 主要提倡的思想是:万物皆对象,即把一个Page看成一个对象,来进行接口自动化Case的编写,不要闲扯,直接讲怎么个操作法呢? 二.有什么优势? 2.1 Case层次清晰,便于管理 ...

随机推荐

  1. LA 3523 圆桌骑士（二分图染色+点双连通分量）

    https://vjudge.net/problem/UVALive-3523 题意: 有n个骑士经常举行圆桌会议,商讨大事.每次圆桌会议至少应有3个骑士参加,且相互憎恨的骑士不能坐在圆桌旁的相邻位置 ...

  2. Gogeos安装

    环境要求: Windows64,Go,minGW(统一64位) 1.安装geos 下载GEOS 3.3.8源码,解压后,按readme文件编译(基于VS2010的64位编译工具执行的nmake编译命令 ...

  3. 查看linux 之mysql 是否安装的几种方法

    转自:https://jingyan.baidu.com/album/86112f1378bf282737978730.html?picindex=2 linux下怎么启动mysql服务 https: ...

  4. webpack入门配置

    webpack入门配置 根据该篇文章进行配置: 入门 Webpack,看这篇就够了 其中由于版本更新的问题会出现几个问题: 1.Would you like to install webpack-cl ...

  5. 定时模块app_timer用法及常见问题—nRF5 SDK模块系列二

    app_timer是大家经常用到的一个库,app_timer的功能就是定时,也就是说,你在某一时刻启动一个app timer并设定超时时间,超时时间一到,app_timer就会回调timeout ha ...

  6. xshell5使用ssh连接阿里云服务器

    这里有两种方式,一种是在阿里云的控制台里面进行,另一种是在Xshell里面生成密钥. 阿里云控制台密钥对 点击右上方的创建密钥对 在阿里云里面生成较为简单,点击该页面右上方的“创建密钥对”,在另一个页 ...

  7. ContentControl和ContentPresenter的应用

    1:wpf中,所有的内容控件都继承自“ContentControl” ,所以我们可以直接应用“ContentControl”自定义我们“需要的”内容控件. 2:ContentControl具有Cont ...

  8. linux禁止ping

    1.临时禁止PING操作的命令为:#echo 1>/proc/sys/net/ipv4/icmp_echo_ignore_all 2.永久禁止PING配置方法 /etc/sysctl.conf  ...

  9. msdia80.dll文件出现在磁盘根目录下的解决方案（转）

    情况描述: 当安装某些软件后,磁盘根目录中多出了msdia80.dll文件,该文件显示为2006年12月1日,884KB. 原因:   当使用64位操作系统时,在电脑上安装 Microsoft Vis ...

  10. uva 12086 线段树or树状数组练习

    题目链接   https://vjudge.net/problem/34215/origin 这个题就是线段树裸题,有两种操作,实现单点更新和区间和的查找即可,这里第一次学习使用树状数组完成. 二者相 ...