本教程详细指导如何使用 jquery ui datepicker 实现仅选择月份和年份的功能，并构建一个联动日期范围选择器。文章将涵盖必要的库文件引入、html结构、关键的javascript配置（包括 `onclose` 事件处理和 `dateformat` 设置），以及如何通过 css 隐藏日历视图。此外，还将介绍如何实现“开始日期”和“结束日期”之间的联动校验，确保用户选择的日期范围逻辑正确，同时支持本地文件引入而非cdn。
一、引言与核心概念
在许多业务场景中，我们可能只需要用户选择特定的月份和年份，而非具体的某一天。jQuery UI Datepicker 是一个功能强大的日期选择器组件，通过巧妙的配置和事件处理，可以轻松实现这一需求。本教程将展示如何配置 Datepicker 以仅显示月份和年份选择器，并结合“开始日期”和“结束日期”的联动校验功能。
实现此功能的核心在于以下几个 jQuery UI Datepicker 选项：
changeMonth: true 和 changeYear: true：启用月份和年份的下拉选择器。showButtonPanel: true：显示底部按钮面板，通常包含“今天”和“完成”按钮，这对于月份/年份选择模式很有用。dateFormat: ‘mm-yy’：设置输入框中日期的显示格式，例如“01-2023”。onClose 事件：这是最关键的部分。当 Datepicker 关闭时，我们需要手动从其内部的月份和年份下拉框中获取用户选择的值，然后使用这些值来设置输入框的最终日期。CSS 样式：通过简单的 CSS 规则隐藏日历中的日期部分，进一步强化只选择月份和年份的意图。
二、环境准备：引入必要的库文件
要使用 jQuery UI Datepicker，您需要引入 jQuery 库、jQuery UI JavaScript 文件以及 jQuery UI 的 CSS 样式表。为了满足不使用 CDN 的需求，您可以将这些文件下载到本地项目目录中。
以下是您需要下载并引入的三个文件（您可以右键点击链接并选择“另存为”）：
jQuery 库: https://www.php.cn/link/a6a2b3e3c6569e69afe1e025d0ff8d1fjQuery UI JavaScript: https://www.php.cn/link/6508deb7d1b89059767d5af370618046jQuery UI 基础主题 CSS: https://www.php.cn/link/b1e895366dfa5d6a2b31a21ecfc5efe3
将这些文件下载到您的项目目录（例如，js/ 和 css/ 文件夹）后，在您的 HTML 文件的
或 底部引入它们：
请将 path/to/ 替换为您实际的文件路径。
三、HTML 结构
我们将创建两个输入框，分别用于选择“开始日期”和“结束日期”。
开始日期 :
结束日期 :
这里我们使用了 id=”datepicker1″ 和 id=”datepicker2″ 来标识这两个输入框，以便在 JavaScript 中进行初始化和操作。
四、JavaScript 配置：实现月份和年份选择及日期联动
现在，我们将使用 jQuery UI Datepicker 对这两个输入框进行初始化，并添加只选择月份和年份的逻辑，以及日期范围的联动校验。
$(function() { // 初始化“开始日期”选择器 $('#datepicker1').datepicker({ changeMonth: true, // 允许选择月份 changeYear: true, // 允许选择年份 showButtonPanel: true, // 显示按钮面板，包含“完成”按钮 dateFormat: 'mm-yy', // 设置日期格式为“月-年” onClose: function(dateText, inst) { // 当日期选择器关闭时触发 // 获取用户从下拉框中选择的月份和年份 var month = $("#ui-datepicker-div .ui-datepicker-month :selected").val(); var year = $("#ui-datepicker-div .ui-datepicker-year :selected").val(); // 创建一个日期对象，设置为所选月份的第一天 var selectedDate = new Date(year, month, 1); // 将输入框的值设置为所选的月份和年份 $(this).datepicker('setDate', selectedDate); // 更新“结束日期”选择器的最小可选日期 $('#datepicker2').datepicker('option', 'minDate', selectedDate); // 如果“结束日期”当前值早于“开始日期”，则重置“结束日期”为“开始日期” var toDate = $('#datepicker2').datepicker('getDate'); if (toDate && toDate selectedDate) { $('#datepicker1').datepicker('setDate', selectedDate); } } });});
代码解析：
$(function() { … });: 这是 jQuery 的简写形式，确保在 DOM 加载完成后执行代码。changeMonth: true, changeYear: true: 启用日期选择器顶部的月份和年份下拉菜单，允许用户直接选择。showButtonPanel: true: 启用底部面板，当用户选择完月份和年份后，点击“完成”按钮即可关闭并设置日期。dateFormat: ‘mm-yy’: 指定输入框中日期的显示格式为“月-年”。onClose: function(dateText, inst) { … }: 这是实现只选择月份和年份的关键。$(“#ui-datepicker-div .ui-datepicker-month :selected”).val() 和 $(“#ui-datepicker-div .ui-datepicker-year :selected”).val()：在 Datepicker 关闭时，我们直接从其内部生成的 HTML 元素中获取用户选择的月份和年份值。var selectedDate = new Date(year, month, 1);：创建一个新的 Date 对象，将其设置为所选月份的第一天。这是因为 jQuery UI Datepicker 内部仍然需要一个完整的日期对象。$(this).datepicker(‘setDate’, selectedDate);：将输入框的日期设置为我们构造的 selectedDate。日期范围联动 (minDate / maxDate 选项):在 datepicker1 的 onClose 中，$(‘#datepicker2’).datepicker(‘option’, ‘minDate’, selectedDate); 将“结束日期”的最小可选日期设置为“开始日期”的所选日期。在 datepicker2 的 onClose 中，$(‘#datepicker1’).datepicker(‘option’, ‘maxDate’, selectedDate); 将“开始日期”的最大可选日期设置为“结束日期”的所选日期。额外的 if (toDate && toDate selectedDate) 逻辑用于确保在用户更改日期导致范围不合法时，自动调整另一个日期，保持日期范围的有效性。
五、CSS 样式：隐藏日历中的日期
为了确保用户界面只显示月份和年份选择器，我们需要添加一条简单的 CSS 规则来隐藏日历中的日期表格。
.ui-datepicker-calendar { display: none;}
将这段 CSS 代码添加到您的样式表文件（例如 style.css）中，或者直接放在 HTML 文件的
标签内的 块中。
六、总结与注意事项
通过以上步骤，您已经成功实现了一个仅选择月份和年份的 jQuery UI Datepicker，并具备了“开始日期”和“结束日期”的联动校验功能。
注意事项：库文件路径: 确保您引入的 jQuery、jQuery UI JavaScript 和 CSS 文件的路径是正确的。版本兼容性: 本教程使用的 jQuery UI 版本是 1.13.2。不同版本之间可能存在细微的 API 差异，但核心概念通常保持一致。用户体验: 尽管我们隐藏了日期部分，但 Datepicker 内部仍然处理完整的日期对象。onClose 事件中的逻辑确保了输入框最终显示的是用户期望的月份和年份。国际化: 如果您的应用需要支持多种语言，可以查阅 jQuery UI Datepicker 的国际化选项 ($.datepicker.regional) 来配置月份名称、年份格式等。替代方案: 除了 jQuery UI，还有其他日期选择器库（如 Bootstrap Datepicker、flatpickr 等）也提供了类似的功能，它们可能有不同的实现方式和配置选项。本教程专注于使用 jQuery UI。
以上就是使用 jQuery UI Datepicker 实现月份和年份选择教程的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1593382.html
微信扫一扫 
支付宝扫一扫 
