首页经验JavaScript日程调度器:实现数据本地存储与页面持久化

JavaScript日程调度器:实现数据本地存储与页面持久化

圆圆2025-11-17 11:01:12次浏览条评论

JavaScript日程调度器:实现数据本地存储与页面持久化

本教程详细讲解如何利用javascript和web storage api(`localstorage`)为日程调度器实现事件数据的本地存储与页面重载后的持久化。通过优化数据结构、实现加载与保存逻辑,并结合时间块的动态样式更新,确保用户输入的信息能够可靠地保存并在下次访问时自动恢复,提升用户体验。

引言

构建一个实用的日程调度器,除了展示当前时间、根据时间段动态改变样式外,最核心的功能之一就是数据的持久化。用户输入的日程事件应该在页面刷新或关闭浏览器后依然存在,以便下次访问时能够继续查看和编辑。本教程将深入探讨如何利用浏览器提供的Web Storage API,特别是localStorage,来实现这一关键功能,并提供一个优化后的完整代码示例。

Web Storage API 基础

Web Storage API 提供了一种机制,允许网站在用户浏览器中存储键值对数据。它包括 localStorage 和 sessionStorage 两种对象。

localStorage: 存储的数据没有过期时间,会一直保留,直到被用户手动清除或通过代码删除。数据在多个浏览器窗口和标签页之间共享。sessionStorage: 存储的数据仅在当前会话(浏览器标签页或窗口)有效。一旦标签页或窗口关闭,数据就会被清除。

对于日程调度器这种需要长期保存用户数据的功能,localStorage 是理想的选择。

localStorage 的基本操作

localStorage 提供了以下几个核心方法:

立即学习“Java免费学习笔记(深入)”;

localStorage.setItem(key, value): 将数据保存到 localStorage。key 和 value 都必须是字符串。localStorage.getItem(key): 从 localStorage 获取指定 key 的数据。如果 key 不存在,返回 null。localStorage.removeItem(key): 从 localStorage 删除指定 key 的数据。localStorage.clear(): 清空 localStorage 中所有保存的数据。

重要提示: localStorage 只能存储字符串。如果需要存储 JavaScript 对象或数组,必须先使用 JSON.stringify() 将其转换为 JSON 字符串,读取时再使用 JSON.parse() 将其转换回 JavaScript 对象。

项目结构概览

为了更好地理解和实现数据持久化,我们首先回顾日程调度器的基本HTML和CSS结构,以及所需的JavaScript库。

HTML 结构

日程调度器通常由一系列时间块组成,每个时间块包含:

一个显示时间(例如 "8AM")的区域。一个用于输入事件描述的 <textarea> 元素。一个用于保存事件的按钮。

每个时间块和 textarea 都应有唯一的ID或 data- 属性,以便于JavaScript操作。例如:

<div id="hour-1" data-hour="8" class="row time-block">  <div class="col-1 hour">8AM</div>  <textarea id="8AM" class="col-md-10 description"></textarea>  <button class="col-1 saveBtn btn"><i class="fas fa-save"></i></button></div><!-- 更多时间块... -->
登录后复制

这里,textarea 的 id (如 "8AM") 将作为我们存储事件的键。

CSS 样式

CSS主要负责布局和根据时间动态改变时间块的背景颜色,以区分“过去”、“现在”和“未来”事件。例如:

腾讯智影-AI数字人 腾讯智影-AI数字人

基于AI数字人能力,实现7*24小时AI数字人直播带货,低成本实现直播业务快速增增,全天智能在线直播

