MiniApp マニフェスト

MiniApp マニフェストは、そのルートに次のメンバーを 含まなければなりません（MUST）:

• app_id
• icons
• name
• pages
• platform_version
• version

MiniApp マニフェストの icons メンバー内の各画像 リソースオブジェクトは、次を含まなければなりません（MUST）:

• src

MiniApp マニフェストは、そのルートに widgets メンバーを含んでも構いません（MAY）。このメンバーは、リストである MiniApp ウィジェット リソースの配列を含まなければなりません（MUST）。各 MiniApp ウィジェット・リソースオブジェクトは、 次のメンバーを含まなければなりません（MUST）:

• name
• path

MiniApp マニフェストは、そのルートに req_permissions メンバーを含んでも構いません（MAY）。このメンバーは、リストである MiniApp 権限リソースの配列を含まなければなりません（MUST）。各 MiniApp 権限リソースオブジェクトは、 次のメンバーを含まなければなりません（MUST）:

• name

MiniApp ユーザー・エージェントは、任意のメンバーをサポートして、マニフェストのベンダー固有拡張を実装しても構いません（MAY）。

次の表は、MiniApp マニフェストのメンバーの概要を示します:

MiniApp マニフェストは、次の基本的なアプリケーション・ マニフェストのメンバーを使用します。

次のメンバーは、Web App Manifest - Application Information 仕様 [MANIFEST-APP-INFO] で定義されています。

次のメンバーは、MiniApp マニフェストの範囲内で定義され、MiniApp の特定の側面を扱います。

appIdRule = name *("." name)
name = ALPHA [*( ALPHA / DIGIT / "-" ) ( ALPHA / DIGIT)]

MiniApp マニフェストは、アプリケーション・マニフェストの拡張として、 [APPMANIFEST] で定義される マニフェストの 処理アルゴリズムの拡張点で処理される補足アルゴリズムを提供します。したがって、ユーザー・エージェントは アプリケーション・マニフェストのメンバーの 処理から開始し、拡張点において、次のアルゴリズムを使用して MiniApp マニフェストのメンバーの処理を続行します。

拡張点で、順序付きマップ json と 順序付きマップ manifest が与えられたとき、MiniApp マニフェストを処理するには:

1. manifest["name"] が存在しない場合、throw で TypeError を投げる。
2. manifest["icons"] が存在しない場合、throw で TypeError を投げる。
3. icons を manifest["icons"] とする。
4. icons["src"] が存在しない場合、throw で TypeError を投げる。
5. manifest["icons"] が存在しない場合、throw で TypeError を投げる。
6. json および manifest を渡して、 app_id メンバーを処理する。
7. manifest["app_id"] が存在しない場合、throw で TypeError を投げる。
8. json および manifest を渡して、color_scheme メンバーを処理する。
9. json および manifest を渡して、description メンバーを処理する。
10. json および manifest を渡して、device_type メンバーを処理する。
11. json および manifest を渡して、 pages メンバーを処理する。
12. manifest["pages"] が存在しない場合、throw で TypeError を投げる。
13. json および manifest を渡して、platform_version メンバーを処理する。
14. manifest["platform_version"] が存在しない場合、throw で TypeError を投げる。
15. json および manifest を渡して、req_permissions メンバーを処理する。
16. json および manifest を渡して、 version メンバーを処理する。
17. manifest["version"] が存在しない場合、throw で TypeError を投げる。
18. json および manifest を渡して、 widgets メンバーを処理する。
19. json および manifest を渡して、 window メンバーを処理する。

MiniApp プラットフォーム・バージョン・リソースの min_code メンバーは、MiniApp の通常動作を保証するために MiniApp ユーザー・エージェントのプラットフォームが 対応する最小バージョンを示す非負整数です。

順序付きマップ json と 順序付きマップ platform_version が与えられたとき、プラットフォーム・バージョンの min_code メンバーを処理するには:

