Tailwind purge CSS:移除 HTML 沒用到的規則
不論是 Tailwind purge CSS,還是一般的樣式表,只要貼上頁面的 HTML(或 JS 標記)和對應的樣式表,按下移除未使用的規則,就會得到拿掉所有對不上標記的規則的樣式表,並顯示節省的位元組。你可以直接貼上文字,也可以用選擇檔案載入,每個欄位最多 5 MB。整個過程都在你的瀏覽器中進行,程式碼不會被上傳。
線上移除 HTML 沒用到的 CSS 規則
- 把 HTML 或 JS 標記貼到HTML / 標記,或用選擇檔案載入。按清除可以清空該欄位。
- 用同樣的方式把樣式表貼到CSS 樣式表。
- 如果你的腳本會在執行時加入 class,請開啟進階,把這些 class 填到保留清單。
- 按下移除未使用的規則。兩個欄位都有文字之前,按鈕會維持停用。
- 在清理後的 CSS查看結果,再按複製到剪貼簿(會變成已複製),或按下載 CSS,把結果存成已清理.css。
- 按編輯輸入內容可以帶著原本的文字回到輸入畫面,例如要多加一筆保留項目再重新處理。
結果會顯示類似「NN% 更小」的一行,旁邊是原始與清理後的大小。如果完全沒有規則留下,會看到「沒有留下任何規則。」這通常表示標記和樣式表來自不同的頁面。
什麼樣的規則會被視為未使用
工具會讀取你的標記中的每個字,只有在選擇器裡的每個 class、ID、標籤和屬性名稱都出現在標記中時,才會保留該規則。class 和 ID 名稱會區分大小寫。:hover、::before 這類偽類別和偽元素不會被要求,:not() 或 :is() 裡面的內容則會被忽略。
舉例來說,你的標記裡有一個 class 為 btn 的連結和一個 class 為 card 的 div,沒有其他 class。CSS 中的規則會這樣處理:
.btn:hover會保留,因為btn在標記中,而:hover不會被要求。.card, .modal會變成.card:在以逗號分隔的清單中,只有沒用到的選擇器會被拿掉。.footer會被移除,因為標記裡沒有footer。- 只含
.sidebar規則的@media (min-width:600px)會整個被移除,因為變空的 @ 規則會被捨棄。 @keyframes spin會保留,因為它不會被清理。
@media、@supports、@layer 和 @container 裡面的規則會在內部清理,只有裡面完全沒有東西時,@ 規則本身才會消失。@font-face、@keyframes、@import、@charset、@page 和 @property 一律保留,:root、自訂屬性、* 選擇器、html 和 body 也一樣。
用保留清單留下 JavaScript 加入的 class
開啟進階就會看到保留清單。輸入即使不在 HTML 中也要保留的 class 或 ID,以逗號分隔,例如 .modal, #nav, is-active。開頭的 . 或 # 可以省略。
- 清單中的名稱會讓提到它的規則保留下來。
- 選擇器的其餘部分仍然必須對得上:
.menu.is-active只有在標記中也有menu時才會保留。 - 貼到HTML / 標記的 JS 中直接寫出的名稱,不需要保留清單也找得到。像
'btn-' + size這種在程式中組出來的名稱則找不到。
多個頁面、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。