Bootstrap HTML编码规范

编码规范是一套统一的 HTML 书写约定,与具体功能无关:一致的文档头、缩进、语义化标签和资源引入顺序,能让 Bootstrap 页面结构更清晰、加载更快,也更好维护和协作。

标准的 HTML5 文档头

每个页面都用 HTML5 文档头开头,包含文档类型、语言、字符集与视口设置,并把 Bootstrap 样式放入 head:

<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>我的 Bootstrap 页面</title>
  <link rel="stylesheet" href="css/bootstrap.min.css">
</head>
<body>
  <!-- 页面主体内容 -->
  <script src="js/jquery.min.js"></script>
  <script src="js/bootstrap.min.js"></script>
</body>
</html>

说明:样式放 head 让页面加载即有外观;jQuery 与 bootstrap.min.js 放 body 末尾可避免阻塞首屏渲染,且 jQuery 必须在前面,因为 Bootstrap 的 JS 依赖 jQuery。

缩进、闭合与大小写

统一用两个空格缩进,标签名与属性一律小写,标签都要闭合,块级嵌套保持层级清晰:

<div class="row">
  <div class="col-md-6">
    <p>左栏内容</p>
  </div>
  <div class="col-md-6">
    <p>右栏内容</p>
  </div>
</div>

说明:一致的缩进让网格嵌套一目了然,后续修改列宽或增删栏目都不容易出错。

语义化标签与必要属性

优先使用有含义的标签(header、nav、main、footer),图片必须写 alt,自定义数据用 data-* 属性:

<header class="page-header">
  <h1>欢迎光临</h1>
</header>
<main class="container">
  <img src="img/logo.png" alt="公司 Logo">
</main>
<footer class="text-center">版权所有</footer>

说明:语义化结构让屏幕阅读器与搜索引擎正确理解页面;alt 在图片加载失败时也会显示文字说明,提升可用性。

小结:规范让项目"长得一样":HTML5 文档头、样式进 head、脚本沉底且 jQuery 在前;小写、双空格、标签闭合、语义化与 alt 是日常例行公事,先有规范,组件才能整齐地拼出大页面。

笔记加载中…