Attributs alt manquants dans Drupal : les corriger à grande échelle sans développement

Pourquoi les attributs alt manquants coûtent cher en accessibilité et en SEO

L'attribut alt (texte alternatif d'une image) est la première brique de l'accessibilité des contenus non textuels. Son absence viole le critère de succès WCAG 1.1.1 « Contenu non textuel » (WCAG : Web Content Accessibility Guidelines, le référentiel international d'accessibilité web), qui constitue l'exigence de base pour rendre les images perceptibles par tous.

Concrètement, un lecteur d'écran ignore complètement une image dépourvue de texte alternatif : un utilisateur aveugle ne sait même pas qu'une image était présente, ce qui rend la navigation confuse et frustrante. Le coût est aussi mesurable côté audits automatisés : Google Lighthouse signale l'erreur sur deux de ses audits, avec jusqu'à 6 points retirés du score Accessibilité et 8 points du score SEO.

Un cas concret : 12 000 images problématiques après une migration Drupal

Le retour d'expérience publié par l'agence Metadrop porte sur la migration d'un site d'actualités sportives multilingue de Drupal 9 vers Drupal 11. Un crawl avec l'outil Screaming Frog a révélé environ 12 000 images avec un attribut alt manquant ou incorrect. Deux types de défauts coexistaient : des images sans aucun attribut alt, et des textes alternatifs dans la mauvaise langue, par exemple des alt en anglais affichés sur la version /es du site.

Point notable : identifier un motif (le problème était-il lié à un type de contenu précis ? à des médias non traduits ?) s'est avéré difficile, car Drupal ne fournit par défaut aucun mécanisme, aucune vue ni aucun rapport pour repérer les images aux attributs alt problématiques.

La cause racine se situait à la source de la migration : sur l'ancien site Drupal 9, certaines images n'avaient jamais eu d'attribut alt, et la migration a transporté cette lacune telle quelle dans la nouvelle architecture.

Image Alt Fallback : un correctif automatique, sans développement

Le module contributif Image Alt Fallback comble automatiquement les attributs alt manquants selon des règles configurables. Ses principes de fonctionnement :

• Il ne cible que les images sans texte alternatif défini : les alt existants ne sont jamais modifiés.
• Un comportement global par défaut est configurable : utiliser le libellé de l'entité parente (par exemple le titre de l'article) comme alt de repli, ou marquer l'image comme décorative.
• Une configuration par champ affine ce comportement : le champ image d'un type de contenu Article peut hériter du titre de l'article, un champ galerie suivre le réglage global, et l'image d'un vocabulaire de taxonomie être marquée décorative.
• Le module détecte actuellement deux types d'entités : les nœuds (contenus) et les taxonomies.

Techniquement, le module agit via un callback post_render (après le rendu de la page) : aucune modification de base de données, aucun changement de template Twig. Il suffit de l'installer et de le configurer.

Il embarque également une vue d'aide qui liste tous les médias avec des filtres par statut de l'alt (vide ou non) et par type, ce qui permet de faire remonter les images problématiques sans assistance technique — comblant ainsi le manque de reporting natif de Drupal sur ce point.

Quand utiliser ce module, et quand corriger à la source

La solution idéale à long terme reste de stocker un texte alternatif pertinent directement sur l'entité File ou Media. Les versions récentes de Drupal rendent d'ailleurs l'attribut alt obligatoire par défaut, mais les anciennes versions ou d'autres systèmes sources ne l'imposent pas toujours : les migrations peuvent donc transporter ces lacunes historiques.

Le problème apparaît aussi hors migration : le champ alt peut être configuré comme optionnel, par erreur de configuration ou par exigence explicite du projet, et des contenus sont alors publiés sans texte alternatif au fil du temps. Dans d'autres cas, l'image est purement décorative, et le bon traitement consiste à la marquer comme telle plutôt que de lui forcer un alt descriptif.

Image Alt Fallback doit donc être considéré comme un filet de sécurité, pas comme une solution permanente : il couvre automatiquement les lacunes pendant que les contenus sont corrigés à la source, où un texte alternatif réellement pertinent reste l'objectif.