EPUBCheck · Documents de contenu XHTML

EPUBCheck HTM_057 : valeur de viewport invalide

Mis à jour : 4 novembre 2026

EPUBCheck HTM_057 est un message d'erreur : “Viewport "…" value must be a positive number or the keyword "device-…".” Une largeur ou une hauteur de viewport n'est pas un nombre positif ou le mot-clé de périphérique correspondant. EPUB accepte un nombre positif simple ou device-width pour la largeur et device-height pour la hauteur.

Le message officiel

Viewport "%1$s" value must be a positive number or the keyword "device-%1$s"

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

EPUBCheck imprime cet ID avec un soulignement au lieu d'un tiret ; cette page utilise l'ID tel que EPUBCheck le rapporte.

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

Causes typiques

Des valeurs avec des unités, telles que 1200px ou 100%.
Zéro, nombres négatifs ou fautes de frappe telles que widht.
Le mot-clé incorrect pour la dimension, tel que height=device-width.

Comment le corriger

Ouvrez le fichier EPUBCheck (le message indique le chemin, la ligne et la colonne) dans un éditeur de texte ou EPUB tel que Sigil, ou décompressez le EPUB et ouvrez-le là.
Utilisez un nombre positif simple, par exemple width=1200, height=1600.
Ou utilisez device-width pour la largeur et device-height pour la hauteur si la page doit remplir l'écran.
Reconstruire le EPUB et exécuter EPUBCheck à nouveau pour confirmer que le message a disparu.

Quand ce n'est pas ça

Si une dimension est complètement manquante, le message est HTM_056.

Termes utilisés ici

Autres messages HTM

HTM_056 Viewport metadata has no "…" dimension (both "width" and "height" properties are required)
HTM_058 HTML documents must be encoded in UTF-8, but UTF-16 was detected.
HTM_055 The "…" element should not be used (discouraged construct)
HTM_059 Viewport "…" property must not be defined more than once, but found values […].
HTM_054 Custom attribute namespace ("…") must not include the string "…" in its domain.
HTM_060b EPUB reading systems must ignore viewport meta elements in reflowable documents; viewport declaration "…" will be ignored.

Sources

EPUB 3.3, §8.2.2.6 Content document dimensions · 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 HTM_057 ?

Est-ce que HTM_057 une erreur ?

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