1. json["min_code"] が存在しない場合、または json["min_code"] が数値でない場合、failure を返す。
2. platform_version["min_code"] を json["min_code"] に設定する。

MiniApp プラットフォーム・バージョン・リソースの release_type メンバーは、アプリケーションの実行に必要な MiniApp ユーザー・エージェントの対象プラットフォーム・ バージョンのリリース種別を示す文字列です。

順序付きマップ json と 順序付きマップ platform_version が与えられたとき、プラットフォーム・バージョンの release_type メンバーを処理するには:

1. json["release_type"] が存在しない場合、または json["release_type"] が文字列でない場合、戻る。
2. platform_version["release_type"] を json["release_type"] に設定する。

MiniApp プラットフォーム・バージョン・リソースの target_code メンバーは、MiniApp の通常動作を保証するために MiniApp ユーザー・エージェントのプラットフォームが 対応する対象バージョンを示す非負整数です。

順序付きマップ json と 順序付きマップ platform_version が与えられたとき、プラットフォーム・バージョンの target_code メンバーを処理するには:

1. json["target_code"] が存在しない場合、または json["target_code"] が数値でない場合、戻る。
2. platform_version["target_code"] を json["target_code"] に設定する。

MiniApp 権限リソースの name メンバーは、要求される機能の名前を示す文字列です。

順序付きマップ json と 順序付きマップ permission が与えられたとき、権限リソースの name メンバーを処理するには:

1. json["name"] が存在しない場合、または
   json["name"] が文字列でない場合、または json["name"] が空文字列である場合、戻る。
2. permission["name"] を json["name"] に設定する。

任意のMiniApp 権限リソースの reason メンバーは、 [MiniApp permission resource/name=] 属性で指定される機能を要求するために示される理由を 表す文字列です。

順序付きマップ json と 順序付きマップ permission が与えられたとき、権限リソースの reason メンバーを処理するには:

1. json["reason"] が存在しない場合、または
   json["reason"] が文字列でない場合、または json["reason"] が空文字列である場合、戻る。
2. permission["reason"] を json["reason"] に設定する。

MiniApp バージョン・リソースの code メンバーは、MiniApp のバージョンを表す非負整数です。これは主に MiniApp の保守性とセキュリティを 高めるために使用されます（例: 増分バージョン間の互換性）。 code メンバーは、開発およびデプロイメント・プロセスを支援することを目的としており、通常はエンドユーザーには 表示されません。

順序付きマップ json と 順序付きマップ version が与えられたとき、バージョンの code メンバーを処理するには:

1. json["code"] が存在しない場合、または json["code"] が数値でない場合、failure を返す。
2. version を数値とし、初期値を 1 とする。
3. json["code"] が 0 より大きい場合:
   version を json["code"] に設定する。
4. version["code"] を version に設定する。

MiniApp バージョン・リソースの name メンバーは、MiniApp のバージョンに関する情報を記述するために 主に使用される文字列であり、バージョン管理、MiniApp アプリケーション、 およびプラットフォーム互換性において重要な役割を果たします。これは通常、公開されユーザーに表示される バージョンと見なされます。

順序付きマップ json と 順序付きマップ version が与えられたとき、バージョンの name メンバーを処理するには:

1. json["name"] が存在しない場合、または json["name"] が文字列でない場合、failure を返す。
2. version["name"] を json["name"] に設定する。

MiniApp ウィジェット・リソースの name メンバーは、ウィジェットのタイトルを示す文字列です。

順序付きマップ json と 順序付きマップ widget が与えられたとき、ウィジェットの name メンバーを処理するには:

1. json["name"] が存在しない場合、または json["name"] が文字列でない場合、戻る。
2. widget["name"] を json["name"] に設定する。

MiniApp ウィジェット・リソースの path メンバーは、ウィジェットに対応する ページ・ルートを定義するrelative-url stringであり、 pages リストと同じ形式で表されます。

