replaceWith 本身不实现无刷新加载,需配合 fetch 获取内容后再替换;基本流程为选中元素→请求新内容→解析生成 DOM→调用 replaceWith 替换;支持 HTML 片段或 JSON 渲染替换,注意脚本不执行、状态丢失及兼容性问题。

replaceWith 本身不实现“无刷新加载”,它只是 DOM 操作方法,用于替换现有节点;要实现“无刷新加载的节点替换”,需配合 fetch(或 XMLHttpRequest)获取新 HTML/内容,再用 replaceWith 更新页面局部。
1. 基本流程:请求 + 替换
核心逻辑是:
- 选中目标元素(如一个容器)
- 发起网络请求获取新内容(HTML 片段、JSON 数据等)
- 解析响应,生成新 DOM 节点(可用 DOMParser 或 innerHTML)
- 调用 replaceWith() 替换原节点
2. 替换 HTML 片段(最常见场景)
假设你有一个 <div id="content"></div>,想用服务端返回的新 HTML 替换它:
你接手一个需求时,是不是经常这样:"改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续";这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境(JDK、Spring Boot、ORM、数据库、前端框架),记在
async function loadAndReplace(selector, url) {
try {
const response = await fetch(url);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
<pre class="brush:php;toolbar:false;">const html = await response.text();
const parser = new DOMParser();
const doc = parser.parseFromString(html, 'text/html');
const newContent = doc.body.firstElementChild;
if (newContent) {
const target = document.querySelector(selector);
if (target) target.replaceWith(newContent);
}} catch (err) { console.error('加载失败:', err); } }
// 使用示例 loadAndReplace('#content', '/api/partial/home');
-
DOMParser安全解析 HTML 字符串,避免直接 innerHTML 执行脚本(除非你明确需要) - 取
doc.body.firstElementChild是因为服务端通常返回完整片段(如...),不是纯文本 - 若服务端返回的是纯 HTML 内容(不含 body 标签),也可用临时 div:
tempDiv.innerHTML = html; tempDiv.firstElementChild
3. 替换动态生成的内容(如 JSON 渲染)
如果接口返回 JSON,需先渲染成 DOM 再替换:
async function loadJsonAndReplace(selector, url) {
const res = await fetch(url);
const data = await res.json();
<p>// 创建新节点(例如渲染列表)
const newList = document.createElement('ul');
data.items.forEach(item => {
const li = document.createElement('li');
li.textContent = item.title;
newList.appendChild(li);
});</p><p>const target = document.querySelector(selector);
if (target) target.replaceWith(newList);
}
</p>- 这种方式更可控,适合结构复杂、需绑定事件或校验数据的场景
- 注意:被 replaceWith 的原节点会从 DOM 中彻底移除,包括它的事件监听器和子资源(如图片、iframe)
4. 注意事项与常见问题
-
replaceWith 不支持 IE:如需兼容旧浏览器,可用
parentNode.replaceChild(newNode, oldNode) - 脚本不会自动执行:用 DOMParser 或 innerHTML 插入的 script 标签默认不运行,需手动 eval 或创建 script 元素
- 保持状态需自行处理:比如表单输入、滚动位置、焦点等,replaceWith 后会丢失,需在替换前保存、替换后恢复
- 避免重复请求或并发冲突:可加 loading 状态、取消重复请求(用 AbortController)
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










