0

0

如何使用 localStorage 实现动态生成 HTML 元素的页面刷新持久化

碧海醫心

碧海醫心

发布时间:2025-09-25 14:03:18

|

532人浏览过

|

来源于php中文网

原创

如何使用 localstorage 实现动态生成 html 元素的页面刷新持久化

本文详细介绍了如何利用 JavaScript 的 localStorage API 解决动态生成 HTML 元素在页面刷新后消失的问题。通过在用户提交表单时将数据存储到 localStorage,并在页面加载时从 localStorage 中检索并重新渲染这些数据,可以确保用户创建的内容在浏览器会话之间持久存在,极大地提升了用户体验。

前端开发中,我们经常会遇到需要动态创建 HTML 元素来展示用户输入或应用程序状态的场景。然而,这些通过 JavaScript 动态添加到 DOM(文档对象模型)的元素,在用户刷新页面时会随之消失,因为浏览器会重新加载 HTML、CSS 和 JavaScript 文件,并重置整个 DOM 结构。为了解决这一问题,我们可以利用客户端存储机制,如 localStorage,来持久化这些动态生成的数据。

1. 理解问题:动态内容的短暂性

当使用 JavaScript 的 document.createElement() 和 appendChild() 等方法创建并插入元素时,这些操作只影响当前会话的 DOM。一旦页面被重新加载、关闭或导航到其他页面,浏览器会丢弃当前的 DOM 状态,并从服务器重新获取页面内容。因此,所有动态添加的元素都会丢失。

例如,一个表单提交后生成表格行的应用,在不进行数据持久化处理的情况下,刷新页面后表格将变为空白。


发布信息

// 原始 JavaScript 示例 (简化)
let button = document.querySelector('button[type="button"]');
button.addEventListener("click", () => {
  let nom = document.getElementById("nom").value;
  // ... 获取其他表单数据
  if (nom !== "") {
    let table = document.createElement('table');
    document.querySelector('body').appendChild(table);
    // ... 创建表头和数据行
    alert("表单已提交!");
  }
});

上述代码能正常工作,但刷新页面后,动态生成的

及其内容将不复存在。

立即学习前端免费学习笔记(深入)”;

2. 解决方案:使用 localStorage 进行数据持久化

localStorage 是浏览器提供的一种客户端存储机制,允许网页在用户的浏览器中存储键值对数据。这些数据没有过期时间,即使浏览器关闭再打开,数据依然存在,直到被显式清除。这使得它非常适合存储需要在页面刷新后保持不变的用户数据或应用程序状态。

2.1 localStorage 的基本操作

  • 存储数据: localStorage.setItem(key, value)
    • key: 字符串,数据的名称。
    • value: 字符串,要存储的数据。非字符串数据会被自动转换为字符串。
  • 获取数据: localStorage.getItem(key)
    • 返回与 key 关联的字符串值。如果 key 不存在,则返回 null。
  • 移除数据: localStorage.removeItem(key)
    • 移除与 key 关联的数据。
  • 清除所有数据: localStorage.clear()
    • 清除当前域名下的所有 localStorage 数据。

2.2 实现持久化动态生成表格的步骤

要实现动态生成表格的持久化,我们需要在两个关键时刻进行操作:

  1. 数据提交时: 当用户点击“发布”按钮提交表单并生成新的表格行时,将新的行数据存储到 localStorage 中。
  2. 页面加载时: 当页面首次加载或刷新时,检查 localStorage 中是否有之前存储的数据,如果有,则读取这些数据并重新构建表格。

3. 完整实现示例

下面是一个结合 localStorage 实现动态表格持久化的完整代码示例。

ChartGen
ChartGen

AI快速生成专业数据图表

下载

3.1 HTML 结构




  
  
  动态表格持久化示例
  



  

发布派对信息

3.2 JavaScript 代码 (script.js)

// 定义 localStorage 的键名,用于存储表格数据
const STORAGE_KEY = "pool_party_data_v1";

// 获取发布按钮
let publishButton = document.getElementById('publishButton');
// 获取表格容器
let tableContainer = document.getElementById('table-container');

/**
 * 创建或获取表格元素,并确保表头存在。
 * @param {boolean} isFirstTime 是否是首次创建表格(例如页面加载时)。
 * @returns {HTMLTableElement} 表格元素。
 */
function ensureTableStructure(isFirstTime) {
  let table = document.querySelector('table'); // 尝试获取现有表格

  if (!table) { // 如果表格不存在,则创建新表格
    table = document.createElement('table');
    tableContainer.appendChild(table); // 将表格添加到指定容器

    // 创建表头
    let headerRow = document.createElement('tr');
    const headers = [
      "派对名称", "开始时间", "结束时间", "地址", "容纳人数", "联系电话"
    ];
    headers.forEach(text => {
      let th = document.createElement('th');
      th.innerHTML = text;
      headerRow.appendChild(th);
    });
    table.appendChild(headerRow);
  }
  return table;
}

