SuperAPI AI 工具集

better-layout

通用与其它

查看项目

更新于 10-15 22:40

技能介绍

用途:设定分组、对齐、间距与响应式结构,并通过缩放、翻译和 RTL 镜像压测该结构。修复需写入项目自身的样式系统;仅当项目没有间距刻度或密度体系时,才采用文中给出的数值。问题报告需要有可展示的失败证据,如裁切、重叠、镜像破裂或分组被误读。命中区域与焦点行为归 better-accessibility,圆角、阴影与动画归 better-ui,行宽、文本间距与截断机制归 better-typography,文字本身归 better-writing。

主要原则:用间距而非线条分组,组间距至少为组内间距的 2 倍(组内 8px 则组间 16px 以上),背景形状次之,分隔线最后;交互元素需有背景形状、边框、下划线或一致放置区,与静态文本区分;对齐到少量共享边,每层嵌套用一个项目间距步长(默认 16px 可用);会镜像的布局用逻辑属性(margin-inline-start、padding-inline-end、inset-inline-start、text-align: start),物理 left/right 仅留给安全区等物理几何;按重要性排序,视觉顺序与 DOM 顺序一致,不用 order、row-reverse 或 grid 放置打乱源顺序;每视图一个主操作,次要操作超过 3 个收进菜单;屏外或折叠内容要有可见提示,被截断且用户需要的值要有展开、详情或可键盘触达的提示路径;无边框控件需更多留白,默认相邻有边框或填充控件间距离 12px,无边框文本与图标控件字形间距 24px;内容布局中全宽按钮保持在内边距内,移动端约 16px。

响应式与适配:内容出血到视口边缘,控件和文字留在布局边距与安全区内;sticky 头部需设置 scroll-padding-block-start 为头部高度;断点由内容决定而非设备预设,优先容器查询,先测最小与最大支持尺寸;为译文增长与裁切留空间,文本容器用 max-width 与 min-height,避免固定宽高,让行可换行,用伪本地化和德语等长字符串语言测试;关键操作不能因缩放、滚动被裁切。

已知检查项涉及 minmax(0,1fr)、flex 子项 min-width:0、避免 100vw、用 100dvh、min-height、组件内用 @container、container-type 需明确宽度、env(safe-area-inset-*) 需 viewport-fit=cover、镜像 UI 的 float 与 translateX 需 RTL 覆盖等。报告按严重级别 HIGH/MEDIUM/LOW 分级,给出位置、前后对比与原因,并在存在 HIGH 时以 Block 结束,否则 Approve;未检查的覆盖不得批准。未提供该技能的具体安装与调用命令,暂未提供。