實作指南
資料參考與開發工作流程指南
從電話、身分 ID 與 locale 的資料界線,到 JSON、JWT、URL、時間、密碼與 Open Graph 的實作檢查。
資料參考
開發工作流程
CSV 轉 JSON:保留文字,修正有歧義的資料列
保留前導零與長編號,理解 CSV 引號規則,並在轉換前修正重複欄名、缺欄與 UTF-8 編碼問題。
CSS box-shadow:多層陰影、內陰影與裁切
理解 box-shadow 層順序、負擴散值、內陰影與 overflow 裁切,再將產生的 CSS 用於實際介面。
CSS 漸層色標、硬邊界與文字對比
正確理解線性與放射漸層色標、建立硬邊界,並在實際版面檢查文字對比。
Flexbox 尺寸、換行與來源順序
理解 Flexbox 主軸、項目尺寸與換行,再將產生的版面帶回專案。
CSS Grid 區塊:視覺版面、軌道與原始碼順序
建立矩形 grid-template-areas、理解欄列尺寸,並在使用產生的 CSS 前檢查 HTML 閱讀順序。
CSS 動態曲線:控制點、過衝與減少動態
理解 cubic-bezier() 座標,在相同時間下比較速度變化,並在實際元件中尊重減少動態偏好。
CSS clamp() 流動字級:公式與無障礙檢查
發布 clamp() 字級前,核對端點、rem 根字級假設、瀏覽器支援與 200% 文字縮放。
XML 格式化:良構、空白與驗證界線
了解 XML 語法檢查能證明什麼、空白為何可能影響內容,以及何時需要 XSD 驗證。
把 JSON 轉成 TypeScript,但不要相信單一範例
用 JSON 範例開始建立 TypeScript contract,同時把 runtime 檢查分開處理。
檢視 JWT claims,但不要把它當成證明
在本機讀取 JWT metadata 來除錯,同時把簽章驗證與授權分開。
URL 編碼:編碼資料,不是整個網址
在本機檢視 URL 元件,避免重複編碼 query value 或 path。
轉換時間戳,但不要遺失時區
保留同一時間點、標示來源時區,並明確處理夏令時間缺口。
在本機產生密碼,再正確保護它
使用唯一隨機密碼,並把產生與保存、復原、伺服器端雜湊分開。
分享頁面前驗證 Open Graph metadata
在本機建立已跳脫的社群 metadata,並檢查 canonical URL、標題與描述是否說同一件事。
閱讀文字差異,不把雜訊當成變更
在本機比較兩份文字版本,有意識地處理空白,並知道何時 diff 並不足夠。
Cronie 排程:日欄位、DST 與 step 值
閱讀五欄位 Cronie 排程,不把它和其他 cron 方言或部署證明混為一談。
WCAG 色彩對比:正確判讀比例,不過度宣稱
套用 WCAG 2.2 文字與非文字對比門檻,理解大型文字定義,以及兩色比例無法證明的範圍。
HTML 跳脫:依輸出情境正確編碼
正確編碼 HTML 文字與引號屬性,分清字元參照、內容清理,以及 JavaScript、CSS 與 URL 安全。
Unix 檔案權限:不靠猜測讀懂 chmod 模式
轉換 Unix 權限模式、區分檔案與目錄,並檢查特殊位元;不要把計算器當成存取決策。