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

聖光之護
发布: 2025-11-17 10:49:01
原创
232人浏览过

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 快速查找、更新和删除事件变得非常高效。

数据加载与显示

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

  1. 从 localStorage 中尝试获取存储的事件数据。
  2. 如果数据存在,将其从 JSON 字符串解析回 JavaScript 对象。
  3. 遍历页面上所有的 textarea 元素,根据其ID从解析后的数据对象中查找对应的事件描述。
  4. 将找到的事件描述填充到相应的 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();

    // ... 其他代码 (保存事件、更新时间块颜色) ...
});
登录后复制

数据保存逻辑

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

  1. 获取当前点击按钮对应的 textarea 元素的ID和用户输入的值。
  2. 更新内存中的 scheduleData 对象:如果输入值不为空,则将该值存储到 scheduleData 中对应的键下;如果输入值为空,则从 scheduleData 中删除该键,表示清空事件。
  3. 将更新后的 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 函数中实现:

  1. 获取当前的小时数(使用 moment().hour())。
  2. 遍历所有的 .time-block 元素。
  3. 对于每个时间块,获取其 data-hour 属性值,表示该时间块对应的小时。
  4. 比较 data-hour 与当前小时:
    • 如果 blockHour < currentHour,则添加 past 类。
    • 如果 blockHour === currentHour,则添加 present 类。
    • 如果 blockHour > currentHour,则添加 future 类。
  5. 为了确保样式实时更新,我们使用 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日程调度器:实现数据本地存储与页面持久化的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

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