浏览器与 Web API / 系统课时
准备 DOM 编程示例环境
准备 DOM 编程示例环境
一个稳定的 DOM 示例环境只需要清晰的文件结构、正确的资源路径和可预测的脚本执行时机。本课将创建 HTML、CSS、JavaScript 三个文件,使用 defer 加载脚本,再启动本地服务器完成页面交互与控制台验证。
学习目标
- 建立适合 DOM 练习的最小项目目录。
- 正确连接样式表和外部 JavaScript 文件。
- 使用本地服务器、页面结果与控制台信息验证环境。
检查运行条件
准备任意现代浏览器和纯文本编辑器即可。为了避免本地文件协议带来的路径、模块或请求限制,示例通过 Python 内置服务器运行;系统需要能够执行 python,部分环境的命令名称可能是 python3。
创建 dom-demo 目录,并保持以下结构。文件名和引用路径必须完全一致,部署到区分大小写的系统后,App.js 与 app.js 会被视为不同文件。
dom-demo/
├── index.html
├── styles.css
└── app.js建立页面、样式与脚本
以下三个文件共同组成一个可运行示例。HTML 负责结构,CSS 负责可见状态,JavaScript 查询节点并绑定点击事件。脚本放在 head 中,但通过 defer 保证它在文档解析完成后执行。
index.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
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
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 示例已就绪");预期结果:
页面初始状态:等待操作
控制台首条信息:DOM 示例已就绪
首次点击按钮后:DOM 已更新
控制台新增信息:status=DOM 已更新启动本地服务器
在终端进入项目目录并启动服务器。将 <PATH> 替换为项目实际所在路径;若系统只提供 python3,把命令中的 python 改为 python3。
cd <PATH>/dom-demo
python -m http.server 8000预期输出:
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 是否被占用。端口冲突时可改用其他未占用端口,同时把浏览器地址中的端口改成相同数值。