傳達結構的佈局
佈局在閱讀任何文字之前就已開始傳達訊息:位置、間距和對齊本身就能承載層級,而充足的留白勝過裝飾。一個好的佈局也必須經得起考驗:調整大小、翻譯、為 RTL 鏡像處理,它仍然應該保持完整。在建立或審查 UI 程式碼時應用這些原則,並使用專案現有的樣式系統(Tailwind、純 CSS、CSS-in-JS)來表達每個變更;切勿引入第二種樣式方法。
點擊區域大小和焦點行為由 better-accessibility 技能涵蓋;視覺修飾(圓角、陰影、動畫)由 better-ui 技能涵蓋;行長和文字間距由 better-typography 技能涵蓋。
將下面的數值視為尚未建立密度或間距系統的介面的起點。當專有平台 chrome、緊湊的專業工具和專案 token 在點擊區域、縮放、在地化和視口壓力測試中仍然可用時,請保留它們。
快速參考
| 類別 | 使用時機 |
|---|---|
| 分組與對齊 | 間距 vs 分隔線、對齊邊緣、邏輯屬性、重要性排序 |
| 間距與適應性 | 目標之間的間距、佈局邊距、漸進式揭露、滿版內容、斷點、國際化字串增長 |
核心原則
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 + 換行;測試偽在地化和有代表性的語言環境 |
| 主要操作放在窗格底部容易被裁切的位置 | 使用 sticky 定位或穩定的 chrome,並添加安全區域內邊距 |
審查輸出格式
僅當使用者要求進行獨立的佈局審查時,才使用此格式。當 better-interface 協調審查時,請將領域證據和發現提供給該技能,並讓其輸出格式、嚴重性等級、合併規則、上限和最終裁決優先。
以兩個部分呈現獨立審查。
發現
將所有確認的發現按原則分組。使用一個具有嚴重性、位置、之前、之後和原因欄位的 markdown 表格。切勿使用分開的「Before:」/「After:」行。
- 嚴重性:
HIGH在支援的視口下阻擋內容或操作;MEDIUM損害層級、閱讀順序或適應性;LOW是孤立的對齊或間距微調。 - 位置:引用
path/to/file:line。如果成品沒有源代碼檔案,請引用確切的螢幕名稱和元件名稱。 - 之前/之後:顯示當前的佈局和一個可操作的替換方案。
- 原因:說明違反的原則及其對理解或適應性的影響。
將重複的系統性問題合併為一行,並列出所有受影響的位置。省略沒有發現的原則。
範例
用間距分組,而非線條
| 嚴重性 | 位置 | 之前 | 之後 | 原因 |
|---|---|---|---|---|
| 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。
當沒有任何發現時,省略表格,說明「No actionable layout findings」,報告驗證結果,並以 Approve 結束。