EPUBCheck · Feuilles de style

EPUBCheck CSS-030 : styles de superposition sans CSS

Mis à jour : 4 novembre 2026

EPUBCheck CSS-030 est un message d'erreur : “The package document declares media overlays styling class names but no CSS was found in the content document.” Le package déclare des noms de classe de style de superposition multimédia, mais un chapitre avec narration n'a pas de CSS. EPUB exige que chaque document de contenu avec une superposition multimédia inclue une feuille de style, liée ou intégrée, qui définit ces classes, sinon le texte lu n'est pas mis en surbrillance comme prévu.

Le message officiel

The package document declares media overlays styling class names but no CSS was found in the content document.

Gravité par défaut: Erreur. Le EPUB enfreint une règle de la spécification et est invalide. Les magasins et l'envoi à Kindle peuvent le rejeter, et EPUBCheck sort avec le statut 1.
version EPUBCheck: 5.4.0

Causes typiques

Un chapitre avec narration qui ne lie pas la feuille de style utilisée par les autres chapitres.
media:active-class déclaré dans le paquet alors que la classe n'est définie nulle part.

Comment le corriger

Liez la feuille de style qui définit les classes des noms de chapitre EPUBCheck, par exemple <link rel="stylesheet" href="styles.css" type="text/css"/>.
Assurez-vous que la feuille de style définit réellement la classe déclarée dans media:active-class (et media:playback-active-class, si utilisée).
Reconstruire le EPUB et exécuter EPUBCheck à nouveau pour confirmer que le message a disparu.

Quand ce n'est pas ça

Si le CSS définit la classe mais que le package ne la déclare pas, le message est CSS-029.

Termes utilisés ici

Autres messages CSS

CSS-029 Found CSS class name "…" but no "…" property was declared in the package document.
CSS-028 Use of Font-face declaration.
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-030 ?

Est-ce que CSS-030 est une erreur ?

CSS-030 est signalé comme erreur par défaut. Le EPUB enfreint une règle de la spécification et est invalide. Les magasins et l'envoi vers Kindle peuvent le rejeter, et EPUBCheck se termine avec le statut 1.