核心原則

Tab 順序 = DOM 順序 = 使用者 mental model 的互動順序、三者該對齊。

三者偏差的後果：

• DOM ≠ mental model：視覺 / tab 順序跟使用者期望不一致、a11y 體驗差
• DOM ≠ tab order（用 tabindex > 0）：DOM 改變時 tab 順序維護成本爆炸（#52 反模式）
• 全對齊：DOM 簡單、tab 自然、a11y 預設正確

要解決不對齊、優先重排 DOM、不要用 tabindex 強制覆寫。

為什麼三者該對齊到 DOM 順序

Tab 順序跟 DOM 順序綁定是 spec 規定

HTML5 spec：tabbable elements 預設依 source order（DOM 順序）navigate。要改變只能用 tabindex 覆寫。

tabindex 三種值：

tabindex > 0 反模式（同 #52 鍵盤可達性）：

• 全頁面只要有任何元素用 tabindex > 0、整個 tab 順序變混亂（其他 0 / 不寫的元素都被推到後面）
• 維護成本：DOM 改了、所有 tabindex > 0 的數值都要重排
• A11y：screen reader 跟視覺使用者體驗到不同順序

唯一合法用法：要把元素「移出 tab cycle」用 tabindex="-1"（例如 modal 開啟時鎖住背景）。

Mental model 順序由 UI 設計決定

互動式 UI 隱含一個流程：使用者預期「先做 X 再做 Y」。例如：

設計者腦中有這個順序、寫 HTML 時要把它具體化成 DOM 順序。DOM 順序就是把 mental model 寫進 code 的方式。

多面向：常見不對齊 case

面向 1：Filter 在 search input 之前（這次任務的 case）

1<!-- DOM 順序：scope 先 → search input 後 -->
2<div class="search-scope">...</div>
3<div id="search"></div>  <!-- pagefind input 在裡面 -->

Tab 順序：scope radios → search input。但 mental model 是「先打字再篩選」、Tab 應該先到 input。

修法：DOM 重排、把 scope 移到 #search 之後。視覺位置由 CSS position: absolute 控制、不受 DOM 順序影響。

面向 2：Submit 按鈕在 form 中間

1<form>
2  <input name="email">
3  <button type="submit">送出</button>  <!-- 太早 -->
4  <textarea name="message"></textarea>
5</form>

Tab 順序：email → submit → textarea。使用者打完 email 按 Enter 就送出、textarea 還沒填。

修法：submit 移到所有 input 之後。

面向 3：Logo / nav 在主要 CTA 之前

1<header>
2  <a href="/">Logo</a>
3  <nav>... 5 個 links ...</nav>
4</header>
5<main>
6  <button>主要 CTA</button>  <!-- 使用者要按這個 -->
7</main>

Tab 順序：6 個 nav links → CTA。使用者要 tab 6 次才到 CTA。

修法：考慮加 「skip to main content」link（A11y 標準做法）— <a href="#main-content" class="skip-link">。第一個 tab 就跳過 nav 到 main。

面向 4：Modal 開啟時 background 仍 tabbable

1<div class="background-content">
2  <a href="...">某連結</a>  <!-- 仍可 tab 到 -->
3</div>
4<div role="dialog">
5  <input>
6  <button>確認</button>
7</div>

Tab 順序：背景連結 → modal input → confirm。使用者 tab 出 modal 跑回背景。

修法：modal 開啟時、用 inert attribute（modern）或所有背景元素設 tabindex="-1"（傳統）把它們踢出 cycle。<dialog> native 自動處理。

不對齊的修法：優先重排 DOM

第一順位：重排 DOM

把元素照 mental model 順序排在 HTML / template 裡。視覺位置如果跟 DOM 順序不同、用 CSS order（flex / grid）、position: absolute、grid-template-areas 控制。

1<!-- DOM 順序對齊 mental model：input → scope → drawer -->
2<div id="search"></div>
3<div class="search-scope">...</div>

1/* 視覺：scope 浮在 input 跟 drawer 之間（跟 DOM 順序無關） */
2.search-shell { position: relative; }
3.search-scope {
4  position: absolute;
5  top: calc(var(--input-h) + 8px);
6}

Tab 順序自然對齊 DOM、視覺位置由 CSS 獨立控制 — 兩個維度解耦、不互相影響。

第二順位：JS 動態移動 DOM

如果元素因為 framework 限制無法 hard-coded 在對的位置（例如某 vendor library 強制 mount 點）、用 JS 在 mount 後 reparent 元素到對的位置。

1// PagefindUI mount 後、把 scope 移到 input 跟 drawer 之間（如果 framework 允許）
2const scope = document.querySelector('.search-scope');
3const drawer = document.querySelector('.pagefind-ui__drawer');
4drawer.parentElement.insertBefore(scope, drawer);

風險：framework 重渲染可能 reparent 回去（#5 framework-managed DOM）。要驗證穩定性。

第三順位（不推薦）：tabindex 強制

1<input tabindex="1" name="search">  <!-- 反模式：tabindex > 0 -->
2<div tabindex="2" class="search-scope">...</div>

只在前兩種都做不到時用。維護成本高、a11y 跟設計工具支援差。

不該套用本原則的情境

「DOM = tab = mental model 三者對齊」原則在多數情境成立、但有合理例外：

四類共同特徵：沒有清楚的「使用者該先做 X 再做 Y」流程 — 本原則建立在「有 mental model 可對齊」上、沒有時自然不適用。

跟其他抽象層原則的關係

對應的實作篇

• 搜尋頁 scope filter 在 search input 之前的 tab 順序問題 — Checkpoint 1 retrospective 找到（#68 dogfooding）
• 任何「先選範圍再操作」vs「先操作再選範圍」的 UI 設計 — 都該檢視 tab order 是否對齊

判讀徵兆

核心原則：DOM 順序是寫進 code 的 mental model、tab 順序是使用者體驗的 mental model — 兩者該由「重排 DOM」對齊、不該由「tabindex」強制。視覺位置跟 DOM 順序解耦（用 CSS 控制）、讓兩者各自獨立優化。