浏览器与 Web API / 系统课时

准备 DOM 编程示例环境

准备 DOM 编程示例环境

一个稳定的 DOM 示例环境只需要清晰的文件结构、正确的资源路径和可预测的脚本执行时机。本课将创建 HTML、CSS、JavaScript 三个文件,使用 defer 加载脚本,再启动本地服务器完成页面交互与控制台验证。

学习目标

  • 建立适合 DOM 练习的最小项目目录。
  • 正确连接样式表和外部 JavaScript 文件。
  • 使用本地服务器、页面结果与控制台信息验证环境。

检查运行条件

准备任意现代浏览器和纯文本编辑器即可。为了避免本地文件协议带来的路径、模块或请求限制,示例通过 Python 内置服务器运行;系统需要能够执行 python,部分环境的命令名称可能是 python3。

创建 dom-demo 目录,并保持以下结构。文件名和引用路径必须完全一致,部署到区分大小写的系统后,App.js 与 app.js 会被视为不同文件。

text
dom-demo/
├── index.html
├── styles.css
└── app.js

建立页面、样式与脚本

以下三个文件共同组成一个可运行示例。HTML 负责结构,CSS 负责可见状态,JavaScript 查询节点并绑定点击事件。脚本放在 head 中,但通过 defer 保证它在文档解析完成后执行。

index.html

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>DOM 示例环境</title>
  <link rel="stylesheet" href="./styles.css">
  <script src="./app.js" defer></script>
</head>
<body>
  <main class="panel">
    <h1>DOM 示例环境</h1>
    <p id="status">等待操作</p>
    <button id="toggle" type="button">更新状态</button>
  </main>
</body>
</html>

styles.css

css
body {
  margin: 0;
  min-height: 100vh;
  display: grid;
  place-items: center;
  font-family: system-ui, sans-serif;
  background: #f3f6fb;
}

.panel {
  width: min(420px, calc(100% - 32px));
  padding: 24px;
  border: 1px solid #cbd5e1;
  border-radius: 12px;
  background: #ffffff;
}

#status {
  color: #475569;
}

#status.is-active {
  color: #047857;
  font-weight: 700;
}

app.js

js
const statusElement = document.querySelector("#status");
const toggleButton = document.querySelector("#toggle");

if (
  !(statusElement instanceof HTMLElement) ||
  !(toggleButton instanceof HTMLButtonElement)
) {
  throw new Error("页面元素缺失,请检查 id 与脚本路径");
}

// 事件触发后同时更新文本与状态类
toggleButton.addEventListener("click", () => {
  const isActive = statusElement.classList.toggle("is-active");
  statusElement.textContent = isActive ? "DOM 已更新" : "等待操作";
  console.log(`status=${statusElement.textContent}`);
});

console.log("DOM 示例已就绪");

预期结果:

text
页面初始状态:等待操作
控制台首条信息:DOM 示例已就绪
首次点击按钮后:DOM 已更新
控制台新增信息:status=DOM 已更新

启动本地服务器

在终端进入项目目录并启动服务器。将 <PATH> 替换为项目实际所在路径;若系统只提供 python3,把命令中的 python 改为 python3。

bash
cd <PATH>/dom-demo
python -m http.server 8000

预期输出:

text
Serving HTTP on <HOST> port 8000

<HOST> 的实际格式取决于操作系统与 Python 版本。服务器运行后访问 http://localhost:8000,终端收到 GET /、GET /styles.css 和 GET /app.js 请求即表示三个文件都已被浏览器读取。

理解脚本加载位置

普通脚本如果直接放在 head 中,浏览器遇到它时会暂停 HTML 解析并立即执行,此时正文元素可能尚未创建。把脚本放到 body 末尾可以规避这个问题,但文件组织会把加载策略隐含在标签位置中。

defer 会让外部脚本与 HTML 并行下载,并在文档解析完成后、DOMContentLoaded 事件触发前按声明顺序执行。因此本例可以直接查询 #status 与 #toggle,不必再包一层事件监听。需要注意,defer 只对带 src 的外部经典脚本生效。

验证与典型失败处理

先观察页面是否有卡片样式,再打开浏览器控制台确认出现“DOM 示例已就绪”。点击按钮后,文字、颜色和日志应同时变化;这三个结果分别验证 HTML 节点、CSS 类和 JavaScript 事件链路。

页面没有样式时,检查 link 的 href、文件名大小写和网络请求状态。控制台出现 404 时,通常是资源路径或服务器启动目录错误;出现“页面元素缺失”时,检查 HTML 中的 id 是否与 JavaScript 选择器一致。

若双击 index.html 能打开但服务器地址不能访问,先确认终端进程仍在运行,并检查端口 8000 是否被占用。端口冲突时可改用其他未占用端口,同时把浏览器地址中的端口改成相同数值。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

准备 DOM 编程示例环境

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通