讲师中心 微信公众号
AI工具推荐 视频效率加速

如何在 MUI Select 的 MenuItem 中正确使用 Tooltip

落浩小哥_3416

落浩小哥_3416

发布时间:2026-01-26 14:40:14

|

818人浏览过

|

来源于php中文网

原创

如何在 MUI Select 的 MenuItem 中正确使用 Tooltip

在 mui(material ui)中,若将 tooltip 直接包裹 menuitem,会导致点击失效、选中状态无法更新;正确做法是将 tooltip 置于 menuitem 内部,并用 `

`(或其它可交互/渲染的 html 元素)包裹文本内容。

在使用 MUI 的 Select 组件时,为 MenuItem 添加 Tooltip 是一种常见需求——例如用于展示额外说明、字段含义或国际化提示。但若错误地将 Tooltip 作为 MenuItem 的父元素(如 <Tooltip><MenuItem>...</MenuItem></Tooltip>),会导致 MenuItem 失去原生点击事件绑定能力,从而无法触发 onChange 回调,选择项也无法更新。

根本原因在于:MUI 的 MenuItem 内部依赖原生 <li> 元素的事件冒泡与焦点行为,而 Tooltip(尤其是 describeChild={true} 或默认配置下)会接管其子元素的 onMouseEnter/onFocus 等事件,并可能干扰 MenuItem 的事件委托机制。此外,Tooltip 要求其直接子元素必须是有效的 React 节点且能承载 DOM 属性(如 title、aria-describedby),而 MenuItem 本身是一个复合组件,不支持被直接透传事件属性。

✅ 正确写法是将 Tooltip 嵌套在 MenuItem 内部,并确保其子元素为一个普通 HTML 元素(如 <div>、<span> 或 <p>),以保证事件穿透和无障碍支持:

html-to-pptx-converter
html-to-pptx-converter

使用 PptxGenJS 和 Python 解析,将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint(.pptx)演示文稿。

下载
<MenuItem value={10}>
  <Tooltip title="Exactly twenty years old" placement="right">
    <div>Twenty</div>
  </Tooltip>
</MenuItem>

⚠️ 注意事项:

  • 不要省略 div(或类似容器):<Tooltip><MenuItem>Text</MenuItem></Tooltip> ❌ 无效;<MenuItem><Tooltip><span>Text</span></Tooltip></MenuItem> ✅;
  • 避免使用 describeChild={true} 在此场景——它仅适用于子元素本身不可交互的情况,而 MenuItem 是可交互的,应让 Tooltip 自动管理描述逻辑;
  • 若需支持键盘导航(如 Tab / Arrow Keys),确保 div 不阻断 MenuItem 的 tabIndex 和焦点行为(MUI 默认已处理,故推荐用 <div> 而非自定义 tabIndex 元素);
  • 如需统一样式,可为 div 添加 sx={{ px: 1, py: 0.5 }} 保持内边距一致性。

? 小技巧:可封装为可复用组件提升可维护性:

const TooltipMenuItem = ({ value, label, tooltip }: { 
  value: any; 
  label: string; 
  tooltip: string; 
}) => (
  <MenuItem value={value}>
    <Tooltip title={tooltip} arrow>
      <div>{label}</div>
    </Tooltip>
  </MenuItem>
);

// 使用
<TooltipMenuItem value={10} label="Twenty" tooltip="Tewnty" />

遵循该模式后,Select 的值更新、菜单关闭、键盘操作及无障碍支持(如屏幕阅读器读取 tooltip)均可正常工作。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

相关专题

更多
DOM是什么意思
DOM是什么意思

dom的英文全称是documentobjectmodel,表示文件对象模型,是w3c组织推荐的处理可扩展置标语言的标准编程接口;dom是html文档的内存中对象表示,它提供了使用javascript与网页交互的方式。想了解更多的相关内容,可以阅读本专题下面的文章。

6521

2024.08.14

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

20

2026.10.22

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

0

2026.10.22

Golangci-lint检查器使用教程
Golangci-lint检查器使用教程

本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。

20

2026.10.22

Gradle怎么构建Java项目
Gradle怎么构建Java项目

本专题介绍Gradle Java项目构建方法,涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查,帮助你理解各阶段的任务关系,逐步完成项目构建。

0

2026.10.22

PHP时间戳漏洞修复教程
PHP时间戳漏洞修复教程

本专题汇总PHP常见时间戳漏洞,包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等,并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案,帮助开发者快速排查和加固时间相关代码。

20

2026.10.22

Golangci-lint配置文件与规则设置
Golangci-lint配置文件与规则设置

本专题聚焦Golangci-lint YAML配置文件,讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置,便于团队统一检查标准。

0

2026.10.22

Golangci-lint安装与入门教程
Golangci-lint安装与入门教程

本专题讲解Golangci-lint的安装、初始化、基础命令和首次代码检查,覆盖本地环境、Docker及多平台用法,帮助Go开发者快速上手。

0

2026.10.22

PHP2Shell高危漏洞修复教程
PHP2Shell高危漏洞修复教程

PHP2Shell漏洞是什么,哪些PHP版本和运行环境会受到影响,服务器应该如何检测与修复?本专题提供版本自查脚本、Linux与Docker升级命令、PHP-FPM和Apache排查步骤,以及修复验证、临时缓解和应急响应方案。

80

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 12.3万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.4万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn