EPUBCheck · Folhas de estilo

EPUBCheck CSS-029: classe CSS de sobreposição não declarada

Atualizado: 4 de Novembro de 2026

EPUBCheck CSS-029 é uma mensagem de uso: “Found CSS class name "…" but no "…" property was declared in the package document.” O CSS usa um nome de classe de destaque de sobreposição de mídia, mas o documento do pacote não declara a propriedade correspondente. Com sobreposições de mídia, a classe que destaca o texto sendo lido em voz alta deve ser declarada nos metadados do pacote (media:active-class ou media:playback-active-class); EPUBCheck nomeia tanto a classe quanto a propriedade ausente.

A mensagem oficial

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

Severidade padrão: Uso. Apenas informativo e oculto por padrão: aparece quando EPUBCheck é executado com -u (--usage). Não torna o EPUB inválido.
versão EPUBCheck: 5.4.0

%1$s, %2$s… são preenchidos com o arquivo, valor ou elemento EPUBCheck encontrado.

Causas típicas

Uma folha de estilo copiada de um livro com narração para um pacote que nunca declarou a classe.
Os metadados do pacote foram editados e os elementos media: meta foram removidos.

Como consertar isso

Adicione a propriedade aos metadados do pacote, por exemplo <meta property="media:active-class">my-active-item</meta>, com exatamente um nome de classe e nenhum seletor.
Ou remova a classe não utilizada do CSS se o livro não tiver sobreposições de mídia.
Reconstrua o EPUB e execute EPUBCheck novamente para confirmar que a mensagem desapareceu.

Quando não é isso

Se a classe estiver declarada, mas nenhuma CSS atingir o capítulo, o erro é CSS-030.

Termos usados aqui

Outras mensagens de 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 "…".

Fontes

EPUB 3.3, §9.3.4 Associating style information · ler 4 de Novembro de 2026

Texto da mensagem e severidade de EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explicação por EpubCC.

FAQ

O que significa EPUBCheck CSS-029?

É CSS-029 um erro?

CSS-029 é reportado como uso por padrão. Apenas informativo e oculto por padrão: aparece quando EPUBCheck é executado com -u (--usage). Isso não torna EPUB inválido.