本教程将指导您如何在react mui x中创建一个不带文本输入框的日期选择器。通过结合使用staticdatepicker和popover组件，我们可以实现一个仅显示日历、由按钮触发的模态化日期选择功能，完美满足仅需选择日期而无需显示输入字段的场景需求。
在许多Web应用场景中，我们可能需要用户选择一个日期，但又不希望显示传统的文本输入框。例如，一个预订系统可能希望用户点击一个按钮后直接弹出一个日历，供其直观地选择日期，而不是通过输入框手动键入。虽然MUI X的日期选择器提供了多种配置，但要直接隐藏输入框并同时实现模态化的弹出行为，需要一些特定的组合。
解决方案：StaticDatePicker 结合 Popover
为了满足这种需求，MUI X提供了StaticDatePicker组件，它本身不包含任何输入框，仅展示日历视图。结合MUI的Popover组件，我们可以将StaticDatePicker封装在一个浮层中，使其在点击按钮后像一个模态框一样弹出。
- StaticDatePicker: 这是解决方案的核心。它是一个纯粹的日历视图组件，不附带任何输入字段。
- Popover: MUI提供的一个临时浮层组件，可以锚定到任何DOM元素。它非常适合用来承载StaticDatePicker，并提供模态化的弹出和关闭行为。
实现步骤与代码示例
以下是一个完整的React组件示例，演示了如何通过点击按钮来打开一个包含StaticDatePicker的Popover。
import React from "react";
import Button from "@mui/material/Button";
import Popover from "@mui/material/Popover";
import { AdapterDayjs } from "@mui/x-date-pickers/AdapterDayjs";
import { LocalizationProvider } from "@mui/x-date-pickers/LocalizationProvider";
import { StaticDatePicker } from "@mui/x-date-pickers/StaticDatePicker";
import dayjs from "dayjs"; // 确保已安装 dayjs
export default function DatePickerPopOver() {
// 用于控制 Popover 的锚点元素
const [anchorEl, setAnchorEl] = React.useState(
null
);
// 按钮点击事件处理函数，设置锚点为当前按钮
const handleClick = (event: React.MouseEvent) => {
setAnchorEl(event.currentTarget);
};
// Popover 关闭事件处理函数，清除锚点
const handleClose = () => {
setAnchorEl(null);
};
// 判断 Popover 是否打开
const open = Boolean(anchorEl);
// 为 Popover 生成一个唯一的 ID，用于无障碍访问
const id = open ? "date-picker-popover" : undefined;
return (
{/* MUI X Date Pickers 组件必须包裹在 LocalizationProvider 中 */}
{
console.log("Selected date:", newValue?.format("YYYY-MM-DD"));
// 在此处可以处理选中的日期，例如更新父组件状态
handleClose(); // 选择日期后自动关闭 Popover
}}
/>
);
} 代码解析
-
状态管理:
- anchorEl: 一个useState变量，用于存储Popover所锚定的DOM元素。当按钮被点击时，handleClick函数将按钮本身（event.currentTarget）设置为anchorEl，从而触发Popover的显示。
- open: 一个布尔值，通过Boolean(anchorEl)判断anchorEl是否存在来控制Popover的open属性，决定其显示或隐藏。
- id: 为Popover生成一个唯一的ID，用于aria-describedby属性，增强无障碍性。
-
触发按钮:
- Button: 一个MUI按钮，通过onClick事件调用handleClick函数来打开Popover。aria-describedby属性指向Popover的id，有助于屏幕阅读器理解组件之间的关联。
-
Popover 组件:
- id: 与按钮的aria-describedby属性相匹配，提供无障碍支持。
- open: 绑定到open状态变量，控制Popover的可见性。
- anchorEl: 绑定到anchorEl状态变量，指定Popover应该锚定到哪个元素。
- onClose: 当用户点击Popover外部区域或按下Esc键时触发的回调函数，调用handleClose来关闭Popover。
- anchorOrigin 和 transformOrigin: 这两个属性共同决定了Popover相对于锚点元素的位置。anchorOrigin定义锚点元素的哪个点与Popover的哪个点对齐（例如，anchorOrigin={{ vertical: "bottom", horizontal: "left" }}表示锚点元素的左下角）。transformOrigin定义Popover自身的哪个点将与anchorOrigin对齐（例如，transformOrigin={{ vertical: "top", horizontal: "left" }}表示Popover的左上角）。
-
LocalizationProvider:
-
StaticDatePicker:
- defaultValue: 可选属性，用于设置日历最初选中的日期。
- onChange: 当用户在日历中选择一个日期时触发的回调函数。newValue参数将包含选中的日期值。在此回调中，你可以处理选中的日期，例如更新组件状态、将日期传递给父组件，或者像示例中那样，在选择日期后自动调用handleClose()来关闭Popover，提供更流畅的用户体验。
注意事项与最佳实践
-
安装依赖: 确保你的项目中已经安装了所有必需的MUI X组件和日期库依赖，例如：
npm install @mui/material @emotion/react @emotion/styled @mui/x-date-pickers dayjs # 或者 yarn add @mui/material @emotion/react @emotion/styled @mui/x-date-pickers dayjs
- 日期库选择: LocalizationProvider支持多种日期库，如dayjs、moment、luxon等。根据项目需求选择合适的日期库，并安装对应的适配器。
- 状态管理: 在实际应用中，你可能需要将StaticDatePicker选中的日期存储在组件的内部状态中，或者通过回调函数将其传递给父组件进行进一步处理。
- 用户体验: 考虑在用户选择日期后自动关闭Popover，这通常通过在StaticDatePicker的onChange回调中调用handleClose()来实现，可以显著提升用户体验。
- 定位调整: 根据UI设计和用户交互习惯，可以灵活调整Popover的anchorOrigin和transformOrigin属性，以精细控制其弹出位置。
总结
通过巧妙地结合MUI X的StaticDatePicker和Popover组件，我们可以轻松实现一个不带文本输入框、由按钮触发的日期选择器弹窗。这种方法不仅解决了特定UI/UX需求，还充分利用了MUI组件的模块化和可配置性，为开发者提供了一个强大而灵活的解决方案。
