2025-09-18 · HTML

檢查標記中常見的無障礙錯誤

盤點 landmarks、標籤、標題與替代文字中最常見的八個結構問題。

前言

依實際稽核出現頻率排序的檢查清單,每一項都附上修正所需的最小 HTML 改動。

現場筆記

在處理 HTML 問題的過程中,反覆看到的幾個模式:

  • 簡單的版本撐過了每次重構,聰明的版本沒有。
  • 邊做邊寫的文件,比事後補寫的耐用得多。
  • 同一個問題第二次出現時,它就已經是模式了——幫它命名吧。

可以直接抄的檢查清單

  • 問題可以用一行指令重現。
  • 修正附帶一個沒有它就會失敗的測試。
  • 作者本人以外的人也在自己的機器上跑過。

結語

寫下未來的自己真的會讀的短版本——這就是全部的訣竅。