使用說明

Tailwind purge CSS:移除 HTML 沒用到的規則

不論是 Tailwind purge CSS,還是一般的樣式表,只要貼上頁面的 HTML(或 JS 標記)和對應的樣式表,按下移除未使用的規則,就會得到拿掉所有對不上標記的規則的樣式表,並顯示節省的位元組。你可以直接貼上文字,也可以用選擇檔案載入,每個欄位最多 5 MB。整個過程都在你的瀏覽器中進行,程式碼不會被上傳。


線上移除 HTML 沒用到的 CSS 規則

  1. 把 HTML 或 JS 標記貼到HTML / 標記,或用選擇檔案載入。按清除可以清空該欄位。
  2. 用同樣的方式把樣式表貼到CSS 樣式表。
  3. 如果你的腳本會在執行時加入 class,請開啟進階,把這些 class 填到保留清單。
  4. 按下移除未使用的規則。兩個欄位都有文字之前,按鈕會維持停用。
  5. 在清理後的 CSS查看結果,再按複製到剪貼簿(會變成已複製),或按下載 CSS,把結果存成已清理.css。
  6. 按編輯輸入內容可以帶著原本的文字回到輸入畫面,例如要多加一筆保留項目再重新處理。

結果會顯示類似「NN% 更小」的一行,旁邊是原始與清理後的大小。如果完全沒有規則留下,會看到「沒有留下任何規則。」這通常表示標記和樣式表來自不同的頁面。

什麼樣的規則會被視為未使用

工具會讀取你的標記中的每個字,只有在選擇器裡的每個 class、ID、標籤和屬性名稱都出現在標記中時,才會保留該規則。class 和 ID 名稱會區分大小寫。:hover、::before 這類偽類別和偽元素不會被要求,:not() 或 :is() 裡面的內容則會被忽略。

舉例來說,你的標記裡有一個 class 為 btn 的連結和一個 class 為 card 的 div,沒有其他 class。CSS 中的規則會這樣處理:

@media、@supports、@layer 和 @container 裡面的規則會在內部清理,只有裡面完全沒有東西時,@ 規則本身才會消失。@font-face、@keyframes、@import、@charset、@page 和 @property 一律保留,:root、自訂屬性、* 選擇器、html 和 body 也一樣。

用保留清單留下 JavaScript 加入的 class

開啟進階就會看到保留清單。輸入即使不在 HTML 中也要保留的 class 或 ID,以逗號分隔,例如 .modal, #nav, is-active。開頭的 . 或 # 可以省略。

多個頁面、Tailwind 與 WordPress 的做法

一份樣式表通常服務很多頁面。把所有頁面的標記依序貼到HTML / 標記,只要有任何一頁用到,該規則就會保留。

要做 Tailwind purge CSS,請貼上你的範本和建置後的樣式表:md\:flex、w-1\/2 這類有跳脫字元的選擇器,會和標記中寫出的 class 名稱比對。

如果是 WordPress 佈景主題,請複製主題會顯示的每一種頁面的原始碼,再貼上主題的樣式表。

這個工具不知道的事

工具不會執行你的頁面或 JavaScript,只會讀取你貼上的文字。因此只在執行時才出現的 class,或只出現在你沒貼上的頁面中的 class,都會被視為未使用。上線之前,請先在真實頁面上檢查清理後的樣式表。

保留下來的規則不會重新排版或壓縮,註解會被移除,只有 /*! license */ 這種註解例外。原本在同一行的樣式表,仍然會在同一行。

想進一步縮小結果,可以使用「CSS 壓縮工具」;要加上廠商前綴,可以用「CSS 自動前綴工具」;想讓壓縮過的程式碼變得好讀,則用「程式碼美化工具」。


常見問題

怎麼移除 HTML 沒用到的 CSS?

把頁面的 HTML 貼到「HTML / 標記」,把樣式表貼到「CSS 樣式表」,然後按「移除未使用的規則」。「清理後的 CSS」會顯示拿掉所有標記對不上的規則後的樣式表,以及節省的百分比。按「複製到剪貼簿」或「下載 CSS」(檔名是已清理.css),再取代舊的樣式表。

有線上的 PurgeCSS 嗎?

這是一個做同一件事的線上工具。它會讀取你的標記中的每個字,只有在選擇器裡的每個 class、ID、標籤和屬性名稱都出現在標記中時才保留規則。它不是 PurgeCSS 套件,所以沒有設定檔也沒有外掛,也不會執行你的頁面。多數人需要的那個選項,由「保留清單」欄位負責。

怎麼找出沒用到的 CSS class?

按下「移除未使用的規則」,再把結果和原始內容比對。從「清理後的 CSS」中消失的 class,就是在你貼上的標記中找不到對應的 class。工具不會列出被移除的規則,所以樣式表很長時,建議先看「原始」和「清理後」的大小,再檢查少了什麼。

怎麼保留 JavaScript 之後才加入的 class?

開啟「進階」,把它們填到「保留清單」欄位,以逗號分隔,例如 .modal, #nav, is-active。開頭的 . 或 # 可以省略。提到清單中 class 或 ID 的規則會保留,但選擇器的其餘部分仍然必須對得上:.menu.is-active 只有在標記中也有 menu 時才會保留。如果你的 JavaScript 也貼在「HTML / 標記」裡,其中直接寫出的 class 名稱不需要保留清單也找得到。

為什麼我的腳本加入的 class 被從 CSS 移除了?

工具不會執行你的頁面或 JavaScript,只會讀取你貼上的文字。像 'btn-' + size 這種在執行時才組出來的名稱不會出現在文字中,所以它的規則會被移除。請把腳本貼到「HTML / 標記」並在那裡寫出完整的 class 名稱,或把它們加入「保留清單」。之後在上線前,先在頁面上確認結果。

Tailwind 的 CSS 要怎麼 purge?

把你的範本或元件貼到「HTML / 標記」,把建置後的 Tailwind 樣式表貼到「CSS 樣式表」。md\:flex、w-1\/2 這類有跳脫字元的選擇器,會和標記中寫出的 class 名稱比對,所以你有用到的工具類別會留下來。在程式中組出來的 class 名稱,例如 'bg-' + color + '-500',則找不到:請寫出完整名稱,或加入保留清單。

不用外掛,要怎麼精簡 WordPress 佈景主題的 CSS?

開啟一個頁面、檢視原始碼、複製 HTML,貼到「HTML / 標記」。把佈景主題的樣式表貼到「CSS 樣式表」,再按「移除未使用的規則」。佈景主題的樣式表由很多頁面共用,所以請把幾個不同頁面的 HTML 依序貼到同一個欄位:只要其中一頁用到,規則就會保留。確認過每一種頁面之後,再取代檔案。

移除未使用的規則也會順便壓縮嗎?

不會。保留下來的規則維持你寫的樣子,不會重新排版或壓縮,原本只有一行的樣式表仍然是一行。註解會被移除,只有 /*! license */ 這種註解例外。想讓檔案更小,可以把結果再交給「CSS 壓縮工具」。

我的 HTML 或 CSS 會被上傳到哪裡嗎?

不會。清理在你瀏覽器中的 Web Worker 裡執行,標記和樣式表都留在你的裝置上。每個欄位最多可放 5 MB。