news 2026/6/10 19:58:29

前后端模块化分离实战:从零搭建用户列表展示(HTML+CSS+JS + json-server)

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
前后端模块化分离实战:从零搭建用户列表展示(HTML+CSS+JS + json-server)

你是否也曾困惑:前端和后端到底怎么分开又怎么协作?
今天我们就从 0 到 1,手写一个用户信息列表页面。
后端用json-server模拟 REST API,前端用三件套(HTML + CSS + JS)实现动态渲染。
整个过程会涉及到:模块化思想、DOM 编程、fetch 异步请求、数组遍历……
全是干货,代码可直接运行。


一、最终效果预览

启动服务后,访问index.html,页面会从一个“假后端”http://localhost:3000/users拉取用户数据,并动态展示在表格中:

ID姓名昵称家乡
1lyg东理薛之谦南昌
2hy航哥南昌
3lqq橙帅信丰

(数据来源于db.json


二、项目结构与设计思想

我们采用前后端模块化分离的目录结构:

project/ ├── fe/ # 前端代码(实际可独立部署) │ ├── index.html │ └── common.js └── backend/ # 后端模拟 ├── db.json └── package.json

模块化的好处:

  • 每个文件职责单一,好维护

  • 前端只关心视图和交互,后端只关心数据接口

  • 方便以后扩展(比如把 json-server 换成真实后端)


三、后端准备:用 json-server 搭建零代码 API

1. 初始化项目

进入backend目录,执行:

npm init -y

得到package.json(项目描述文件)。

2. 安装 json-server

npm install json-server

3. 创建数据库文件db.json

写入以下内容(对象字面量作为数据源):

{ "users": [ { "id": 1, "name": "lyg", "hometown": "南昌", "nickname": "东理薛之谦" }, { "id": 2, "name": "hy", "hometown": "南昌", "nickname": "航哥" }, { "id": 3, "name": "lqq", "hometown": "信丰", "nickname": "橙帅" } ] }

4. 配置启动脚本

package.json中的"scripts"字段添加:

"scripts": { "dev": "json-server --watch db.json" }

解析--watch表示监听文件变化,自动重启服务。默认会开启http://localhost:3000,并提供/users等 RESTful 接口。

5. 启动后端

npm run dev

此时访问http://localhost:3000/users就能看到 JSON 格式的用户数据,一个完整的后端就“假装”好了。


四、前端页面:HTML + CSS 布局

1. 整体结构(语义化标签)

采用盒子模型思维:先划分盒子区域,再往里面填内容。
使用 HTML5 语义标签让结构更清晰:

<header>用户管理系统</header> <main class="container"> <aside>侧边栏(可留空)</aside> <div class="row col-md-6 col-md-offset-3"> <table class="table table-striped"> <thead>...</thead> <tbody><!-- 动态插入数据 --></tbody> </table> </div> <aside>右侧栏(可留空)</aside> </main> <footer>© 2025 全栈小练习</footer>

2. 引入 Bootstrap 快速美化

<head>中加入 Bootstrap CDN(Twitter 框架):

<link href="https://cdn.bootcdn.net/ajax/libs/twitter-bootstrap/3.0.3/css/bootstrap.min.css" rel="stylesheet">
  • .container:固定宽度居中(PC 时代经典布局)

  • .row/.col-md-*:栅格系统,行列布局

  • .table.table-striped:表格斑马纹样式

注意:表格必须包含<tbody>标签,否则 JS 动态插入会找不到挂载点。

完整index.html代码如下(见文末汇总)。


五、DOM 编程与动态数据渲染

1. 理解 DOM 树

当浏览器解析 HTML 后,会生成一棵文档对象模型(DOM)树

  • document是整个文档的根对象

  • document.documentElement对应<html>

  • document.body对应<body>

  • 每个标签都是一个节点(Node),可以查询、修改、添加、删除

我们通过选择器找到表格的tbody节点,然后动态往里面插入行。

2. 使用 fetch 获取后端数据

common.js中编写:

fetch('http://localhost:3000/users') // 发起 GET 请求 .then(response => response.json()) // 解析 JSON 流 .then(users => { // 拿到用户数组,开始渲染 })
  • fetch是浏览器内置的 API,用于异步 HTTP 请求

  • 它返回一个 Promise,所以用.then()处理结果

  • 第一个.then()将原始响应转成 JSON 对象

  • 第二个.then()拿到真正的数据(数组)

3. 动态生成表格行

拿到users数组后,遍历每一个用户对象,构造<tr>并插入到<tbody>中。

const tbody = document.querySelector('.table tbody'); // 找到挂载点 let i = 1; for (let user of users) { tbody.innerHTML += ` <tr> <td>${i}</td> <td>${user.name}</td> <td>${user.nickname}</td> <td>${user.hometown}</td> </tr> `; i++; }

重点解析

  • document.querySelector():返回第一个匹配 CSS 选择器的元素

  • .innerHTML:可以获取或设置元素内部的 HTML 结构,我们使用+=追加内容

  • 模板字符串(反引号`...`)内部可以嵌入${变量},非常方便

  • for...of是 ES6 引入的遍历数组的语法,比传统for (let i=0; i<arr.length; i++)更简洁、可读性更强

为什么不直接用innerHTML = 完整字符串而要用+=
因为每次追加会保留原有的内容,否则会覆盖掉之前的行(本例中可接受,但更推荐先构建好一个完整字符串再一次性赋值,性能更好)。

4. 完整common.js

fetch('http://localhost:3000/users') .then(res => res.json()) .then(users => { const tbody = document.querySelector('.table tbody'); let i = 1; for (let user of users) { tbody.innerHTML += ` <tr> <td>${i}</td> <td>${user.name}</td> <td>${user.nickname}</td> <td>${user.hometown}</td> </tr> `; i++; } });

六、完整代码清单

1.backend/db.json

{ "users": [ { "id": 1, "name": "lyg", "hometown": "南昌", "nickname": "东理薛之谦" }, { "id": 2, "name": "hy", "hometown": "南昌", "nickname": "航哥" }, { "id": 3, "name": "lqq", "hometown": "信丰", "nickname": "橙帅" } ] }

2.backend/package.json

{ "name": "backend", "version": "1.0.0", "description": "模拟后端API", "main": "index.js", "scripts": { "dev": "json-server --watch db.json" }, "dependencies": { "json-server": "^1.0.0-beta.15" } }

3.fe/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>用户列表 - 前后端分离演示</title> <link href="https://cdn.bootcdn.net/ajax/libs/twitter-bootstrap/3.0.3/css/bootstrap.min.css" rel="stylesheet"> </head> <body> <header class="text-center" style="padding: 20px; background: #f5f5f5;"> <h1>用户信息管理</h1> </header> <main class="container" style="margin-top: 30px;"> <aside class="col-md-2"> </aside> <div class="col-md-8"> <table class="table table-striped table-bordered"> <thead> <tr> <th>ID</th> <th>姓名</th> <th>昵称</th> <th>家乡</th> </tr> </thead> <tbody> <!-- JS 会动态填充数据 --> </tbody> </table> </div> <aside class="col-md-2"> </aside> </main> <footer class="text-center" style="padding: 15px; margin-top: 50px; background: #eee;"> © 2025 全栈练习 | 数据来自 json-server </footer> <script src="./common.js"></script> </body> </html>

4.fe/common.js

fetch('http://localhost:3000/users') .then(response => response.json()) .then(users => { const tbody = document.querySelector('.table tbody'); let index = 1; for (let user of users) { tbody.innerHTML += ` <tr> <td>${index}</td> <td>${user.name}</td> <td>${user.nickname}</td> <td>${user.hometown}</td> </tr> `; index++; } }) .catch(error => console.error('数据加载失败:', error));

七、运行步骤

  1. backend目录下执行npm run dev,保持终端不关闭(服务运行在3000端口)

  2. 用 Live Server 或直接打开fe/index.html(注意:直接打开文件会有跨域? json-server 默认支持 CORS,可以直接用file://协议访问,但更推荐用http-server或 Live Server 打开fe目录)

  3. 看到页面上的表格自动填充了数据库里的三条用户信息

如果数据没显示,打开浏览器控制台(F12)查看网络请求是否成功,确认http://localhost:3000/users能否正常访问。


八、知识点总结

技术点说明
模块化思想前端/后端代码分离,各自独立开发、维护,通过 HTTP 接口通信
json-server用 JSON 文件快速搭建 REST API,适合原型开发和学习
语义化标签header, main, footer, aside 等让 HTML 结构更清晰,SEO 友好
DOM 树HTML 被解析成节点树,document 对象提供查询和操作节点的方法
fetch API现代浏览器内置的异步请求方法,返回 Promise,替代古老的 XMLHttpRequest
innerHTML动态修改元素内部 HTML 的快捷方式(使用时注意 XSS 风险,本例无用户输入)
for...of简洁遍历数组的方法,直接获取每个元素的值,无需手动维护索引
模板字符串反引号 +${}语法,轻松拼接字符串和变量

九、拓展练习

  1. 增加用户:添加一个表单,通过fetch POST向后端新增用户

  2. 删除用户:给每一行加一个删除按钮,调用DELETE /users/{id}

  3. 改用 async/await:把.then()改成更现代的async/await写法

  4. 错误处理:在catch中显示友好的错误提示

大厂面试尤其关注 DOM 编程、模块化以及底层 HTTP 交互 —— 这些基础打好了,无论框架如何变化,都能快速上手。


写在最后
这篇笔记来自我的全栈学习过程,每一行代码都亲手敲过。
前后端分离不是高大上的概念,而是一种可以立刻实践的开发模式。
希望这篇文章能帮你迈出“既懂前端又懂后端”的第一步。

有任何疑问,欢迎在评论区交流 👏
如果你觉得有用,请点赞 ❤️ 或收藏 ⭐,让更多人看到~

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/6/10 19:55:24

个人总结 搭建Docker监控

监控 Docker系统 ​ Prometheus Grafana 监控 Docker 系统搭建指南。 要实现对 Docker 的全面监控&#xff0c;需要按照以下步骤搭建 Prometheus 和 Grafana 并进行配置&#xff1a; 4.1、安装 Prometheus下载并解压 Prometheus wget https://github.com/prometheus/prometheu…

作者头像 李华
网站建设 2026/6/10 19:55:12

个人总结 docker搭建家庭媒体库Jellyfin

Jellyfin​ Jellyfin 是一个开源媒体服务器项目&#xff0c;旨在让用户自行搭建并管理音视频流媒体库。它提供与商业媒体服务器&#xff08;如 Plex 或 Emby&#xff09;类似的功能&#xff0c;但完全免费且无专有组件或遥测功能。 ​ Jellyfin 允许用户在自有服务器上集中管理…

作者头像 李华
网站建设 2026/6/10 19:54:14

伺服电机仿真(3):PMSM在三相静止坐标系下的数学模型

3.1 引言&#xff1a;从物理实体到数学描述建立精确的数学模型是进行伺服电机仿真的第一步。在三相静止坐标系&#xff08;ABC坐标系&#xff09;下建立的PMSM模型&#xff0c;直接反映了电机的物理本质&#xff0c;描述了定子三相绕组与旋转转子永磁体之间的完整电磁相互作用关…

作者头像 李华
网站建设 2026/6/10 19:52:45

NVIDIA RTX Spark:个人电脑的重新定义

2026年6月1日&#xff0c;台北国际电脑展&#xff08;COMPUTEX 2026&#xff09;上&#xff0c;NVIDIA CEO黄仁勋正式发布了RTX Spark超级芯片。这是NVIDIA历史上第一款面向个人电脑的全集成处理器&#xff0c;标志着这家公司正式从"显卡公司"向"电脑核心处理器…

作者头像 李华
网站建设 2026/6/10 19:52:04

大模型常见面试题与生产实践

文章目录1 面试题1 如何确认检索结果是否可靠\2 如何保证大模型输出json可靠3 单agent 和 multi-agent系统有什么区别&#xff0c;分别适合什么场景4 如何设计一个可靠的长记忆机制1 面试题 1 如何确认检索结果是否可靠\ 不可靠分为&#xff1a; 1 召回不相关。2 关键信息漏掉…

作者头像 李华