音效素材网提供各类素材,打造精品素材网站!

站内导航 站长工具 投稿中心 手机访问

音效素材

HTML代码书写规范指南
日期:2021-09-03 07:59:15   来源:脚本之家

通用约定
标签

自闭合(self-closing)标签,无需闭合 ( 例如: img input br hr 等 );
可选的闭合标签(closing tag),需闭合 ( 例如:</li> 或 </body>);
尽量减少标签数量;

XML/HTML Code复制内容到剪贴板
  1. <img src="images/google.png" alt="Google">  
  2. <input type="text" name="title">  
  3.   
  4. <ul>  
  5.   <li>Style</li>  
  6.   <li>Guide</li>  
  7. </ul>  
  8.   
  9. <!-- Not recommended -->  
  10. <span class="avatar">  
  11.   <img src="...">  
  12. </span>  
  13.   
  14. <!-- Recommended -->  
  15. <img class="avatar" src="...">  

Class 与 ID

class 应以功能或内容命名,不以表现形式命名;
class 与 id 单词字母小写,多个单词组成时,采用中划线-分隔;
使用唯一的 id 作为 Javascript hook,同时避免创建无样式信息的 class;

XML/HTML Code复制内容到剪贴板
  1. <!-- Not recommended -->  
  2. <div class="j-hook left contentWrapper"></div>  
  3.   
  4. <!-- Recommended -->  
  5. <div id="j-hook" class="sidebar content-wrapper"></div>  

属性顺序

HTML 属性应该按照特定的顺序出现以保证易读性。

id
class
name
data-xxx
src, for, type, href
title, alt
aria-xxx, role

XML/HTML Code复制内容到剪贴板
  1. <a id="..." class="..." data-modal="toggle" href="###"></a>  
  2.   
  3. <input class="form-control" type="text">  
  4.   
  5. <img src="..." alt="...">  

引号

属性的定义,统一使用双引号。

XML/HTML Code复制内容到剪贴板
  1. <!-- Not recommended -->  
  2. <span id='j-hook' class=text>Google</span>  
  3.   
  4. <!-- Recommended -->  
  5. <span id="j-hook" class="text">Google</span>  

b嵌套

a 不允许嵌套 div 这种约束属于语义嵌套约束,与之区别的约束还有严格嵌套约束,比如 a 不允许嵌套 a。

严格嵌套约束在所有的浏览器下都不被允许;而语义嵌套约束,浏览器大多会容错处理,生成的文档树可能相互不太一样。

 

语义嵌套约束

<li> 用于 <ul> 或 <ol> 下;
<dd>,<dt> 用于 <dl> 下;
<thead>,<tbody>,<tfoot>,<tr>,<td> 用于<table>下;


严格嵌套约束

inline-Level 元素,仅可以包含文本或其它 inline-Level 元素;
<a> 里不可以嵌套交互式元素 <a>、<button>、<select>等;
<p>里不可以嵌套块级元素<div>、<h1>~<h6>、<p>、<ul>/<ol>/<li>、<dl>/<dt>/<dd>、<form>等。

布尔值属性

HTML5 规范中 disabled、checked、selected 等属性不用设置值。

XML/HTML Code复制内容到剪贴板
  1. <input type="text" disabled>  
  2.   
  3. <input type="checkbox" value="1" checked>  
  4.   
  5. <select>  
  6.   <option value="1" selected>1</option>  
  7. </select>  

语义化
没有 CSS 的 HTML 是一个语义系统而不是 UI 系统。

通常情况下,每个标签都是有语义的,所谓语义就是你的衣服分为外套, 裤子,裙子,内裤等,各自有对应的功能和含义。所以你总不能把内裤套在脖子上吧。-- 一丝

此外语义化的 HTML 结构,有助于机器(搜索引擎)理解,另一方面多人协作时,能迅速了解开发者意图。

常见标签语义

标签 语义
<p> 段落
<h1><h2><h3>... 标题
<ul> 无序列表
<ol> 有序列表
<blockquote> 大段引用
<cite> 一般引用
<b> 为样式加粗而加粗
<storng> 为强调内容而加粗
<i> 为样式倾斜而倾斜
<em> 为强调内容而倾斜
code 代码标识
abbr 缩写

示例

将你构建的页面当作一本书,将标签的语义对应的其功能和含义;

书的名称:<h1>
书的每个章节标题: <h2>
章节内的文章标题: <h3>
小标题 / 副标题: <h4> <h5> <h6>
章节的段落: <p>