/**
 * 从 localStorage 加载并渲染表格数据。
 */
function loadAndRenderTableData() {
  const storedData = localStorage.getItem(STORAGE_KEY);
  if (storedData) {
    let table = ensureTableStructure(true); // 确保表格和表头存在

    // 使用 '¬' 分隔符拆分存储的行数据
    const rowsHtml = storedData.split('¬');

    rowsHtml.forEach(rowHtml => {
      if (rowHtml.trim() !== '') { // 避免添加空行
        let newRow = document.createElement('tr');
        newRow.innerHTML = rowHtml; // 直接将存储的 HTML 字符串设置为行内容
        table.appendChild(newRow);
      }
    });
  }
}

// 页面加载时执行
document.addEventListener('DOMContentLoaded', () => {
  loadAndRenderTableData(); // 加载并渲染之前保存的表格数据
});


// 监听发布按钮的点击事件
publishButton.addEventListener("click", (event) => {
  event.preventDefault(); // 阻止表单默认提交行为,如果按钮在 form 内部

  // 获取表单数据
  let nom = document.getElementById("nom").value.trim();
  let adresse = document.getElementById("adresse").value.trim();
  let capacite = document.getElementById("capacite").value.trim();
  let phone = document.getElementById("phone").value.trim();
  let heure1 = document.getElementById("heure1").value.trim();
  let heure2 = document.getElementById("heure2").value.trim();

  // 验证必填字段
  if (nom === "" || adresse === "" || capacite === "" || heure1 === "" || heure2 === "") {
    alert("请填写所有必填信息!");
    return;
  }

  // 确保表格结构存在
  let table = ensureTableStructure(false);

  // 创建新的数据行
  let newRow = document.createElement('tr');
  const rowData = [nom, heure1, heure2, adresse, capacite, phone];

  rowData.forEach(data => {
    let td = document.createElement('td');
    td.innerHTML = data;
    newRow.appendChild(td);
  });

  // 将新行添加到表格
  table.appendChild(newRow);

  // 将新行的 innerHTML 存储到 localStorage
  let currentStoredRows = localStorage.getItem(STORAGE_KEY) || '';
  // 使用特殊字符 '¬' 作为分隔符,避免与 HTML 内容冲突
  let updatedStoredRows = currentStoredRows + '¬' + newRow.innerHTML;
  localStorage.setItem(STORAGE_KEY, updatedStoredRows);

  alert("表单已提交并保存!");

  // 清空表单字段以便下次输入
  document.getElementById("nom").value = '';
  document.getElementById("adresse").value = '';
  document.getElementById("capacite").value = '';
  document.getElementById("phone").value = '';
  document.getElementById("heure1").value = '';
  document.getElementById("heure2").value = '';
});

// 可选:添加一个清除 localStorage 的按钮,用于测试或重置
// let clearButton = document.createElement('button');
// clearButton.textContent = '清除所有数据';
// clearButton.addEventListener('click', () => {
//   localStorage.removeItem(STORAGE_KEY);
//   tableContainer.innerHTML = ''; // 清空表格显示
//   alert('所有数据已清除!');
// });
// document.body.appendChild(clearButton);

4. 代码解析与注意事项

4.1 ensureTableStructure 函数

这个函数负责检查页面上是否存在表格。如果不存在,它会创建一个新的

