zoukankan      html  css  js  c++  java

  • 前端编码规范（2）HTML 规范

    文档类型

    推荐使用 HTML5 的文档类型申明： <!DOCTYPE html>

    （建议使用 text/html 格式的 HTML。避免使用 XHTML。XHTML 以及它的属性，比如 application/xhtml+xml 在浏览器中的应用支持与优化空间都十分有限）。

    HTML 中最好不要将无内容元素 [1]的标签闭合，例如：使用 <br> 而非 <br />.

    HTML 验证

    一般情况下，建议使用能通过标准规范验证的 HTML 代码，除非在性能优化和控制文件大小上不得不做出让步。

    使用诸如 W3C HTML validator 这样的工具来进行检测。

    规范化的 HTML 是显现技术要求与局限的显著质量基线，它促进了 HTML 被更好地运用。

    不推荐

     
    1. <title>Test</title>
    2. <article>This is only a test.

    推荐

     
    1. <!DOCTYPE html>
    2. <meta charset="utf-8">
    3. <title>Test</title>
    4. <article>This is only a test.</article>

    省略可选标签

    HTML5 规范中规定了 HTML 标签是可以省略的。但从可读性来说，在开发的源文件中最好不要这样做，因为省略标签可能会导致一些问题。

    省略一些可选的标签确实使得页面大小减少，这很有用，尤其是对于一些大型网站来说。为了达到这一目的，我们可以在开发后期对页面进行压缩处理，在这个环节中这些可选的标签完全就可以省略掉了。

    脚本加载

    出于性能考虑，脚本异步加载很关键。一段脚本放置在 <head> 内，比如 <script src="main.js"></script>，其加载会一直阻塞 DOM 解析，直至它完全地加载和执行完毕。这会造成页面显示的延迟。特别是一些重量级的脚本，对用户体验来说那真是一个巨大的影响。

    异步加载脚本可缓解这种性能影响。如果只需兼容 IE10+，可将 HTML5 的 async 属性加至脚本中，它可防止阻塞 DOM 的解析，甚至你可以将脚本引用写在 <head> 里也没有影响。

    如需兼容老旧的浏览器，实践表明可使用用来动态注入脚本的脚本加载器。你可以考虑 yepnope 或 labjs。注入脚本的一个问题是：一直要等到 CSS 对象文档已就绪，它们才开始加载（短暂地在 CSS 加载完毕之后），这就对需要及时触发的 JS 造成了一定的延迟，这多多少少也影响了用户体验吧。

    终上所述，兼容老旧浏览器(IE9-)时，应该遵循以下最佳实践。

    脚本引用写在 body 结束标签之前，并带上 async 属性。这虽然在老旧浏览器中不会异步加载脚本，但它只阻塞了 body 结束标签之前的 DOM 解析，这就大大降低了其阻塞影响。而在现代浏览器中，脚本将在 DOM 解析器发现 body 尾部的 script 标签才进行加载，此时加载属于异步加载，不会阻塞 CSSOM（但其执行仍发生在 CSSOM 之后）。

    所有浏览器中，推荐

     
    1. <html>
    2.   <head>
    3.     <link rel="stylesheet" href="main.css">
    4.   </head>
    5.   <body>
    6.     <!-- body goes here -->
    8.     <script src="main.js" async></script>
    9.   </body>
    10. </html>

    只在现代浏览器中，推荐

     
    1. <html>
    2.   <head>
    3.     <link rel="stylesheet" href="main.css">
    4.     <script src="main.js" async></script>
    5.   </head>
    6.   <body>
    7.     <!-- body goes here -->
    8.   </body>
    9. </html>

    语义化

    根据元素（有时被错误地称作“标签”）其被创造出来时的初始意义来使用它。打个比方，用 heading 元素来定义头部标题，p 元素来定义文字段落，用 a 元素来定义链接锚点，等等。

    有根据有目的地使用 HTML 元素，对于可访问性、代码重用、代码效率来说意义重大。

    多媒体回溯

    对页面上的媒体而言，像图片、视频、canvas 动画等，要确保其有可替代的接入接口。图片文件我们可采用有意义的备选文本（alt），视频和音频文件我们可以为其加上说明文字或字幕。

    提供可替代内容对可用性来说十分重要。试想，一位盲人用户如何能知晓一张图片是什么，要是没有 @alt 的话。

    （图片的 alt 属性是可不填写内容的，纯装饰性的图片就可用这么做：alt=""）。

     
    1. <img src="luke-skywalker.jpg" alt="Luke skywalker riding an alien horse">

    关注点分离

    理解 web 中如何和为何区分不同的关注点，这很重要。这里的关注点主要指的是：信息（HTML 结构）、外观（CSS）和行为（JavaScript）。为了使它们成为可维护的干净整洁的代码，我们要尽可能的将它们分离开来。

    严格地保证结构、表现、行为三者分离，并尽量使三者之间没有太多的交互和联系。

    就是说，尽量在文档和模板中只包含结构性的 HTML；而将所有表现代码，移入样式表中；将所有动作行为，移入脚本之中。

    在此之外，为使得它们之间的联系尽可能的小，在文档和模板中也尽量少地引入样式和脚本文件。

    清晰的分层意味着：

    • 不使用超过一到两张样式表（i.e. main.css, vendor.css）
    • 不使用超过一到两个脚本（学会用合并脚本）
    • 不使用行内样式（<style>.no-good {}</style>）
    • 不在元素上使用 style 属性（<hr style="border-top: 5px solid black">）
    • 不使用行内脚本（<script>alert('no good')</script>）
    • 不使用表象元素（i.e. <b>, <u>, <center>, <font>, <b>）
    • 不使用表象 class 名（i.e. red, left, center）

    HTML 内容至上

    不要让非内容信息污染了你的 HTML。现在貌似有一种倾向：通过 HTML 来解决设计问题，这是显然是不对的。HTML 就应该只关注内容。

    HTML 标签的目的，就是为了不断地展示内容信息。

    • 不要引入一些特定的 HTML 结构来解决一些视觉设计问题
    • 不要将 img 元素当做专门用来做视觉设计的元素
    • 图片和 SVG 图形能被引入到 HTML 中的唯一理由是它们呈现出了与内容相关的一些信息。

    Type 属性

    省略样式表与脚本上的 type 属性。鉴于 HTML5 中以上两者默认的 type 值就是 text/css 和 text/javascript，所以 type 属性一般是可以忽略掉的。甚至在老旧版本的浏览器中这么做也是安全可靠的。
    不推荐

     
    1. <link rel="stylesheet" href="main.css" type="text/css">
    2. <script src="main.js" type="text/javascript"></script>

    推荐

     
    1. <link rel="stylesheet" href="main.css">
    2. <script src="main.js"></script>

    可用性

    如果 HTML5 语义化标签使用得当，许多可用性问题已经引刃而解。ARIA 规则在一些语义化的元素上可为其添上默认的可用性角色属性，使用得当的话已使网站的可用性大部分成立。假如你使用 nav, aside, main, footer 等元素，ARIA 规则会在其上应用一些关联的默认值。
    更多细节可参考 ARIA specification

    另外一些角色属性则能够用来呈现更多可用性情景（i.e. role="tab"）。

    Tab Index 在可用性上的运用

    检查文档中的 tab 切换顺序并传值给元素上的 tabindex，这可以依据元素的重要性来重新排列其 tab 切换顺序。你可以设置 tabindex="-1" 在任何元素上来禁用其 tab 切换。

    当你在一个默认不可聚焦的元素上增加了功能，你应该总是为其加上 tabindex 属性使其变为可聚焦状态，而且这也会激活其 CSS 的伪类 :focus。选择合适的 tabindex 值，或是直接使用 tabindex="0" 将元素们组织成同一 tab 顺序水平，并强制干预其自然阅读顺序。

    ID 和锚点

    通常一个比较好的做法是将页面内所有的头部标题元素都加上 ID. 这样做，页面 URL 的 hash 中带上对应的 ID 名称，即形成描点，方便跳转至对应元素所处位置。

    打个比方，当你在浏览器中输入 URL http://your-site.com/about#best-practices，浏览器将定位至以下 H3 上。

     
    1. <h3 id="best-practices">Best practices</h3>

    格式化规则

    在每一个块状元素，列表元素和表格元素后，加上一新空白行，并对其子孙元素进行缩进。内联元素写在一行内，块状元素还有列表和表格要另起一行。

    （如果由于换行的空格引发了不可预计的问题，那将所有元素并入一行也是可以接受的，格式警告总好过错误警告）。

     
    1. <blockquote>
    2.   <p><em>Space</em>, the final frontier.</p>
    3. </blockquote>
    5. <ul>
    6.   <li>Moe</li>
    7.   <li>Larry</li>
    8.   <li>Curly</li>
    9. </ul>
    11. <table>
    12.   <thead>
    13.     <tr>
    14.       <th scope="col">Income</th>
    15.       <th scope="col">Taxes</th>
    16.     </tr>
    17.   </thead>
    18.   <tbody>
    19.     <tr>
    20.       <td>$ 5.00</td>
    21.       <td>$ 4.50</td>
    22.     </tr>
    23.   </tbody>
    24. </table>

    HTML 引号

    使用双引号(“”) 而不是单引号(”) 。

    不推荐

     
    1. <div class='news-article'></div>

    推荐

     
    1. <div class="news-article"></div>

    [1]: 此处的空白元素指的是以下元素：area, base, br, col, command, embed, hr, img, input, keygen, link, meta, param, source, track, wbr

    本文地址：http://www.cnblogs.com/zhaowy/

    版权声明：本文为原创文章，版权归 作者所有，欢迎分享本文，转载请保留出处！
  • 相关阅读:
    Django+xadmin打造在线教育平台（八）
    Django+xadmin打造在线教育平台（七）
    Django+xadmin打造在线教育平台（六）
    Django+xadmin打造在线教育平台（五）
    Django+xadmin打造在线教育平台（四）
    Django+xadmin打造在线教育平台（三）
    Django+xadmin打造在线教育平台（二）
    Django+xadmin打造在线教育平台（一）
    Linux环境部署（一）
    centOS的联网问题
  • 原文地址：https://www.cnblogs.com/zhaowy/p/8400179.html
Copyright © 2011-2022 走看看