浏览器与 Web API / 系统课时

使用 ES 模块拆分页面逻辑

使用 ES 模块拆分页面逻辑

本课把单文件中的数据管理、DOM 渲染、事件协调和通用工具拆成 ES 模块。完成后,你将建立单向依赖关系,并能通过浏览器原生 import、export 运行和验证页面。

学习目标

  • 根据职责确定模块边界,而不是按代码行数机械拆文件。
  • 正确使用命名导出、相对路径和模块入口。
  • 通过本地 HTTP 服务运行模块,并定位常见加载失败。

按职责划分模块边界

一个稳定的拆分方式是让数据模块只处理业务状态,渲染模块只接收数据并更新 DOM,事件逻辑集中在入口模块,纯函数放入工具模块。入口模块负责组装这些能力,因此它可以依赖其他模块,而底层模块不应反向导入入口。

ES 模块依赖与页面数据流

模块边界还应控制可见性。没有被 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。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 ES 模块拆分页面逻辑

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

登录哪都通