元素并添加表头 ( 元素,并将其 innerHTML 设置为存储的片段,然后添加到表格中。

4.3 publishButton 事件监听器

当用户点击“发布”按钮时:

  1. event.preventDefault():阻止按钮的默认行为(例如,如果按钮在一个
    标签内,它可能会导致页面刷新)。
  2. 获取所有表单字段的值。
  3. 进行基本的输入验证。
  4. 调用 ensureTableStructure 确保表格存在。
  5. 创建一个新的
元素,并用表单数据填充 元素的 innerHTML。这对于简单的表格行来说是有效的。对于更复杂的数据结构(例如包含事件监听器或复杂对象),建议使用 JSON.stringify() 将 JavaScript 对象转换为 JSON 字符串进行存储,并在读取时使用 JSON.parse() 转换回对象。
// 存储对象示例
const partyData = {
  nom: nom,
  adresse: adresse,
  capacite: capacite,
  phone: phone,
  heure1: heure1,
  heure2: heure2
};
let allParties = JSON.parse(localStorage.getItem(STORAGE_KEY) || '[]');
allParties.push(partyData);
localStorage.setItem(STORAGE_KEY, JSON.stringify(allParties));

// 读取对象示例
const storedParties = JSON.parse(localStorage.getItem(STORAGE_KEY) || '[]');
storedParties.forEach(party => {
  // 根据 party 对象的内容重新构建表格行
});

使用 JSON 存储数据,可以更灵活地处理数据,例如编辑或删除特定行。

4.5 localStorage 的局限性

  • 存储容量: 大多数浏览器对 localStorage 的存储容量有限制,通常为 5MB 到 10MB。不适合存储大量数据。
  • 同步操作: localStorage 的操作是同步的,这意味着在读写数据时会阻塞主线程。频繁或大量操作可能导致页面卡顿。
  • 安全性: localStorage 中的数据没有加密,容易受到跨站脚本 (XSS) 攻击。不应存储敏感信息。
  • 仅限字符串: localStorage 只能存储字符串。存储 JavaScript 对象时需要进行序列化(如 JSON.stringify())。

5. 总结

通过 localStorage,我们可以轻松实现前端动态生成内容的持久化,确保用户数据在页面刷新后不会丢失,从而显著提升用户体验。在设计持久化方案时,应根据数据的复杂度和数量选择合适的存储策略,并注意 localStorage 的容量和安全限制。对于更复杂或大量的数据存储需求,可以考虑使用 IndexedDB 或将数据发送到后端服务器进行持久化。

)。这保证了无论是在页面加载时恢复数据,还是在用户首次提交数据时,表格结构都能正确地被创建。

4.2 loadAndRenderTableData 函数

在 DOMContentLoaded 事件(即页面 DOM 完全加载后)中调用此函数。它会:

  1. 从 localStorage 中获取存储的字符串。
  2. 如果存在数据,则调用 ensureTableStructure 来确保表格和表头已准备好。
  3. 使用自定义分隔符 '¬' 将存储的字符串拆分成单个表格行的 HTML 内容。
  4. 遍历这些 HTML 片段,为每个片段创建一个新的
元素。
  • 将新行添加到 DOM 中的表格。
  • 持久化操作:
    • 获取 localStorage 中当前存储的所有行数据。如果为空,则初始化为空字符串。
    • 将新行的 innerHTML 附加到现有数据中,并使用 '¬' 作为分隔符。这个分隔符的选择很重要,它应该是一个不太可能出现在实际 HTML 内容中的字符,以避免解析错误。
    • 将更新后的字符串重新存回 localStorage。
  • 清空表单字段,方便用户继续输入。
  • 4.4 数据序列化与反序列化

    在这个例子中,我们直接存储了

    相关专题

    更多
    js获取数组长度的方法
    js获取数组长度的方法

    在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

    554

    2023.06.20

    js刷新当前页面
    js刷新当前页面

    js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

    374

    2023.07.04

    js四舍五入
    js四舍五入

    js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

    731

    2023.07.04

    js删除节点的方法
    js删除节点的方法

    js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

    477

    2023.09.01

    JavaScript转义字符
    JavaScript转义字符

    JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

    394

    2023.09.04

    js生成随机数的方法
    js生成随机数的方法

    js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

    990

    2023.09.04

    如何启用JavaScript
    如何启用JavaScript

    JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

    656

    2023.09.12

    Js中Symbol类详解
    Js中Symbol类详解

    javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

    551

    2023.09.20

    Golang gRPC 服务开发与Protobuf实战
    Golang gRPC 服务开发与Protobuf实战

    本专题系统讲解 Golang 在 gRPC 服务开发中的完整实践,涵盖 Protobuf 定义与代码生成、gRPC 服务端与客户端实现、流式 RPC(Unary/Server/Client/Bidirectional)、错误处理、拦截器、中间件以及与 HTTP/REST 的对接方案。通过实际案例,帮助学习者掌握 使用 Go 构建高性能、强类型、可扩展的 RPC 服务体系,适用于微服务与内部系统通信场景。

    8

    2026.01.15

    热门下载

    更多
    网站特效
    /
    网站源码
    /
    网站素材
    /
    前端模板

    精品课程

    更多
    相关推荐
    /
    热门推荐
    /
    最新课程
    Sass 教程
    Sass 教程

    共14课时 | 0.8万人学习

    Bootstrap 5教程
    Bootstrap 5教程

    共46课时 | 2.9万人学习

    CSS教程
    CSS教程

    共754课时 | 19.2万人学习

    关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
    php中文网:公益在线php培训,帮助PHP学习者快速成长!
    关注服务号 技术交流群
    PHP中文网订阅号
    每天精选资源文章推送

    Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号