HEAD
文档类型

为每个 HTML 页面的第一行添加标准模式(standard mode)的声明, 这样能够确保在每个浏览器中拥有一致的表现。

XML/HTML Code复制内容到剪贴板
  1. <!DOCTYPE html>  
  2. 语言属性   
  3.   
  4. <!-- 中文 -->  
  5. <html lang="zh-Hans">  
  6.   
  7. <!-- 简体中文 -->  
  8. <html lang="zh-cmn-Hans">  
  9.   
  10. <!-- 繁体中文 -->  
  11. <html lang="zh-cmn-Hant">  
  12.   
  13. <!-- English -->  
  14. <html lang="en">  

字符编码

以无 BOM 的 utf-8 编码作为文件格式;
指定字符编码的 meta 必须是 head 的第一个直接子元素

XML/HTML Code复制内容到剪贴板
  1. <html>  
  2.   <head>  
  3.     <meta charset="utf-8">  
  4.     ......   
  5.   </head>  
  6.   <body>  
  7.     ......   
  8.   </body>  
  9. </html>  

IE 兼容模式

优先使用最新版本的 IE 和 Chrome 内核。

XML/HTML Code复制内容到剪贴板
  1. <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">  

SEO 优化

XML/HTML Code复制内容到剪贴板
  1. <head>  
  2.     <meta charset="utf-8">  
  3.     <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">  
  4.     <!-- SEO -->  
  5.     <title>Style Guide</title>  
  6.     <meta name="keywords" content="your keywords">  
  7.     <meta name="description" content="your description">  
  8.     <meta name="author" content="author,email address">  
  9. </head>  

viewport

viewport: 一般指的是浏览器窗口内容区的大小,不包含工具条、选项卡等内容;
width: 浏览器宽度,输出设备中的页面可见区域宽度;
device-width: 设备分辨率宽度,输出设备的屏幕可见宽度;
initial-scale: 初始缩放比例;
maximum-scale: 最大缩放比例;
为移动端设备优化,设置可见区域的宽度和初始缩放比例。

XML/HTML Code复制内容到剪贴板
  1. <meta name="viewport" content="width=device-width, initial-scale=1.0">  

iOS 图标

apple-touch-icon 图片自动处理成圆角和高光等效果;
apple-touch-icon-precomposed 禁止系统自动添加效果,直接显示设计原图;

XML/HTML Code复制内容到剪贴板
  1. <!-- iPhone 和 iTouch,默认 57x57 像素,必须有 -->  
  2. <link rel="apple-touch-icon-precomposed" href="/apple-touch-icon-57x57-precomposed.png">  
  3.   
  4. <!-- iPad,72x72 像素,可以没有,但推荐有 -->  
  5. <link rel="apple-touch-icon-precomposed" href="/apple-touch-icon-72x72-precomposed.png" sizes="72x72">  
  6.   
  7. <!-- Retina iPhone 和 Retina iTouch,114x114 像素,可以没有,但推荐有 -->  
  8. <link rel="apple-touch-icon-precomposed" href="/apple-touch-icon-114x114-precomposed.png" sizes="114x114">  
  9.   
  10. <!-- Retina iPad,144x144 像素,可以没有,但推荐有 -->  
  11. <link rel="apple-touch-icon-precomposed" href="/apple-touch-icon-144x144-precomposed.png" sizes="144x144">  

favicon

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

在 Web Server 根目录放置 favicon.ico 文件;
使用 link 指定 favicon;

XML/HTML Code复制内容到剪贴板
  1. <link rel="shortcut icon" href="path/to/favicon.ico">  

HEAD 模板

XML/HTML Code复制内容到剪贴板
  1. <!DOCTYPE html>  
  2. <html lang="zh-cmn-Hans">  
  3. <head>  
  4.     <meta charset="utf-8">  
  5.     <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">  
  6.     <title>Style Guide</title>  
  7.     <meta name="description" content="不超过150个字符">  
  8.     <meta name="keywords" content="">  
  9.     <meta name="author" content="name, email@gmail.com">  
  10.   
  11.     <!-- 为移动设备添加 viewport -->  
  12.     <meta name="viewport" content="width=device-width, initial-scale=1.0">  
  13.   
  14.     <!-- iOS 图标 -->  
  15.     <link rel="apple-touch-icon-precomposed" href="/apple-touch-icon-57x57-precomposed.png">  
  16.   
  17.     <link rel="alternate" type="application/rss+xml" title="RSS" href="/rss.xml" />  
  18.     <link rel="shortcut icon" href="path/to/favicon.ico">  
  19. </head>  

