Skip to content
On this page

html 规范

DOCTYPE 声明

在文件的开头添加正确的 DOCTYPE 声明,指定 HTML 版本。

文件结构

  • 使用 <html> 标签作为根元素。
  • 在 <head> 中放置文档标题、字符编码声明、CSS 和 JavaScript 的引用等元信息。
  • 在 <body> 中编写页面内容。

使用语义化标签

  • 使用适当的语义化标签(如 <header>, <nav>, <article>, <section>, <footer> 等)来描述页面结构和内容,提高可读性和可访问性。

标签嵌套规范

  • 遵循正确的标签嵌套关系,确保每个打开的标签都有相应的关闭标签。
  • 避免在块级元素中直接嵌套块级元素,应使用合适的容器元素包裹。

属性规范

  • 属性名和属性值应使用双引号括起来,如 class="container", href="https://example.com"。
  • 如果属性值为空,则可以省略属性值,如 disabled。
  • 避免在 HTML 属性中直接使用 JavaScript 或 CSS,优先使用外部文件或内联脚本和样式表。

标签和属性命名规范

  • 使用有意义且能够正确描述其功能的标签和属性名。
  • 标签和属性名建议使用小写字母,并采用连接符(短横线)分隔单词,如 class="main-content"。

注释规范

  • 在适当的位置添加注释,解释代码的作用、目的或任何需要注意的事项。

缩进和换行

避免无障碍性问题

  • 使用合适的标签和属性来支持屏幕阅读器等辅助技术。
  • 为图片添加有意义的替代文本描述(alt 属性)。

多语言支持

  • 在 <html> 标签上添加 lang 属性,指定页面所使用的主要语言。