后端必须返回items、has_more、next_offset三个字段:items为本次插入的结构化数组,has_more为布尔值控制按钮显隐,next_offset提供下一次请求参数;严禁返回HTML字符串,前端用insertAdjacentHTML追加、禁用按钮防重复请求。

后端必须返回结构化 JSON,前端用 insertAdjacentHTML 追加、禁用按钮、靠 has_more 控制显隐——这三件事做对,90% 的“加载更多”问题就不存在了。
后端接口该返回哪些字段才不翻车
别让前端猜分页边界。只要三个字段没商量:
-
items:本次要插入的数组,每项字段(如id、title)必须和首屏渲染的一致 -
has_more:布尔值,唯一可信依据,决定“加载更多”按钮是否继续显示;不能用items.length === 0替代,否则接口报错空响应会被误判为“到底” -
next_offset或next_cursor:下一次请求的参数,严禁前端自己算offset + 20,否则跳页、重复拉取、ID 乱序全来了
绝对不要返回 html 字段或带标签的字符串——这是 XSS 风险口,也破坏语义和 SEO。
前端插入新内容时为什么不能用 innerHTML +=
它会强制浏览器销毁并重建整个容器内的所有 DOM 节点,导致已绑定的事件监听器丢失、滚动位置重置、焦点消失,性能也差。
立即学习“前端免费学习笔记(深入)”;
正确做法是用 insertAdjacentHTML('beforeend', htmlString),只追加不重绘:
const html = data.items.map(item => `
<li class="item" data-id="${item.id}">
<h3>${item.title}</h3>
<p>${item.excerpt}</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill13305" title="AgentGen — HTML to PDF & Image"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20cf0281539.jpg" alt="AgentGen — HTML to PDF & Image" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill13305" title="AgentGen — HTML to PDF & Image">AgentGen — HTML to PDF & Image</a>
<p>将 HTML 转换为 PDF 和图片。无需注册,免费版开箱即用(每分钟 1 次请求,含水印)。如需更高频次及去水印……</p>
</div>
<a href="/xiazai/skill13305" title="AgentGen — HTML to PDF & Image" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>
</li>
`).join('');
listContainer.insertAdjacentHTML('beforeend', html);
如果需要更精细控制(比如绑定事件),优先用 DocumentFragment 批量创建再插入,避免反复触发重排。
滚动触底自动加载怎么防重复请求
核心不是“怎么监听滚动”,而是“怎么锁住状态”。常见错误是没设 isFetching 标志位,快速上拉时发一堆并发请求,后端返回乱序或重复数据。
必须同时满足两个条件才触发:
-
isFetching === false(防止连点/快速滚动重复触发) -
hasMore === true(防止最后一页还死循环拉)
判断触底推荐用 scrollHeight - scrollTop ,+50 是缓冲距离,避免用户拉到最底才动;移动端注意 iOS Safari 下 <code>document.body.scrollTop 可能为 0,得优先读 document.documentElement.scrollTop。
按钮点击加载 vs 上拉加载,状态管理差异在哪
按钮点击场景下,状态锁靠 button.disabled = true 最直接;上拉加载则必须用 JS 变量(如 isFetching)配合 removeEventListener 或闭包开关,CSS pointer-events: none 挡不住 touchmove。
loading 提示不能直接 appendChild 到列表末尾——布局抖动会导致滚动条跳动,手还没抬起来又触发第二次上拉。要用固定高度占位块:<div class="loading" style="height: 40px;"></div>,加载完成再替换成真实内容。
“没有更多”提示必须等接口返回且 data.length === 0 才显示,而不是一进页面就硬塞——否则空列表会误显“到底”,实际是查无数据。


















