Compatibilité de la localisation pour les fichiers manifestes d'applications Web

Alexander Kyereboah
Alexander Kyereboah

Publié le 24 avril 2026

Nous sommes heureux d'annoncer le lancement de la fonctionnalité de localisation des fichiers manifestes dans Chrome et Edge 148. Cette avancée pour les développeurs d'applications Web et leur audience mondiale a été mise en œuvre par l'équipe Microsoft Edge, en collaboration avec l'équipe Chrome.

Pendant trop longtemps, les fichiers manifestes des applications Web n'ont pas bénéficié d'une compatibilité intégrée avec plusieurs langues. Vous étiez donc obligé de choisir entre une expérience dans une seule langue ou des solutions de contournement complexes.

La localisation des fichiers manifestes change la donne en offrant une compatibilité linguistique simple et robuste directement dans votre fichier manifeste.

Le problème : l'absence de compatibilité linguistique dans le fichier manifeste

Avant Chrome et Edge 148, les fichiers manifestes des applications Web ne vous permettaient de définir qu'un seul ensemble de champs, tels que name, description, et short_name pour votre application. Cette limitation signifie que votre application apparaît avec le même nom et la même description quelle que soit la langue préférée de l'utilisateur, ce qui dégrade l'expérience des audiences non anglophones ou multilingues.

Pour prendre en charge plusieurs langues, vous deviez vous appuyer sur des solutions complexes côté client ou renoncer complètement à la localisation.

La solution : la localisation des fichiers manifestes

La localisation des fichiers manifestes est une extension de la spécification des fichiers manifestes des applications Web. Vous pouvez définir des valeurs localisées pour les champs de fichier manifeste tels que name, short_name, description, etc., à l'aide du nouveau suffixe _localized.

Par exemple, en fournissant name et name_localized, vous pouvez spécifier le nom par défaut de votre application et les traductions pour différentes langues directement dans votre fichier manifeste.

Le navigateur sélectionne et affiche automatiquement la version qui correspond le mieux aux préférences linguistiques de l'utilisateur, créant ainsi une expérience multilingue fluide, de l'installation à l'utilisation réelle.

Définir des champs localisés

Pour utiliser la localisation des fichiers manifestes, ajoutez des champs avec le _localized suffixe à votre manifest.json fichier, en définissant les traductions à l'aide des BCP47 BCP47 :

{
 "lang": "en-US",
 "dir": "ltr",
 "name": "Color Picker",
 "name_localized": {
  "de": "Farbwähler",
  "en": {"value": "Color Picker"},
  "en-GB": {"value": "Colour Picker", "dir": "ltr"},
  "fr": {"value": "Sélecteur de Couleur", "lang": "fr-CA", "dir": "ltr"},
  "ar": {"value": "`منتقي` `الألوان`", "dir": "rtl"}
 }
}

Avec cette structure, un utilisateur dont le navigateur est défini sur une langue correspondant à l'une des entrées verra le nom de votre application dans sa langue. Sinon, la valeur du nom par défaut est utilisée.

Actuellement, les champs de fichier manifeste d'application Web disponibles pour la localisation sont les suivants :

  • name
  • short_name
  • description
  • icons
  • shortcuts
    • name
    • short_name
    • description
    • icons

Pour obtenir une liste détaillée des champs localisables et des détails complets sur l’implémentation, consultez la spécification des fichiers manifestes des applications Web.

Démo

Pour voir la fonctionnalité de localisation des fichiers manifestes en action, consultez notre application de démonstration dans Chrome ou Edge 148 ou version ultérieure :

Commentaires

La localisation des fichiers manifestes est disponible dans Chrome et Microsoft Edge à partir de la version 148. Nous vous encourageons à tester cette fonctionnalité, à nous faire part de vos commentaires et à nous aider à l'améliorer pour un Web plus multilingue. Essayez-la dès maintenant et dites-nous ce que vous pensez !

Faites-nous part de vos commentaires en créant un problème dans le dépôt de fichiers manifestes du W3C.