You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何使用MUI DatePicker的desktopModeMediaQuery属性?

Material UI desktopModeMediaQuery 属性使用指南

1. 是否需要导入?

不需要额外导入,desktopModeMediaQuery 是MUI X DatePicker系列组件(比如DatePicker、DateTimePicker)的内置props,直接在组件上传递即可。

2. 作用是什么?

它不是直接用于样式设置的属性,核心作用是定义触发DatePicker切换为「桌面模式」的媒体查询条件。默认情况下,MUI的DatePicker会在屏幕宽度≥900px时显示桌面版(带侧边日历面板的布局),小于该宽度则显示移动端版(弹窗式日历)。通过自定义这个props,你可以修改切换的触发条件,甚至强制所有屏幕尺寸都显示桌面版/移动端版。

3. 使用示例

示例1:强制所有屏幕显示桌面版(满足你的移动端需求)

如果想让包括移动端在内的所有设备都显示PC版DatePicker,只需将desktopModeMediaQuery设为一个永远为真的媒体查询,比如'(min-width: 0px)':

import { DatePicker } from '@mui/x-date-pickers/DatePicker';
import { LocalizationProvider } from '@mui/x-date-pickers/LocalizationProvider';
import { AdapterDayjs } from '@mui/x-date-pickers/AdapterDayjs';

export default function ForceDesktopDatePicker() {
  return (
    <LocalizationProvider dateAdapter={AdapterDayjs}>
      <DatePicker
        label="强制桌面版日期选择器"
        desktopModeMediaQuery="(min-width: 0px)" // 所有宽度都触发桌面模式
      />
    </LocalizationProvider>
  );
}

示例2:自定义切换宽度阈值

比如想在屏幕宽度≥600px时就显示桌面版,只需修改媒体查询值:

<DatePicker
  label="自定义切换阈值的日期选择器"
  desktopModeMediaQuery="(min-width: 600px)"
/>

4. 补充说明

  • 媒体查询语法遵循标准CSS媒体查询规则,你可以根据需求写任意合法的查询语句(比如基于屏幕方向、分辨率等)。
  • 这个属性适用于MUI X的所有日期/时间选择器组件,包括DateTimePicker、TimePicker等。

内容的提问来源于stack exchange,提问作者Happy1234

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.02 10:20:38