Modern Web Guidance 1.0:用 legacy-scan 找出可更新的前端寫法
本文目錄
想知道前端專案有哪些舊寫法值得重整,可以先用 Modern Web Guidance 1.0 的 legacy-scan 找候選,再沿著每筆命中的檔案和規則確認原本的視覺或互動用途。報告裡的筆數適合拿來分派審查,是否修改要看目標瀏覽器和實際用途。 Chrome 1.0 公告
先掃來源目錄,再縮到一條規則
在專案根目錄用 Node.js 22 以上執行。這組指令把 JSON 報告寫到暫存目錄,也能單獨重跑 CSS 底線規則。
npx --yes modern-web-guidance@1.0.0 legacy-scan src --json > /tmp/mwg-scan.jsonnpx --yes modern-web-guidance@1.0.0 legacy-scan src --guide custom-text-decorationsZeroOne 的 src 使用 1.0.0 和 Node v24.13.0 跑出四筆,其中一筆是 styles/markdown.css 的 custom-text-decorations,其餘三筆屬於 dark-mode-toggle。JSON 依 guides[].rules[].findings[] 列出位置。相同規則下的 verifierRubric.keepWhen 和 dropWhen 則提供保留與排除條件。掃描在本機跑,報告只涵蓋掃描器有規則能比對的用法。 Modernization workflow
用底線命中決定要不要改
實際命中位於 a:not(.no-styling) 的 hover 與 active 樣式。原始碼先讓預設底線透明,再用 border-bottom 畫虛線,並將 text-decoration 設為 none。這筆符合保留為候選的條件。如果是隨連結文字換行的底線,可試用 text-decoration 搭配 text-underline-offset。若同樣的邊框其實標示整張卡片或頁籤的作用中狀態,保留原樣,並記下排除理由。兩種用途看起來都像一條線,回歸驗收卻要看不同的東西。
要交給 coding agent 時,先請它針對一個 guideId 回覆檔案位置、保留或排除條件、目標瀏覽器和驗收步驟。確認最低支援版本後才改一筆,檢查窄螢幕的多行連結、hover 與鍵盤焦點,以及深淺主題中的線條。掃描前後筆數可當作追蹤資料,實際畫面才是這筆變更的驗收依據。若需要讓 agent 自己檢索指南,再照官方入門文件裝 skill。個別 CSS 能力也可對照本站的 CSS
參考資料: