React MUI X：实现无输入框的日期选择器弹窗-js教程-PHP中文网

React MUI X：实现无输入框的日期选择器弹窗

DDD

发布： 2025-10-18 10:52:25

原创

910人浏览过

React MUI X：实现无输入框的日期选择器弹窗

本教程将指导您如何在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<HTMLButtonElement | null>(
    null
  );

  // 按钮点击事件处理函数，设置锚点为当前按钮
  const handleClick = (event: React.MouseEvent<HTMLButtonElement>) => {
    setAnchorEl(event.currentTarget);
  };

  // Popover 关闭事件处理函数，清除锚点
  const handleClose = () => {
    setAnchorEl(null);
  };

  // 判断 Popover 是否打开
  const open = Boolean(anchorEl);
  // 为 Popover 生成一个唯一的 ID，用于无障碍访问
  const id = open ? "date-picker-popover" : undefined;

  return (
    <div>
      <Button aria-describedby={id} variant="contained" onClick={handleClick}>
        打开日期选择器
      </Button>
      <Popover
        id={id}
        open={open}
        anchorEl={anchorEl}
        onClose={handleClose}
        anchorOrigin={{
          vertical: "bottom",
          horizontal: "left"
        }}
        transformOrigin={{
          vertical: "top",
          horizontal: "left"
        }}
      >
        {/* MUI X Date Pickers 组件必须包裹在 LocalizationProvider 中 */}
        <LocalizationProvider dateAdapter={AdapterDayjs}>
          <StaticDatePicker
            // 默认选中日期，可以根据需求修改或移除
            defaultValue={dayjs("2023-10-26")}
            // 监听日期选择事件，获取选中的日期
            onChange={(newValue) => {
              console.log("Selected date:", newValue?.format("YYYY-MM-DD"));
              // 在此处可以处理选中的日期，例如更新父组件状态
              handleClose(); // 选择日期后自动关闭 Popover
            }}
          />
        </LocalizationProvider>
      </Popover>
    </div>
  );
}

登录后复制

代码解析

状态管理:
- anchorEl: 一个useState变量，用于存储Popover所锚定的DOM元素。当按钮被点击时，handleClick函数将按钮本身（event.currentTarget）设置为anchorEl，从而触发Popover的显示。
- open: 一个布尔值，通过Boolean(anchorEl)判断anchorEl是否存在来控制Popover的open属性，决定其显示或隐藏。
- id: 为Popover生成一个唯一的ID，用于aria-describedby属性，增强无障碍性。
触发按钮:

X Studio
网易云音乐·X Studio

91

查看详情
- 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:
- MUI X Date Pickers组件（包括StaticDatePicker）必须被包裹在LocalizationProvider中，并传入一个日期适配器（如AdapterDayjs）。这是为了确保日期组件能够正确处理日期对象的格式化、解析和本地化。
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属性，以精细控制其弹出位置。