Regenerace Tailwindu oživí třídy, které byly ve zmrazeném CSS mrtvé
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Web se přebírá jako hotové statické HTML (předloha od autora designu) a staví se znovu vlastním buildem. Kontroly parity hlásí nulu: texty, struktura tagů a tříd i skripty sedí. Autor předlohy přesto pošle srovnání, podle kterého je jedna stránka o 48 px delší, druhá o 16 px a na třetí má karta větší písmo. Jde o stránky, které nikdo neupravoval.
Root cause
Sekce “Root cause”Autor předlohy upravuje HTML ručně nad zmrazeným CSS bundlem z dřívějšího buildu. Když do HTML dopíše utility, kterou bundle nezná (sm:p-5, sm:text-base, mt-0), nic se nestane: třída nemá pravidlo a v jeho kopii je mrtvá. Vzhled, který vidí a schvaluje, je vzhled bez ní.
Nový build ale CSS generuje ze všech zdrojů včetně převzatého HTML. Generátor třídu najde, pravidlo vytvoří a mrtvá třída začne působit:
předloha: <div class="p-4 sm:p-5"> → bundle zná jen .p-4 → padding 16 pxnáš build: <div class="p-4 sm:p-5"> → vygeneruje i .sm\:p-5 → padding 20 pxKontrola struktury to nezachytí, protože atribut class je v obou verzích totožný. Liší se až vypočtený styl.
Fix
Sekce “Fix”- Ze všech stránek předlohy vytáhnout použité třídy a pro každou ověřit, zda má pravidlo v CSS předlohy (bundle i stránkové
<style>). - Třídy bez pravidla zapsat do generovaného souboru a z Tailwindu je vyřadit:
(/* generováno při každém převzetí předlohy */@source not inline("sm:p-5");@source not inline("sm:text-base");
@source not inline()je v Tailwindu od verze 4.1.) - Přidat vizuální kontrolu: obě verze naservírovat lokálně, v prohlížeči projít stránky a porovnat výšky sekcí a
getComputedStylevybraných vlastností prvek po prvku (písmo, odsazení, barvy), na desktopové i mobilní šířce. Rozdíl = nasazení se zastaví. - Ověřit, že vyřazené třídy nepoužívá vlastní kód mimo předlohu; ten porovnat se stavem před změnou.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: množinový rozdíl „třídy v HTML“ minus „selektory v původním CSS“. Každá neprázdná položka, kterou nový build umí vygenerovat, je kandidát na vizuální rozdíl.
- Anti-pattern: paritu převzatého webu měřit jen textem a strukturou DOM. Shodný
classneznamená shodný vzhled, pokud se liší stylesheet. - Lepší přístup: u převzatého designu buď použít původní CSS beze změny, nebo generovat a rozdíl hlídat měřením v prohlížeči. Platí i opačně: při čištění CSS (purge) může zmizet pravidlo, které předloha používala.
Sister bugs / související
Sekce “Sister bugs / související”- Zrcadlení statického webu, kde má každá stránka vlastní kopii společného skriptu a změna v jedné kopii se při převodu do šablony ztratí (stejná kategorie, záznam ze stejného dne).
- Obecně třída „zelené kontroly, jiný výsledek“: test měří zástupnou veličinu (strukturu) místo toho, co vidí uživatel.