传达结构的布局
布局在第一个字被阅读之前就已经在传达信息:位置、间距和对齐本身就承载了层次感,而充足的空间胜过装饰。好的布局还要能经受住压力测试:调整大小、翻译、为RTL镜像,它依然能保持完整。在构建或审查UI代码时应用这些原则,并用项目现有的样式系统(Tailwind、纯CSS、CSS-in-JS)表达每一次更改;切勿引入第二种样式方法。
点击区域大小和焦点行为由better-accessibility技能涵盖;视觉润色(圆角、阴影、动画)由better-ui技能涵盖;行高和文本间距由better-typography技能涵盖。
将下面的数值视为尚未建立密度或间距系统的界面的起点。当有意保留的平台Chrome、紧凑的专业工具和项目令牌在点击区域、缩放、本地化和视口压力测试下依然可用时,请保持它们不变。
快速参考
| 类别 | 使用时机 |
|---|---|
| 分组与对齐 | 空间与分隔线,对齐边缘,逻辑属性,重要性排序 |
| 间距与自适应性 | 目标之间的间距,布局边距,渐进式展示,全出血内容,断点,国际化增长 |
核心原则
1. 用空间分组,而不是线条
空白是主要的分组工具;背景形状是次要的;分隔线是最后的手段,仅当空间本身无法承载结构时才使用。组之间的间距必须至少是组内间距的2倍(组内8px → 组间16px以上),否则分组会变成视觉噪音。
2. 保持控件与内容区分
交互元素必须看起来是可交互的:一个背景形状、一个边框或一个一致的放置区域。切勿将控件样式设置得与相邻的静态文本完全相同。
3. 对齐到共享边缘
选择对齐边缘并坚持使用;每一个偏离的边缘都会变成视觉噪音。对每个层级的下属元素使用一个项目的间距步长(16px是一个有用的默认值)。对方向依赖的布局使用逻辑属性(padding-inline-start、margin-inline-end);仅对真正的物理几何使用物理的left/right。
4. 按重要性排序
最重要的内容靠近顶部和起始边缘;阅读顺序从上到下,从起始到末尾。用起始/末尾来思考,而不是左/右。
5. 暗示隐藏内容
渐进式展示需要可见的提示。使用项目已建立的提示方式;如果没有,让下一个项目在滚动边缘露出16–32px,或显示一个展开控件。没有任何提示的隐藏内容等同于不存在。
6. 目标之间的呼吸空间
如果没有已建立的密度系统,相邻的带边框或填充的控件之间从12px开始,无边框的纯文本和纯图标控件周围留出24px的间距。当better-accessibility的点击区域不重叠且控件保持视觉区分时,紧凑布局可以使用更小的间距。
7. 按钮与边缘保持内边距
在内容布局中,全宽按钮应放置在布局边距内(移动端内边距从16px开始),并带有可见的圆角。当有意遵循已建立的平台或应用程序Chrome、考虑安全区域并保持与系统UI的可区分性时,边缘到边缘的操作是可以接受的。
8. 内容出血,控件浮动
背景和媒体扩展到视口边缘;控件和文本保持在布局边距和安全区域(env(safe-area-inset-*))内。粘性Chrome浮动在内容层之上,而不是阻挡它。
9. 保持结构直到它撑不住
断点来自内容,而不是设备预设。只要内容确实能放下,就保持展开的布局,并尽可能晚地折叠;组件级适配优先使用容器查询。首先测试最小和最大的尺寸。
10. 为文本增长和裁剪做好规划
为显著的和依赖于语言的字符串增长做规划,而不是依赖通用百分比:文本容器上不要设置固定宽度或高度,并让行自动换行。切勿将关键操作放在调整大小或滚动会裁剪它们的地方;将它们放在正常流中或适合产品的稳定Chrome中。
常见错误
| 错误 | 修复 |
|---|---|
| 本可用间距的地方用了分隔线 | 移除分隔线,将组间距加倍 |
在可本地化布局中使用margin-left / padding-right | 使用margin-inline-start / padding-inline-end |
| 内容布局中的按钮意外触及视口边缘 | 在项目边距内设置内边距;保留有意的平台Chrome |
| 看起来完整无缺的轮播/滚动器 | 让下一个项目在边缘露出16–32px |
| 相邻控件合并或扩展的点击区域重叠 | 使用项目比例增加间距;以12px/24px为起点 |
| 因为默认值而在768/1024设置断点 | 在内容实际放不下的位置设置断点 |
| 根据一种语言设置固定宽度的文本容器 | max-width + 自动换行;测试伪本地化和代表性语言区域 |
| 将主要操作放在窗格易于裁剪的底部 | 使用粘性定位或带有安全区域内边距的稳定Chrome |
审查输出格式
仅当用户要求进行独立的布局审查时使用此格式。当better-interface协调审查时,请向该技能提供领域证据和发现,并让它的输出格式、严重性等级、合并规则、上限和裁决优先。
独立审查分为两部分呈现。
发现
将所有已确认的发现按原则分组。使用带有严重性、位置、之前、之后和原因列的Markdown表格。切勿使用单独的“之前:”/“之后:”行。
- 严重性:
HIGH在支持的视口下阻止内容或操作;MEDIUM损害层次结构、阅读顺序或自适应性;LOW是孤立的对齐或间距润色。 - 位置:引用
路径/到/文件:行号。如果工件没有源文件,请引用确切的屏幕和组件。 - 之前/之后:显示当前的布局和一个可操作的替换方案。
- 原因:说明违反的原则及其对理解或适应性的影响。
将重复的系统性问题合并为一行,并列出所有受影响的位置。省略没有发现的原则。
示例
用空间分组,而不是线条
| 严重性 | 位置 | 之前 | 之后 | 原因 |
|---|---|---|---|---|
| LOW | src/Settings.tsx:41 | 每个设置行上都有border-b | 移除边框;组内使用space-y-2,组间使用space-y-8 | 间距以更少的视觉噪音传达分组 |
| LOW | src/ProfileForm.tsx:58 | 表单部分之间的<hr> | 替换为每个部分标题上的mt-10 | 部分层次结构不应依赖重复的规则 |
对齐到共享边缘
| 严重性 | 位置 | 之前 | 之后 | 原因 |
|---|---|---|---|---|
| LOW | src/Card.tsx:24 | 卡片文本在pl-4,卡片图标在pl-3 | 将两者对齐到相同的pl-4边缘 | 共享边缘创建可读的结构 |
| MEDIUM | src/Nav.css:19 | margin-left: 16px | margin-inline-start: 16px | 物理属性会破坏方向感知的布局 |
验证和裁决
在发现之后:
- 验证:列出在相关视口宽度、阅读顺序、缩放和RTL状态下已执行的确切检查及其观察结果。如果某个检查未执行,请说明仍需验证的内容。
- 裁决:如果存在任何
HIGH级别的发现,则给出Block;如果只存在MEDIUM或LOW级别的发现,则给出Needs changes;仅当没有可操作的发现时,才给出Approve。
当没有发现时,省略表格,说明“无可操作的布局发现”,报告验证情况,并以Approve结尾。