猎豹浏览器中HTML5按钮“显示正常但点不动”主因是环境干扰而非HTML5缺陷，需依次排查CSS遮挡（pointer-events/z-index）、JS绑定失效、广告过滤等特有功能干扰及HTML5语义合规性。

猎豹浏览器中 HTML5 按钮或交互元素“显示正常但点不动”，绝大多数情况不是 HTML5 本身的问题，而是浏览器环境干扰了事件传递或脚本执行。它和 Chrome 表现一致（因同属 Chromium 内核），但猎豹自带的广告过滤、硬件加速、插件策略等会放大某些兼容性问题。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

检查 pointer-events 和 z-index 遮挡

CSS 层叠问题是最隐蔽也最常被忽略的原因：按钮看起来在最上层，实际点击被透明浮层或父容器截获。

• 打开开发者工具（F12 或右键 → “检查元素”），选中失灵按钮，在 Elements 面板右侧 Styles 栏搜索 pointer-events，确认值不是 none
• 查看该按钮及其所有父级元素的 z-index 和 position（尤其是 absolute / fixed 容器），若某层 z-index 很高但背景透明，就可能静默拦截点击
• 临时在控制台运行：

  console.log(getComputedStyle(document.querySelector('button')).pointerEvents)

  ，验证计算后值

确认事件监听是否真正绑定成功

JavaScript 脚本可能因加载时机、作用域或错误中断，导致 addEventListener 实际没执行。

• 在 Console 面板刷新页面后，直接输入：

  document.querySelector('button').onclick

  或

  getEventListeners(document.querySelector('button'))

  （Chrome/猎豹支持），看是否有监听器输出
• 若返回 null 或空对象，说明绑定失败；常见原因是 DOM 尚未就绪就执行 JS，应改用：

  document.addEventListener('DOMContentLoaded', () => { /<em> 绑定逻辑 </em>/ });

• 检查 Console 是否有红色报错（如 Uncaught ReferenceError: xxx is not defined），一个语法错误可能导致后续所有脚本停摆

禁用猎豹特有功能快速隔离干扰

猎豹的广告过滤、硬件加速、Flash 策略等模块，会主动注入脚本或修改 DOM，极易破坏 HTML5 表单/媒体/Canvas 的默认行为。

• 地址栏输入：chrome://settings/content → 关闭“广告拦截”
• 设置 → 高级 → 系统 → 关闭“使用硬件加速（推荐）”，重启浏览器
• 地址栏输入：chrome://plugins（若存在）→ 确保 Flash 处于“已停用”（HTML5 场景下启用 Flash 反而会冲突）
• 运行内置修复：点击左上角猎豹头像 → “修复浏览器” → “立即修复”，它会重置被插件污染的配置项

验证 HTML5 语义与事件触发条件

部分 HTML5 交互依赖用户手势（尤其媒体播放），或对标签嵌套敏感，猎豹不会特殊处理，但旧版渲染逻辑可能更严格。

• <video></video> 或 <audio></audio> 元素若设了 autoplay 但没加 muted，现代猎豹（基于 Chromium 110+）会静音拒绝播放，导致“按钮点了没反应”——需确保：

  <video muted autoplay>

• 表单内 button 类型为 submit 但父 <form></form> 缺少 onsubmit 或被 JS preventDefault() 后未手动处理，也会“看似无响应”
• 使用 required 的 input 若未设置 type（如写成 <input> 而非 <input type="email">），猎豹可能不触发原生校验，让人误以为失效

真正难排查的，往往是 CSS 遮挡 + JS 报错 + 广告过滤三者叠加：按钮能 hover、能聚焦、DOM 存在、控制台却一片空白——这时优先关掉广告过滤再试一次，比反复检查 JS 逻辑更高效。