SuperAPI AI 工具集

mobile-native

前端与建站

查看项目

更新于 11-06 17:15

技能介绍

这是一个移动端“原生化”修复技能,定位非常明确:只处理让网页在手机上仍然像浏览器里一个网站的那些细节,不负责动效设计、动效审查或 React Native 开发。资料将其描述为一个“修复型”技能,逐项移除暴露网页身份的痕迹,涉及的层面是平台层——视口、触控、滚动、安全区域和浏览器界面。

【用途】 用于将已经能在手机上使用的 Web 应用,调整为更接近“已安装应用”的体验。技能强调两个常见误区:一是只在桌面浏览器的设备模拟中调试,因为资料称本技能中的多数问题在 Chrome 设备模拟中不会复现;二是在 CSS 或 meta 标签就能解决时改用 JavaScript,例如用 hook 检测触控设备来隐藏悬停状态,而正确做法是媒体查询。

【主要能力】 资料以“症状表”列出问题与对应方案,包括:点击后悬停状态卡住(用 @media (hover: hover) and (pointer: fine) 包裹悬停样式);点击时出现灰色或蓝色闪烁(设置 -webkit-tap-highlight-color);布局高度不正确(应用外壳用 100dvh,首屏用 100svh);页面聚焦输入框时放大(输入框字号至少 16px);点击感觉迟滞(在 pointer-down 时给出反馈并使用 touch-action: manipulation);下拉刷新劫持滚动(在 html、body 上设置 overscroll-behavior: none,内部滚动容器用 contain);内容被刘海遮挡(viewport-fit=cover 加 env(safe-area-inset-*));长按选中按钮文字(对控件设置 user-select: none);轮播横向滑动却带动页面纵向滚动(按元素职责设置 touch-action 的 pan-y、pan-x 或 none);状态栏颜色不匹配(按 prefers-color-scheme 分别设置 theme-color);以及在 Chrome 中正常、在手机上异常(必须真机测试)。

【使用方式】 技能被调用且用户未提出具体问题时,只回复一句准备就绪的说明,不额外输出信息,直到用户提问。实际使用中,先对照症状表匹配用户描述的现象,再阅读对应小节获取原因与确切代码。资料还给出一份“基线”代码:viewport 元标签(含 viewport-fit=cover 与 interactive-widget=resizes-content)、明暗两套 theme-color、html 上的点击高亮透明、文本大小调整、overscroll-behavior、输入框 16px 字号、按钮与链接的 touch-action 和 user-select,以及统一的悬停媒体查询。完成后以简短几行说明:问题是什么、改了哪些文件和声明、哪些需要真机确认。资料明确表示代码即交付物,不要扩写成报告。

【适用场景】 适合正在开发或打磨移动端 Web 应用、PWA、带抽屉或底部表单的交互界面,以及需要处理触控反馈、安全区域和软键盘布局的项目。

【限制】 不涉及动效设计与审查,也不面向 React Native。资料反复强调真机验证的必要性:粘滞悬停、点击高亮、URL 栏对 vh 的影响、输入缩放、点击延迟、过度滚动、安全区域和软键盘都是真实硬件行为,设备模拟乃至 Xcode 模拟器都无法完全复现。此外,资料中的具体取舍需结合项目支持矩阵判断,例如 100vh 回退行是否保留。

【硬性规则】 资料列出若干不可违反的规则:媒体查询优先于设备嗅探,不依据 user agent 或屏幕宽度猜测触控;触控与鼠标并非互斥,应按能力而非设备判断;绝不禁止缩放,user-scalable=no 和 maximum-scale=1 属于可访问性失败,应改为修正输入框字号;完成前需在硬件上测试。