本教程详细指导如何使用 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/a6a2b3e3c6569e69afe1e025d0ff8d1f
- jQuery UI JavaScript: https://www.php.cn/link/6508deb7d1b89059767d5af370618046
- jQuery UI 基础主题 CSS: https://www.php.cn/link/b1e895366dfa5d6a2b31a21ecfc5efe3
将这些文件下载到您的项目目录（例如，js/ 和 css/ 文件夹）后，在您的 HTML 文件的 <head> 或 <body> 底部引入它们：
<!-- 引入 jQuery 库 --> <script src="path/to/jquery.min.js"></script> <!-- 引入 jQuery UI JavaScript --> <script src="path/to/jquery-ui.min.js"></script> <!-- 引入 jQuery UI 样式表 --> <link rel="stylesheet" href="path/to/jquery-ui.css" />
请将 path/to/ 替换为您实际的文件路径。
三、HTML 结构
我们将创建两个输入框，分别用于选择“开始日期”和“结束日期”。
<div class="col-lg-3 col-sm-12"> <h4><b>开始日期 :</b></h4> <input type="text" class="form-control" name="f_date" id="datepicker1" required /> </div> <div class="col-lg-3 col-sm-12"> <h4><b>结束日期 :</b></h4> <input type="text" class="form-control" name="t_date" id="datepicker2" required/> </div>
这里我们使用了 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) {
$('#datepicker2').datepicker('setDate', selectedDate);
}
}
});
// 初始化“结束日期”选择器
$('#datepicker2').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);
// 更新“开始日期”选择器的最大可选日期
$('#datepicker1').datepicker('option', 'maxDate', selectedDate);
// 如果“开始日期”当前值晚于“结束日期”，则重置“开始日期”为“结束日期”
var fromDate = $('#datepicker1').datepicker('getDate');
if (fromDate && fromDate > 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) / if (fromDate && fromDate > selectedDate) 逻辑用于确保在用户更改日期导致范围不合法时，自动调整另一个日期，保持日期范围的有效性。
五、CSS 样式：隐藏日历中的日期
为了确保用户界面只显示月份和年份选择器，我们需要添加一条简单的 CSS 规则来隐藏日历中的日期表格。
.ui-datepicker-calendar {
display: none;
}将这段 CSS 代码添加到您的样式表文件（例如 style.css）中，或者直接放在 HTML 文件的 <head> 标签内的 <style> 块中。
六、总结与注意事项
通过以上步骤，您已经成功实现了一个仅选择月份和年份的 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。