順序付きマップ json と 順序付きマップ widget が与えられたとき、ウィジェットの path メンバーを処理するには:

1. json["path"] が存在しない場合、または json["path"] が文字列でない場合、戻る。
2. url を、json["path"] を構文解析した結果とする。
3. url が失敗である場合、戻る。
4. widget["path"] を url に設定する。

任意のMiniApp ウィジェット・リソースの min_code メンバーは、MiniApp ウィジェットに対応する最小 プラットフォーム・バージョンを示す数値です。

順序付きマップ json、順序付きマップ widget、および 順序付きマップ manifest が与えられたとき、ウィジェットの min_code メンバーを処理するには:

1. widget["min_code"] を manifest["min_code"] に設定する。
2. json["min_code"] が存在しない場合、または json["min_code"] が文字列でない場合、戻る。
3. widget["min_code"] を json["min_code"] に設定する。

auto_design_width メンバーは、ページの design_width がユーザー・エージェントによって自動計算されるかどうかを示す真偽値です。 auto_design_width が true の場合、 design_width の値は無視されます。この場合、システムの基準幅は画面のピクセル密度に応じて自動的に決定されます。

既定値: false。

順序付きマップ json と 順序付きマップ window が与えられたとき、ウィンドウの auto_design_width メンバーを処理するには:

1. json["auto_design_width"] が存在しない場合、または json["auto_design_width"] が真偽値でない場合、戻る。
2. window["auto_design_width"] を json["auto_design_width"] に設定する。

background_color メンバーは、MiniApp を 含むウィンドウの背景色を指定する文字列です。

このメンバーは sRGB 色をサポートし、 アプリケーション・マニフェストの background_color と等価です。

既定値: "#ffffff"。

background_text_style メンバーは、背景テキスト・スタイルを指定する文字列であり、 明るいまたは暗いカラーテーマ（すなわち、"light" または "dark"）を示します。

このメンバーは prefers-color-scheme の値をサポートし、次のいずれかの背景テキスト・スタイル値を含まなければなりません（MUST）:

"light"

明るいスタイル用。

"dark" （既定）

暗いスタイル用。

順序付きマップ json と 順序付きマップ window が与えられたとき、ウィンドウの background_text_style メンバーを処理するには:

1. json["background_text_style"] が存在しない場合、または
   json["background_text_style"] が文字列でない場合、または
   json["background_text_style"] が含むものとして 背景テキスト・スタイル値のいずれにも一致しない場合、戻る。
2. window["background_text_style"] を json["background_text_style"] に設定する。

design_width メンバーは、ページ設計の基準幅をピクセル単位で示す数値です。 これはページ・コンポーネントを視覚的に調整するために使用されます。

値は非負整数であり、既定値は 750 です。

順序付きマップ json と 順序付きマップ window が与えられたとき、ウィンドウの design_width メンバーを処理するには:

1. json["design_width"] が存在しない場合、または
   json["design_width"] が数値でない場合、または json["design_width"] が 0 未満である場合、戻る。
2. window["design_width"] を json["design_width"] に設定する。

enable_pull_down_refresh メンバーは、MiniApp とのインタラクション中に pull-to-refresh イベントが有効かどうかを 指定する真偽値です。

既定値: false。

順序付きマップ json と 順序付きマップ window が与えられたとき、ウィンドウの enable_pull_down_refresh メンバーを処理するには:

1. json["enable_pull_down_refresh"] が存在しない場合、
   または json["enable_pull_down_refresh"] が真偽値でない場合、戻る。
2. window["enable_pull_down_refresh"] を json["enable_pull_down_refresh"] に設定する。

fullscreen メンバーは、MiniApp が全画面表示モードで表示されるかどうかを示す真偽値です。

既定値: false。

順序付きマップ json と 順序付きマップ window が与えられたとき、ウィンドウの fullscreen メンバーを処理するには:

