浏览器与 Web API / 系统课时
使用 ES 模块拆分页面逻辑
使用 ES 模块拆分页面逻辑
本课把单文件中的数据管理、DOM 渲染、事件协调和通用工具拆成 ES 模块。完成后,你将建立单向依赖关系,并能通过浏览器原生 import、export 运行和验证页面。
学习目标
- 根据职责确定模块边界,而不是按代码行数机械拆文件。
- 正确使用命名导出、相对路径和模块入口。
- 通过本地 HTTP 服务运行模块,并定位常见加载失败。
按职责划分模块边界
一个稳定的拆分方式是让数据模块只处理业务状态,渲染模块只接收数据并更新 DOM,事件逻辑集中在入口模块,纯函数放入工具模块。入口模块负责组装这些能力,因此它可以依赖其他模块,而底层模块不应反向导入入口。

模块边界还应控制可见性。没有被 export 的变量只在当前文件中可见,可作为内部实现细节;对外只导出调用方真正需要的函数。这样可以减少模块间约定,也能降低以后调整内部实现时的影响范围。
实现数据、渲染、事件与工具模块
创建下面五个文件。utils.js 负责规范化文本,state.js 保存任务数组,view.js 生成列表节点,app.js 绑定事件并协调更新。index.html
html
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>ES 模块任务列表</title>
</head>
<body>
<form id="task-form">
<input id="task-title" name="title" required>
<button type="submit">添加任务</button>
</form>
<ul id="task-list"></ul>
<script type="module" src="./app.js"></script>
</body>
</html>utils.js
js
export function normalizeTitle(value) {
return value.trim().replace(/\s+/g, " ");
}state.js
js
import { normalizeTitle } from "./utils.js";
export function createTaskStore(initialTasks = []) {
let tasks = initialTasks.map((task) => ({ ...task }));
return {
add(rawTitle) {
const title = normalizeTitle(rawTitle);
if (!title) return false;
tasks = [
...tasks,
{ id: `task-${Date.now()}`, title }
];
return true;
},
getSnapshot() {
// 返回副本,避免渲染层直接修改内部状态。
return tasks.map((task) => ({ ...task }));
}
};
}view.js
js
export function renderTasks(listElement, tasks) {
const nodes = tasks.map((task) => {
const item = document.createElement("li");
item.dataset.id = task.id;
item.textContent = task.title;
return item;
});
// 一次替换全部子节点,渲染层不保存业务状态。
listElement.replaceChildren(...nodes);
}app.js
js
import { createTaskStore } from "./state.js";
import { renderTasks } from "./view.js";
const form = document.querySelector("#task-form");
const titleInput = document.querySelector("#task-title");
const list = document.querySelector("#task-list");
const store = createTaskStore([
{ id: "task-initial", title: "学习 import 与 export" }
]);
function render() {
renderTasks(list, store.getSnapshot());
}
form.addEventListener("submit", (event) => {
event.preventDefault();
if (store.add(titleInput.value)) {
titleInput.value = "";
render();
}
});
render();运行并验证模块加载
ES 模块应通过 HTTP 服务加载,不要直接双击 index.html 后依赖 file:// 路径。进入文件所在目录,运行:
bash
python3 -m http.server 8000然后访问 http://localhost:8000。端口被占用时可把 8000 替换为其他可用端口,实际值记为 <PORT>。预期结果
text
页面初始显示“学习 import 与 export”。
输入“ 拆分 页面逻辑 ”并提交后,列表新增“拆分 页面逻辑”。
刷新页面后回到初始数据,因为示例没有持久化存储。
浏览器控制台不出现模块加载或语法错误。若控制台出现 Failed to load module script,先检查服务是否通过 HTTP 启动,再检查导入路径是否带有正确的 ./ 和 .js 后缀。若出现“请求的模块没有提供某个导出”,则核对 export 名称与 import { name } 是否逐字一致。浏览器模块默认使用严格模式,并且每个模块拥有独立作用域,不会自动把变量挂到 window。
按自己的节奏,确认真正理解。