HTML 注释

模块注释

XML/HTML Code复制内容到剪贴板
  1. <!-- 文章列表列表模块 -->  
  2. <div class="article-list">  
  3. ...   
  4. </div>  
  5. 区块注释   
  6. <!--   
  7. @name: Drop Down Menu   
  8. @description: Style of top bar drop down menu.   
  9. @author: Ashu(Aaaaaashu@gmail.com)   
  10. -->  

    您感兴趣的教程

    在docker中安装mysql详解

    本篇文章主要介绍了在docker中安装mysql详解,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编...

    详解 安装 docker mysql

    win10中文输入法仅在桌面显示怎么办?

    win10中文输入法仅在桌面显示怎么办?

    win10系统使用搜狗,QQ输入法只有在显示桌面的时候才出来,在使用其他程序输入框里面却只能输入字母数字,win10中...

    win10 中文输入法

    一分钟掌握linux系统目录结构

    这篇文章主要介绍了linux系统目录结构,通过结构图和多张表格了解linux系统目录结构,感兴趣的小伙伴们可以参考一...

    结构 目录 系统 linux

    PHP程序员玩转Linux系列 Linux和Windows安装

    这篇文章主要为大家详细介绍了PHP程序员玩转Linux系列文章,Linux和Windows安装nginx教程,具有一定的参考价值,感兴趣...

    玩转 程序员 安装 系列 PHP

    win10怎么安装杜比音效Doby V4.1 win10安装杜

    第四代杜比®家庭影院®技术包含了一整套协同工作的技术,让PC 发出清晰的环绕声同时第四代杜比家庭影院技术...

    win10杜比音效

    纯CSS实现iOS风格打开关闭选择框功能

    这篇文章主要介绍了纯CSS实现iOS风格打开关闭选择框,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作...

    css ios c

    Win7如何给C盘扩容 Win7系统电脑C盘扩容的办法

    Win7如何给C盘扩容 Win7系统电脑C盘扩容的

    Win7给电脑C盘扩容的办法大家知道吗?当系统分区C盘空间不足时,就需要给它扩容了,如果不管,C盘没有足够的空间...

    Win7 C盘 扩容

    百度推广竞品词的投放策略

    SEM是基于关键词搜索的营销活动。作为推广人员,我们所做的工作,就是打理成千上万的关键词,关注它们的质量度...

    百度推广 竞品词

    Visual Studio Code(vscode) git的使用教程

    这篇文章主要介绍了详解Visual Studio Code(vscode) git的使用,小编觉得挺不错的,现在分享给大家,也给大家做个参考。...

    教程 Studio Visual Code git

    七牛云储存创始人分享七牛的创立故事与

    这篇文章主要介绍了七牛云储存创始人分享七牛的创立故事与对Go语言的应用,七牛选用Go语言这门新兴的编程语言进行...

    七牛 Go语言

    Win10预览版Mobile 10547即将发布 9月19日上午

    微软副总裁Gabriel Aul的Twitter透露了 Win10 Mobile预览版10536即将发布,他表示该版本已进入内部慢速版阶段,发布时间目...

    Win10 预览版

    HTML标签meta总结,HTML5 head meta 属性整理

    移动前端开发中添加一些webkit专属的HTML5头部标签,帮助浏览器更好解析HTML代码,更好地将移动web前端页面表现出来...

    移动端html5模拟长按事件的实现方法

    这篇文章主要介绍了移动端html5模拟长按事件的实现方法的相关资料,小编觉得挺不错的,现在分享给大家,也给大家...

    移动端 html5 长按

    HTML常用meta大全(推荐)

    这篇文章主要介绍了HTML常用meta大全(推荐),文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参...

    cdr怎么把图片转换成位图? cdr图片转换为位图的教程

    cdr怎么把图片转换成位图? cdr图片转换为

    cdr怎么把图片转换成位图?cdr中插入的图片想要转换成位图,该怎么转换呢?下面我们就来看看cdr图片转换为位图的...

    cdr 图片 位图

    win10系统怎么录屏?win10系统自带录屏详细教程

    win10系统怎么录屏?win10系统自带录屏详细

    当我们是使用win10系统的时候,想要录制电脑上的画面,这时候有人会想到下个第三方软件,其实可以用电脑上的自带...

    win10 系统自带录屏 详细教程

    + 更多教程 +
    HTMLCSSDreamweaverFrontpage