1. json["fullscreen"] が存在しない場合、
   または json["fullscreen"] が真偽値でない場合、戻る。
2. window["fullscreen"] を json["fullscreen"] に設定する。

navigation_bar_background_color メンバーは、MiniApp のナビゲーション・バーの背景色を指定する文字列です。

このメンバーは sRGB 色をサポートします。

既定値: "#000000"。

このメンバーは、[APPMANIFEST] で指定されるものに従って処理されます。

navigation_bar_text_style メンバーは、ナビゲーション・バーのタイトルのテキスト色（すなわち、"white" または "black"）を示す 文字列です。

このメンバーは、次のいずれかのテキスト・スタイル値を 含まなければなりません（MUST）:

"white" （既定）

白いテキスト色用。

"black"

黒いテキスト色用。

順序付きマップ json と 順序付きマップ window が与えられたとき、ウィンドウの navigation_bar_text_style メンバーを処理するには:

1. json["navigation_bar_text_style"] が存在しない場合、または
   json["navigation_bar_text_style"] が文字列でない場合、または
   json["navigation_bar_text_style"] が 含むものとして テキスト・スタイル値のいずれにも一致しない場合、戻る。
2. window["navigation_bar_text_style"] を json["navigation_bar_text_style"] に設定する。

navigation_bar_title_text メンバーは、MiniApp のナビゲーション・バーのタイトルを指定する文字列です。

順序付きマップ json と 順序付きマップ window が与えられたとき、ウィンドウの navigation_bar_title_text メンバーを処理するには:

1. json["navigation_bar_title_text"] が存在しない場合、または
   json["navigation_bar_title_text"] が文字列でない場合、戻る。
2. window["navigation_bar_title_text"] を json["navigation_bar_title_text"] に設定する。

navigation_style メンバーは、ナビゲーション・バーのスタイル（すなわち、"default" または "custom"）を指定する 文字列です。

このメンバーは、次のいずれかのナビゲーション・ スタイル値を含まなければなりません（MUST）:

"default" （既定）

既定のスタイルを適用するため。

"custom"

カスタマイズされたナビゲーション・バーを適用するため。

順序付きマップ json と 順序付きマップ window が与えられたとき、ウィンドウの navigation_style メンバーを処理するには:

1. json["navigation_style"] が存在しない場合、または
   json["navigation_style"] が文字列でない場合、または
   json["navigation_style"] が含むものとして ナビゲーション・スタイル値のいずれにも一致しない場合、戻る。
2. window["navigation_style"] を json["navigation_style"] に設定する。

on_reach_bottom_distance メンバーは、ページのプルアップ・イベントを発火するために必要な、ウィンドウ下端からの垂直オフセットを 定義する数値です。このメンバーの値は、ピクセル単位で 表される非負整数です。

既定値: 50。

順序付きマップ json と 順序付きマップ window が与えられたとき、ウィンドウの on_reach_bottom_distance メンバーを処理するには:

1. json["on_reach_bottom_distance"] が存在しない場合、または
   json["on_reach_bottom_distance"] が数値でない場合、または
   json["on_reach_bottom_distance"] が 0 未満である場合、戻る。
2. window["on_reach_bottom_distance"] を json["on_reach_bottom_distance"] に設定する。

orientation メンバーは、MiniApp の画面の向きの設定を指定する文字列です。

このメンバーは、OrientationLockType [SCREEN-ORIENTATION] で定義される 向きの値、すなわち "portrait" および "landscape" をサポートします。

既定値: "portrait"。

順序付きマップ json と 順序付きマップ window が与えられたとき、ウィンドウの orientation メンバーを処理するには:

1. json["orientation"] が存在しない場合、または
   json["orientation"] が文字列でない場合、または
   json["orientation"] が含むものとして 向きの値のいずれにも一致しない場合、戻る。
2. window["orientation"] を json["orientation"] に設定する。