實作指南

資料參考與開發工作流程指南

從電話、身分 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 權限模式、區分檔案與目錄,並檢查特殊位元;不要把計算器當成存取決策。