EPUBCheck · Stilmallar

EPUBCheck CSS-029: icke-deklarerad overlay CSS-klass

Uppdaterad: 4 november 2026

EPUBCheck CSS-029 är ett användningsmeddelande: “Found CSS class name "…" but no "…" property was declared in the package document.” CSS använder ett klassnamn för mediaöverlagring, men paketdokumentet deklarerar inte den matchande egenskapen. Med mediaoverlays måste klassen som markerar texten som läses högt deklareras i paketmetadata (media:active-class eller media:playback-active-class); EPUBCheck namnger både klassen och den saknade egenskapen.

Det officiella meddelandet

Found CSS class name "%1$s" but no "%2$s" property was declared in the package document.

Standardsvårighetsgrad: Användning. Informativ endast och gömd som standard: den visas när EPUBCheck körs med -u (--usage). Det gör inte EPUB ogiltig.
EPUBCheck version: 5.4.0

%1$s, %2$s… fylls med filen, värdet eller elementet EPUBCheck som hittades.

Typiska orsaker

Ett stilark kopierat från en bok med uppläsning in i ett paket som aldrig deklarerade klassen.
Paketmetadata har redigerats och media:meta-elementen har tagits bort.

Hur man åtgärdar det

Lägg till egenskapen till paketmetadata, till exempel <meta property="media:active-class">my-active-item</meta>, med exakt ett klassnamn och ingen selektor.
Eller ta bort den oanvända klassen från CSS:en om boken inte har några mediaöverlägg.
Bygg om EPUB och kör EPUBCheck igen för att bekräfta att meddelandet har försvunnit.

När det inte är detta

Om klassen deklareras men ingen CSS når kapitlet, så är felet CSS-030.

Villkor som används här

Andra CSS meddelanden

CSS-028 Use of Font-face declaration.
CSS-030 The package document declares media overlays styling class names but no CSS was found in the content document.
CSS-019 CSS font-face declaration has no attributes.
CSS-015 Alternative style sheets must have a title.
CSS-008 An error occurred while parsing the CSS: ….
CSS-007 Font-face reference "…" refers to non-standard font type "…".

Källor

EPUB 3.3, §9.3.4 Associating style information · läs 4 november 2026

Meddelandetext och allvarlighetsgrad från EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Förklaring av EpubCC.

FAQ

Vad betyder EPUBCheck CSS-029?

Är CSS-029 ett fel?

CSS-029 rapporteras som användning som standard. Informativt endast och doldt som standard: det visas när EPUBCheck körs med -u (--usage). Det gör inte EPUB ogiltig.