SuperAPI AI 工具集

antislop-layoutmobile

前端与建站

查看项目

更新于 11-10 16:20

技能介绍

antislop-layoutmobile 是 antislop 系统的一部分,属于面向 AI 编程代理的规则集,专门深入处理响应式布局问题:布局如何在从手机到桌面的各种屏幕尺寸之间重排。它涵盖断点、缩放、网格、溢出、点击目标和导航,并通过编号引用核心规则,不重复也不重新编号。当任务涉及构建或编辑需要在任意屏幕宽度下都站得住的布局时加载本技能。

使用方式:当任务涉及移动端或响应式布局工作时,与 antislop.md 一起加载。核心文件承载机制(目的测试、三个层级、交付门),本技能承载移动端布局的深度内容。每条规则结构一致:Tell(模式)、Why(为何读起来像 slop)、Fix(应如何做),并引用核心规则编号(R-XX)。本技能背后的原则是:移动端布局是一种不同的布局,而不是缩小尺寸的桌面布局,它必须有意图地重新堆叠、重新缩放和重新排序。核心文件中的交付门仍然是最终关卡,文末的“Layoutmobile 技能检查清单”是移动端专用的补充,需与交付门一起运行。

断点方面:规则指出应避免仅桌面布局(所有屏幕共用一个布局状态,移动端只是被挤压的桌面布局)、按设备列表驱动的断点(以手机宽度命名断点而非内容实际断裂处)、移动端样式最后才加(作为尾部覆盖补丁)、以及只有两个状态的布局(一个断点以下单列堆叠,以上宽多列网格,中间无定义,导致平板和小笔记本宽度成为意外)。修复方式是在内容真正断裂处定义断点,将移动端视为被设计的状态而非覆盖,并定义内容所需的尽可能多的真实状态(典型重排为三个状态)。

缩放与尺寸方面:避免桌面尺寸的一切(内边距、间距、主视觉高度、卡片尺寸原样带到移动端)、固定像素字体(不随视口变化)、100vh 区块(在手机上溢出可见区域)、巨大空白内边距(桌面级区块内边距在手机上造成高耸空隙)。修复方式是给移动端自己的尺寸阶梯、使用流体字体(clamp())或在断点设置更小的字体阶梯、让区块按内容自适应或使用动态视口单位(dvh)、在断点减小区块内边距。

网格与堆叠方面:避免不折叠的列(多列网格在移动端保持并排导致碰撞)、固定宽度网格(固定 px 轨道或无法重排的网格区域)、强制 12 列(将 12 列网格强加于只需一两列的移动内容)。修复方式是在断点将网格折叠为单列、用 minmax() 或 auto-fit/auto-fill 让轨道随内容收缩换行、让列跟随内容。

溢出方面:避免水平滚动泄漏(某元素宽于视口导致页面横向滚动)、overflow: hidden 裁剪(在窄宽度裁剪内容而非让其适应)、固定宽度子元素(固定 px 宽度或 min-width 的子元素在窄屏撑破父容器)。修复方式是找到并容纳或重排超宽元素、让内容重排而非裁剪、用相对单位并允许子元素随容器收缩。

点击目标方面:避免过小目标(小于约 44 x 44 px)、目标过近(44px 目标无间隙紧挨)、仅悬停交互(触摸屏无悬停)。修复方式是给交互目标至少 44 x 44 px 的触摸区域、在相邻目标间留出清晰间隙、为每个仅悬停交互提供点击等价物和可见反馈。

移动端导航方面:避免保持桌面样式的导航(桌面顶栏链接行在手机上拥挤换行或溢出)、光秃秃的汉堡菜单(无标签无提示)、吃掉内容的底部导航(固定底栏覆盖内容)、偷走屏幕的粘性导航(高固定高度占据大片屏幕)。修复方式是在断点将导航折叠为移动模式(底部导航或菜单)、保持菜单可发现(标注“Menu”或保留主要目的地可见)、为内容预留底栏高度并处理安全区域、保持固定导航紧凑。

文末检查清单要求所有回答为“是”:布局是否重排为独特的移动状态而非挤压的桌面;是否在宽度范围内定义了状态而非仅手机和桌面;尺寸是否使用移动端阶梯;多列网格是否折叠堆叠而非碰撞;是否无水平溢出且无裁剪;交互目标是否至少 44 x 44 px 且有间距;仅悬停交互是否有带可见反馈的点击等价物;导航是否重排为移动模式;固定导航栏是否从不覆盖内容并尊重安全区域;布局是否在移动断点验证。