CSS黏住的側欄沒生效:檢查容器高度與overflow
側欄已寫position:sticky,捲動後卻整塊跟著消失。先別急著改成fixed;sticky會受到捲動祖先、容器邊界與元素高度限制,設定本身生效,仍可能沒有可黏住的空間。 先決定你要它跟哪個區域捲動:整個頁面,還是某個有自己的捲軸的內容區。這個答案會決定接下來要檢查哪一層overflow,以及top應相對哪個可視區域發揮作用。 先確認top與position真正生效 選取側欄,看Computed裡position是否為sticky,top是否為預期距離。若垂直方向的兩個inset都保持auto,它在該方向不會出現預期的黏住行為。樣式被其他選取器覆蓋時,先處理覆蓋來源,不要只再加一條相同宣告。 .sidebar { position: sticky; top: 16px; align-self: start; } 16px只是範例。若上方有固定導覽列,要把實際佔用高度考慮進去,避免側欄標題藏在導覽下面。縮放或字體變大後導覽可能變高,不應只靠一個在自己的螢幕上剛好的數字。 grid拉高了側欄,就可能沒空間可移動 同一列裡,正文很高,側欄卻只有幾行導覽。格線項目若被拉伸到整列高度,側欄的盒子也可能跟正文一樣高;黏住需要的移動空間因此消失。查看側欄本身的bounding box,而不只是看裡面的文字有多短。 本文桌面案例有兩個獨立捲動區,正文高度相同。左側讓aside被拉伸,右側設align-self:start,側欄保留自己的內容高度。向下捲動相同距離後,左側跟著移走,右側留在自己的捲動區頂部附近。 兩區都使用sticky;差別是側欄盒子的高度與可移動空間。 這是自有HTML的實際桌面捲動結果,不是主題後台設定。正式版型若有不同格線結構、廣告區或導覽高度,要用自己的頁面重新量測,不能照圖猜容器尺寸。 沿父元素查看overflow sticky會依最近具有捲動機制的祖先運作;overflow:hidden、auto、scroll或overlay都可能建立相關條件,即使那一層目前沒有真正捲動。若側欄原本要跟整頁移動,卻被某個包裝層接住,就會出現你捲頁面、它沒有按預期黏住的情況。 從側欄往上逐層看Computed的overflow-x與overflow-y,別只找自己寫過的overflow:auto。兩個方向的值可能影響計算結果,某一軸設hidden後,另一軸的實際值也要核對。 不要為了讓sticky恢復就把全站overflow限制刪掉。那個限制可能在處理圖片裁切、輪播或橫向溢出。先確定它的用途,考慮把裁切放到較內層的媒體包裝,或重新安排側欄與捲動容器關係。 它會在所屬容器的尾端停下 sticky不是永遠浮在整個網站上。側欄仍受自己的包含區域限制,走到容器底部時不能繼續超出那個邊界。若正文很長,側欄卻被放在只有一小段高度的外層,黏住的區間就很短。 檢查側欄與正文是否真正共享預期的高容器。只把側欄文字拉長或加padding,未必能修正結構;反而可能讓側欄比可視區更高,讀者無法一次看到完整入口。 側欄內容很長時,也不一定適合整塊黏住。可以減少入口、改成正文中的目錄,或針對較大的閱讀區啟用sticky;要另外測試下方項目是否仍可到達。不要讓讀者為了看最後一個連結,被困在難操作的多層捲動區。 沒有捲動距離,就看不到黏住 先確認測試頁真的夠長,而且捲動的是預期容器。容器高度與內容差不多,或側欄本身佔滿整個高度時,沒有足夠移動距離,自然看不到明顯的黏住效果。 開發者工具可以先記錄側欄頂部座標,再捲動相同距離重新讀取。正常情況下,它先隨內容移動,碰到設定的top後在一段範圍內維持位置,最後又受到容器底部限制。只截一張靜止畫面,無法證明這個過程。 本文案例只捲動各自的內容區;若拿整頁捲動去測它,就不是相同條件。交給維護者的紀錄要寫清楚:哪個元素捲動、捲了多少、側欄多高與top是多少。 黏住後,還要核對遮擋與操作 z-index不能修復沒有移動空間的問題。只有確認黏住已發生,卻被其他元素蓋住時,再檢查疊放與背景。提高z-index也可能蓋過正文或其他入口,所以修改應限定側欄需要的層級。 用鍵盤走過側欄連結,確認焦點可見、目的地存在。點擊正文標題的連結後,也看標題是否被固定導覽遮住;側欄位置正確,不代表所有錨點落點都正確。 縮窄畫面後,正文與側欄常改成上下排列。這時可以取消黏住,讓入口回到普通文件流,避免窄畫面被一大塊導覽佔住。斷點按內容決定,並檢查放大文字後是否還能操作。 儲存可以重現的條件 修改前保留CSS與容器結構,先在一頁驗證。修正後從頁首、正文中段與容器底部各捲一次,確認開始、維持與結束位置;再換一篇較短文章與較長側欄,觀察失敗條件是否已說清楚。 如果效果只有某個高度才成立,記下那個限制,不要把案例推成所有頁面都完成。sticky處理的是捲動中的位置安排,沒有替你保證目錄可用、廣告不遮擋或閱讀效果提高。把位置與操作分別核對,才能知道改動真正解決了什麼。 參考資料MDN:sticky、捲動祖先與容器邊界MDN:overflow與捲動機制MDN:格線項目的對齊與拉伸MDN:top的定位距離
網站找不到返回路徑:麵包屑怎麼顯示文章所在位置
訪客從搜尋引擎直接進入文章,看完後想找同類教程,卻不知道這篇放在哪個分類。頁首的全站選單能帶他去其他地方,但未必能回答「這篇文章屬於哪一層」。麵包屑適合補上這條路徑,讓讀者回到文章的上層內容。 它顯示的是網站內容階層,例如「首頁 → 精品教程 → WordPress 實作 → 文章名稱」。這與瀏覽器的上一頁不同:讀者可能從站外進來,沒有走過那些分類頁,仍應能透過麵包屑理解目前所在位置。 先決定這篇文章真正的上層 先選一篇文章,把每一層對應到實際可開啟的頁面。「精品教程」應是教程入口,「WordPress 實作」應是列出相關教程的頁面。不要為了讓路徑看起來完整,加入不存在的分類,或把幾個同層標籤排成父子關係。 一篇文章可能同時屬於多個分類,這時要先決定主要路徑。可以依網站原有的主要分類設定,或由維護者訂下穩定的選擇方式。不要讓顯示順序隨資料庫回傳順序改變,否則同一篇文章可能今天在 WordPress,明天又像在網站營運底下。 分類太多時,先處理內容組織,再顯示麵包屑。麵包屑不能替你決定分類,也不應把所有分類塞成一長串。讀者需要的是一條可理解、可返回的路,不是文章所有屬性的集合。 把路徑放在文章標題附近 在自建示範頁中,我們把麵包屑放在文章標題上方,依序顯示首頁、精品教程、WordPress 實作及當前文章。前三層是連結,最後一層只是目前頁面的名稱。這樣讀者還沒開始閱讀,就能知道文章在教程區裡的位置。 自建桌機示範:路徑靠近文章標題,上層分類可直接返回。 我們點擊「WordPress 實作」後,頁面顯示相同名稱的分類入口,並列出這篇文章。這才是有用的返回路徑。若連結跳到首頁、空頁或另一個分類,就算麵包屑文字正確,訪客仍然找不到同類內容。 路徑不要比標題更搶眼。較小的字級和清楚的連結樣式就夠了,但不能淡到難以辨認。也不要把整條路徑做成一個連結,讀者點不同的層級,應該能去到不同的上層頁面。 用導覽結構表達,不只排幾個箭頭 WAI 的麵包屑模式把它視為一個有名稱的導覽區域,列出通往父層的連結。網站可以用 nav 包住有順序的項目,並給這個導覽區一個容易理解的名稱。當前頁面若是連結,可用 aria-current="page" 表示;若當前項目不是連結,模式並不要求一定加這個屬性。 <nav aria-label="麵包屑"> <ol> <li><a href="/">首頁</a></li> <li><a href="/tutorials/">精品教程</a></li> <li><a href="/wordpress/">WordPress 實作</a></li> <li><span>換主題前的選單記錄</span></li> </ol> </nav> 上面網址是結構示例,實際套用時要換成網站真正存在的入口。斜線或箭頭只是視覺分隔,不應被誤認成另一個可點擊項目。用 CSS 呈現分隔符號時,也要檢查輔助工具的讀取方式,避免每一層都夾著重複而無意義的符號。 如果頁面本來有主要導覽、文章目錄和麵包屑,三者要用不同名稱。不要全部叫「導覽」,讓使用輔助工具的人難以分辨。文章目錄帶讀者跳到這篇文章的段落,麵包屑則帶讀者回到站內父層;兩者各自保留用途。 長標題和小螢幕怎麼處理? 先用一篇真的長標題查看換行。整條路徑可以分行,但連結文字要完整可讀,不要為了維持單行,讓前三層都變成省略號。若當前文章名稱已在下方完整顯示,網站也可縮短最後一項的顯示文字,前提是仍容易對上同一篇文章。 手機上空間較小,若完整階層過長,可以評估只保留有用的上層返回入口。GOV.UK 的麵包屑元件也提供小螢幕呈現方式;採用任何做法前,仍要確認被省略的層級不會使訪客失去重要選擇。不要只隱藏麵包屑,卻沒有其他返回分類的入口。 用鍵盤走一次路徑,焦點應能逐一停在父層連結,且看得見目前停在哪裡。最後一項若只是文字,就不必增加假的按鈕或無用途的 Tab 停留點。這篇示範以桌機路徑操作為主,手機則可依自己網站的內容長度再安排版面。 避免兩套麵包屑同時出現 WordPress 主題和 SEO 外掛可能都提供麵包屑。如果文章上方突然出現兩條相近的路徑,先查看是哪兩處輸出,再決定保留一套。不要只用 CSS 隨便藏掉其中一條,卻留下重複的導覽或兩套不同路徑,後續分類調整時容易再出現矛盾。 若現有主題提供麵包屑開關,先在測試站啟用並核對實際路徑;需要插入模板函式時,交給維護者放在適合的位置。不要把某個外掛專用的函式直接貼到另一個網站,否則外掛不存在時可能造成錯誤。 完成後拿三種文章驗一次 選一篇單一分類文章、一篇多分類文章和一篇長標題文章。分別從外部連結直接打開,確認不依賴訪客先走過分類頁;再點每個父層連結,確認名稱與落點相符。移動文章分類後,也要再看一次路徑是否跟著更新。 最後問一個很具體的問題:讀者看完這篇,能不能從路徑找到同類文章?如果父層頁只有空列表或難以辨認的名稱,下一步應修那個入口。麵包屑做得再漂亮,也不能代替一個可用的分類頁。 參考資料 WAI:麵包屑導覽模式GOV.UK Design System:麵包屑元件與呈現方式
網站選單用鍵盤能不能走完:檢查焦點順序與關閉方式
滑鼠移到「模板分類」,下拉連結就出現;換成鍵盤,卻怎麼也進不去。這種選單看起來正常,訪客仍可能卡在網站入口。檢查時先把滑鼠放旁邊,從網址列按 Tab 進入頁面,試著找到一個分類,再回到正文。 本文處理一般網站的展開式導覽:按一下分類按鈕,顯示幾個頁面連結。它不需要做成桌面軟體那種複雜選單。先保留原生按鈕、連結與清楚的焦點,會比較容易維護。 先走一條完整路徑 挑一個實際任務,例如「從首頁進入 MacCMS 模板分類」。按 Tab,觀察目前焦點在哪裡;到了展開按鈕,按 Enter 或空白鍵。接著繼續 Tab,應能進到剛展開的連結。用 Shift+Tab 反向走,也應能回到前一個控制項。 不要只確認第一個按鈕會亮。第二層連結能否操作、關閉後能否離開、下一個區塊能否接到焦點,才是一條完整路徑。若 Tab 已經跳到正文,下拉選單仍停在畫面上遮住內容,也要記下來。 網站若有登入按鈕、搜尋框或其他導覽,依畫面順序一起走過。Tab 跳動的順序若與左右、上下排列差很多,先查 HTML 排列和 CSS 的視覺重排,不要先用一串正數 tabindex 強行指定順序。 展開用 button,前往頁面用 a 「模板分類」若只負責展開連結,就用 button;「MacCMS 模板」會前往分類頁,則用有 href 的 a。把可點文字放在普通 div 上,再另外補鍵盤事件,很容易漏掉空白鍵、焦點或狀態。 <nav class="site-nav" aria-label="主要導覽"> <button type="button" id="template-toggle" aria-expanded="false" aria-controls="template-links"> 模板分類 </button> <ul id="template-links" hidden> <li><a href="/maccms/">MacCMS 模板</a></li> <li><a href="/wordpress/">WordPress 主題</a></li> </ul> </nav> 範例路徑要換成自己網站真正存在的分類網址。展開時移除 hidden,同時把 aria-expanded 改成 true;收起則反向更新。aria-controls 指向被控制區塊的 ID,整頁不能重複使用同一個 ID。 這裡不用 role="menu"。WAI 的網站 disclosure 導覽範例也保留一般導覽連結;menu 角色會帶來另一組鍵盤互動預期。不要為了讓程式碼看起來更完整,加上自己沒有實作的角色。 關閉後,讓訪客知道自己在哪裡 展開按鈕本來就能再次按下收起,但訪客進到子連結後,也應有順手的退出方式。對這類導覽可讓 Esc 收起選單,並把焦點放回原展開按鈕。之後繼續 Tab,就能移到下一個頂層入口。 const toggle = document.querySelector('#template-toggle');...
Next.js站內連結用Link還是a:別讓每次換頁都重載
改 Next.js 網站的導覽列時,連結能打開就算完成了嗎?假如訪客剛輸入搜尋字詞,點進模板列表後整頁重新載入,字詞又變空白,操作就被打斷了。站內路由通常先用 next/link;外部網站、下載或刻意完整載入的入口,再用一般 a。 先確認你改的是 Next.js 路由 這個寫法適用於 Next.js 專案,以下採 App Router,首頁是 app/page.js,模板列表是 app/products/page.js。在 WordPress 或 MacCMS 的模板裡貼上 JSX,並不會因此得到 Next.js 換頁功能。先看專案的 package.json 和 app 目錄,別把網站類型混在一起。 導覽元件可直接寫: import Link from 'next/link'; export default function Navigation() { return <Link href="/products">看模板</Link>; } /products 必須對應實際存在的路由。不要再往 Link 裡包一層 a,也不用自己攔截點擊、呼叫 location.href;後者可能讓你又回到完整載入。 用同一個搜尋欄比較兩種換頁 把搜尋欄放在首頁與列表共用的 layout 裡,以 useState 管理輸入值;含這個狀態的元件要有 'use client'。準備兩個都指向 /products 的連結,一個是 Link,一個是普通 <a href="/products">,都在原分頁開啟。 先填「部落格模板」,點 Link。這個範例進入列表後,搜尋字詞仍在;回首頁,再點普通 a,欄位變回空白。原因是 Link 的客戶端換頁保留了共用 layout,普通 a 則建立新的 document。這不是所有欄位都會保留:若搜尋欄放在被替換的 page 內,或元件被重新建立,狀態仍可能消失。 哪些入口保留一般 a? 跳到外部 Demo、寄信連結、下載檔案,用一般 a 已很清楚。新分頁也會建立另一個頁面,不能期待它接續目前的輸入狀態。範例中的 Link 刻意不加 target="_blank",是為了測原分頁換頁;文章裡供你閱讀的參考連結則另開分頁。 如果訪客重整後仍要找回搜尋條件,把它放進網址查詢參數,例如...
