Appearance
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 属性,指定页面所使用的主要语言。