HTML 词条目录
前端Wiki/HTML/深入/可访问性与规范

HTML 编码风格

统一风格的价值在协作中体现:一致的代码让 diff 干净、让新人快速上手。社区主流约定包括:标签与属性全小写;属性值用双引号;空元素不写斜杠(写 <br> 而非 <br/>,HTML5 中斜杠无意义);嵌套统一缩进两个空格;每行只放一个元素,避免一行塞多个标签。

属性顺序虽然没有强制标准,但常见做法是先 class、id,再 src/href 等数据属性,最后 aria 与事件属性,便于快速定位。

还有几条与正确性相关:<meta charset> 放 head 最前;img 始终带 alt;lang 属性不要漏;不要用行内 style 写大量样式——样式归 CSS 文件,结构里只留语义。

本节要点小写、双引号、两空格缩进、空元素不加斜杠;charset 放最前、img 带 alt;风格统一比风格本身是什么更重要,团队遵循同一份约定即可。
HTML
<!-- 推荐:小写标签、双引号、缩进清晰、每行一个元素 -->
<article class="post" data-id="42">
  <h2 class="post-title">标题</h2>
  <img class="cover" src="a.png" alt="封面图">
</article>

<!-- 不推荐:大小写混杂、单双引号混用、一行堆叠 -->
<!-- <DIV Class=post><img SRC=a.png alt=""><P>文字</P></DIV> -->

<!-- 空元素写法:<br> 即可,<br/> 在 HTML5 中无意义 -->
<br>

<!-- charset 必须是 head 的第一个元素 -->
<head>
  <meta charset="UTF-8">
</head>