腾讯智影-AI数字人 73 查看详情 腾讯智影-AI数字人
.past {  background-color: #d3d3d3; /* 灰色 */}.present {  background-color: #ff6961; /* 红色 */}.future {  background-color: #77dd77; /* 绿色 */}
登录后复制JavaScript 依赖

本项目依赖 jQuery 简化DOM操作,以及 Moment.js 处理日期和时间。

<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.2.1/jquery.min.js"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/moment.js/2.24.0/moment.min.js"></script>
登录后复制核心实现:数据持久化

实现数据持久化的关键在于:在页面加载时从 localStorage 读取数据并显示,在用户保存时将数据写入 localStorage。

优化数据存储结构

原始代码尝试将事件存储为一个数组,每次保存都 push 一个新对象。这种方式会导致数据冗余和管理复杂。更优化的方法是使用一个JavaScript对象作为存储结构,其中键是 textarea 的ID(例如 "8AM", "9AM"),值是用户输入的事件描述。

// 示例:优化的数据结构// {//   "8AM": "团队晨会",//   "9AM": "代码审查",//   "10AM": "项目规划"// }
登录后复制

这种键值对结构使得通过 textarea ID 快速查找、更新和删除事件变得非常高效。

数据加载与显示

在页面初始化时,我们需要执行以下步骤:

从 localStorage 中尝试获取存储的事件数据。如果数据存在,将其从 JSON 字符串解析回 JavaScript 对象。遍历页面上所有的 textarea 元素,根据其ID从解析后的数据对象中查找对应的事件描述。将找到的事件描述填充到相应的 textarea 的 value 属性中。
// script.js$(document).ready(function() {    // ... 其他初始化代码 (时钟显示) ...    // 1. 初始化日程数据:从 localStorage 读取,如果不存在则为空对象    let scheduleData = JSON.parse(localStorage.getItem("workday-scheduler-events")) || {};    // 2. 加载并显示数据到文本区域    function loadAndDisplaySchedule() {        $(".description").each(function() {            const textareaId = $(this).attr("id"); // 获取 textarea 的 ID (例如 "8AM")            if (scheduleData[textareaId]) { // 如果该时间段有保存的事件                $(this).val(scheduleData[textareaId]); // 填充到 textarea            }        });    }    // 在页面加载完成后立即执行    loadAndDisplaySchedule();    // ... 其他代码 (保存事件、更新时间块颜色) ...});
登录后复制数据保存逻辑

当用户点击某个时间块旁边的保存按钮时,我们需要执行以下步骤:

获取当前点击按钮对应的 textarea 元素的ID和用户输入的值。更新内存中的 scheduleData 对象:如果输入值不为空,则将该值存储到 scheduleData 中对应的键下;如果输入值为空,则从 scheduleData 中删除该键,表示清空事件。将更新后的 scheduleData 对象转换成 JSON 字符串,并保存回 localStorage。
// script.js$(document).ready(function() {    // ... 时钟显示和数据加载代码 ...    // 封装保存数据到 localStorage 的函数    function saveScheduleData() {        localStorage.setItem("workday-scheduler-events", JSON.stringify(scheduleData));    }    // 3. 监听保存按钮的点击事件    $(".saveBtn").on("click", function() {        const textarea = $(this).siblings(".description"); // 获取与按钮同级的 textarea        const textareaId = textarea.attr("id");        const inputValue = textarea.val().trim(); // 获取输入值并去除首尾空格        if (inputValue !== "") {            scheduleData[textareaId] = inputValue; // 更新或添加事件        } else {            delete scheduleData[textareaId]; // 如果输入为空,则删除该事件        }        saveScheduleData(); // 保存更新后的数据到 localStorage        // 可选:提供用户保存反馈        const saveIcon = $(this).find("i");        saveIcon.removeClass("fas fa-save").addClass("fas fa-check").css("color", "green");        setTimeout(() => {            saveIcon.removeClass("fas fa-check").addClass("fas fa-save").css("color", "white");        }, 1000);    });    // ... 其他代码 (更新时间块颜色) ...});
登录后复制完整 JavaScript 代码示例

结合上述逻辑,以下是 script.js 的完整优化代码:

// script.js$(document).ready(function() {    // 实时时钟显示    const clock = $("#clock");    setInterval(() => {        const now = moment();        const readable = now.format("dddd, MMMM Do YYYY, h:mm:ss a");        clock.text(readable);        // 每秒更新时钟,但时间块颜色不需要每秒更新        // 如果需要每秒更新时间块颜色,可以将 updateTimeBlockColors() 放在这里    }, 1000);    // 1. 初始化日程数据:从 localStorage 读取,如果不存在则为空对象    let scheduleData = JSON.parse(localStorage.getItem("workday-scheduler-events")) || {};    // 封装保存数据到 localStorage 的函数    function saveScheduleData() {        localStorage.setItem("workday-scheduler-events", JSON.stringify(scheduleData));    }    // 2. 加载并显示数据到文本区域    function loadAndDisplaySchedule() {        $(".description").each(function() {            const textareaId = $(this).attr("id");            if (scheduleData[textareaId]) {                $(this).val(scheduleData[textareaId]);            }        });    }    // 3. 监听保存按钮的点击事件    $(".saveBtn").on("click", function() {        const textarea = $(this).siblings(".description");        const textareaId = textarea.attr("id");        const inputValue = textarea.val().trim();        if (inputValue !== "") {            scheduleData[textareaId] = inputValue;        } else {            delete scheduleData[textareaId]; // 如果输入为空,则删除该事件        }        saveScheduleData();        // 提供用户保存反馈        const saveIcon = $(this).find("i");        saveIcon.removeClass("fas fa-save").addClass("fas fa-check").css("color", "green");        setTimeout(() => {            saveIcon.removeClass("fas fa-check").addClass("fas fa-save").css("color", "white");        }, 1000);    });    // 4. 更新时间块的颜色 (过去、现在、未来)    function updateTimeBlockColors() {        const currentHour = moment().hour(); // 获取当前小时 (0-23)        $(".time-block").each(function() {            const blockHour = parseInt($(this).attr("data-hour")); // 获取时间块的 data-hour (8, 9, ..., 17)            $(this).removeClass("past present future"); // 清除现有样式            if (blockHour < currentHour) {                $(this).addClass("past");            } else if (blockHour === currentHour) {                $(this).addClass("present");            } else {                $(this).addClass("future");            }        });    }    // 页面加载时执行    loadAndDisplaySchedule();    updateTimeBlockColors();    // 每隔一段时间(例如每分钟)更新时间块颜色,确保实时性    setInterval(updateTimeBlockColors, 60 * 1000);});
登录后复制时间块动态样式更新

除了数据持久化,日程调度器还需要根据当前时间动态调整时间块的样式。这部分逻辑在 updateTimeBlockColors 函数中实现:

获取当前的小时数(使用 moment().hour())。遍历所有的 .time-block 元素。对于每个时间块,获取其 data-hour 属性值,表示该时间块对应的小时。比较 data-hour 与当前小时:如果 blockHour < currentHour,则添加 past 类。如果 blockHour === currentHour,则添加 present 类。如果 blockHour > currentHour,则添加 future 类。为了确保样式实时更新,我们使用 setInterval 每分钟调用一次 updateTimeBlockColors 函数。注意事项与最佳实践localStorage 键名: 使用描述性强且不易冲突的键名,例如 "workday-scheduler-events",避免与其他应用的数据混淆。错误处理: JSON.parse() 在尝试解析非JSON字符串时会抛出错误。在实际项目中,可以将其包裹在 try...catch 块中,以增加健壮性。在本教程的示例中,|| {} 这种写法已经处理了 localStorage.getItem() 返回 null 的情况,但对于非法JSON字符串仍需额外处理。用户反馈: 保存操作后提供视觉反馈(例如保存按钮图标变化),能显著提升用户体验,告知用户操作已成功。数据清理: 当用户清空 textarea 并点击保存时,我们应该从 scheduleData 中删除对应的事件,而不是存储一个空字符串。示例代码中已通过 delete scheduleData[textareaId] 实现。性能: localStorage 适合存储少量数据(通常限制在5-10MB),对于大型数据集合应考虑其他存储方案(如 IndexedDB)。对于日程调度器,通常数据量不大,localStorage 足以胜任。总结

通过本教程,我们学习了如何利用 Web Storage API (localStorage) 为日程调度器实现数据的本地存储和页面重载后的持久化。关键步骤包括:选择合适的存储机制、优化数据结构(使用键值对对象)、实现页面加载时的数据读取和显示,以及用户操作时的数据保存。结合动态时间块样式更新,我们构建了一个功能完善且用户友好的日程调度应用。掌握这些技术对于开发任何需要客户端数据持久化的Web应用都至关重要。

以上就是JavaScript日程调度器:实现数据本地存储与页面持久化的详细内容,更多请关注乐哥常识网其它相关文章!

相关标签: css javascript java jquery html js json ajax 浏览器 session ai JavaScript json jquery css html NULL try catch 字符串 数据结构 delete JS 对象 事件 dom 大家都在看: Windows Edge中F12怎么同时调试HTML结构和CSS样式 Anki卡片CSS美化,HTML5标签背诵效率翻倍! FileZilla完美保持目录,HTML+CSS上传不乱套! 如何爱心代码html_HTML爱心图案(CSS/Canvas)代码实现方法 Mac Übersicht小部件实时显示HTML中CSS类名
JavaScript
美图秀秀软件下载免费安装移动白条 美图秀秀软件内找客服的方法
相关内容
发表评论

游客 回复需填写必要信息