ウェブアプリ マニフェストのローカライズのサポート

Alexander Kyereboah
Alexander Kyereboah

公開日: 2026 年 4 月 24 日

Chrome と Edge 148 でマニフェストのローカライズ機能がリリースされました。ウェブアプリ デベロッパーとそのグローバル ユーザーにとってのこの進歩は、Microsoft Edge チームが Chrome チームと協力して実装したものです。

ウェブアプリ マニフェストは、長い間、複数の言語をサポートする機能が組み込まれていませんでした。そのため、単一言語のエクスペリエンスか、複雑な回避策のいずれかを選択する必要がありました。

マニフェストのローカライズは、シンプルで堅牢な言語サポートをマニフェスト ファイルに直接組み込むことで、この問題を解決します。

問題: マニフェストで言語がサポートされていない

Chrome と Edge 148 より前は、ウェブアプリ マニフェストでアプリの namedescriptionshort_name などのフィールドを 1 つのセットしか定義できませんでした。この制限により、ユーザーの優先言語に関係なく、アプリは同じ名前と説明で表示され、英語以外のユーザーや多言語ユーザーのユーザー エクスペリエンスが低下していました。

複数の言語をサポートするには、複雑なクライアントサイド ソリューションに頼るか、ローカライズを完全に諦める必要がありました。

解決策: マニフェストのローカライズ

マニフェストのローカライズは、ウェブアプリ マニフェスト仕様の拡張機能です。新しい _localized 接尾辞を使用すると、nameshort_namedescription などのマニフェスト フィールドのローカライズされた値を定義できます。

たとえば、namename_localized を指定することで、アプリのデフォルト名と、さまざまな言語の翻訳をマニフェスト内で直接指定できます。

ブラウザは、ユーザーの言語設定に最も適したバージョンを自動的に選択して表示するため、インストールから実際の使用まで、シームレスな多言語エクスペリエンスが実現します。

ローカライズされたフィールドを定義する

マニフェストのローカライズを使用するには、_localized 接尾辞が付いたフィールドを manifest.json ファイルに追加し、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"}
 }
}

この構造では、ブラウザの言語設定がエントリのいずれかに一致するユーザーには、アプリ名がその言語で表示されます。それ以外の場合は、デフォルトの名前値が使用されます。

現在、ローカライズに使用できるウェブアプリ マニフェスト フィールドは次のとおりです。

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

ローカライズ可能なフィールドの詳細なリストと実装の詳細については、ウェブアプリ マニフェストの仕様をご覧ください。

デモ

マニフェストのローカライズ機能の動作を確認するには、Chrome または Edge 148 以降でデモアプリをご覧ください。

フィードバック

マニフェストのローカライズは、Chrome と Microsoft Edge のバージョン 148 以降で利用できます。ぜひお試しいただき、フィードバックをお寄せください。いただいたフィードバックは、多言語対応のウェブへの移行に向けて、この機能の改善に活用させていただきます。ぜひお試しいただき、ご意見、ご感想をお寄せください。

フィードバックは、W3C マニフェスト リポジトリで新しい問題を作成してお知らせください。