EPUBCheck · Feuilles de style

EPUBCheck CSS-029 : classe CSS de superposition non déclarée

Mis à jour : 4 novembre 2026

EPUBCheck CSS-029 est un message d'utilisation : “Found CSS class name "…" but no "…" property was declared in the package document.” Le CSS utilise un nom de classe de surlignage de superposition médiatique, mais le document de package ne déclare pas la propriété correspondante. Avec les superpositions médiatiques, la classe qui surligne le texte lu à haute voix doit être déclarée dans les métadonnées du package (media:active-class ou media:playback-active-class) ; EPUBCheck nomme à la fois la classe et la propriété manquante.

Le message officiel

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

Gravité par défaut: Utilisation. Informative uniquement et cachée par défaut : elle apparaît lorsque EPUBCheck s'exécute avec -u (--usage). Cela ne rend pas le EPUB invalide.
version EPUBCheck: 5.4.0

%1$s, %2$s… sont remplis avec le fichier, la valeur ou l'élément EPUBCheck trouvé.

Causes typiques

Une feuille de style copiée d'un livre avec narration dans un package qui n'a jamais déclaré la classe.
Les métadonnées du package ont été éditées et les éléments media:meta ont été supprimés.

Comment le corriger

Ajoutez la propriété aux métadonnées du paquet, par exemple <meta property="media:active-class">my-active-item</meta>, avec exactement un nom de classe et aucun sélecteur.
Ou retirez la classe non utilisée du CSS si le livre n'a pas de superpositions multimédias.
Reconstruire le EPUB et exécuter EPUBCheck à nouveau pour confirmer que le message a disparu.

Quand ce n'est pas ça

Si la classe est déclarée mais qu'aucun CSS n'atteint le chapitre, l'erreur est CSS-030.

Termes utilisés ici

Autres messages CSS

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 "…".

Sources

EPUB 3.3, §9.3.4 Associating style information · lire 4 novembre 2026

Texte et gravité du message de EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explication par EpubCC.

FAQ

Que signifie EPUBCheck CSS-029 ?

Est-ce que CSS-029 est une erreur ?

CSS-029 est signalé comme utilisation par défaut. Informative uniquement et cachée par défaut : elle apparaît lorsque EPUBCheck s'exécute avec -u (--usage). Cela ne rend pas le EPUB invalide.