ウィジェットの品質

ユーザーがウィジェットをホスト サーフェスに配置したときに、ウィジェットがホストグリッドの境界を埋めない。

ウィジェットがグリッドの少なくとも 2 つの対向するエッジに接していない。つまり、ウィジェットはすべて長方形である必要はなく、形状のエッジがグリッドの少なくとも 2 つのエッジに接している限り、カスタム形状にすることができます。

ウィジェットのテキストとアイコンボタンの色のコントラスト比が、ユーザー補助の要件を満たすには不十分です。

ウィジェット名がウィジェットのデザインに含まれていない。

ウィジェットにプレビュー画像がありません。

ウィジェットのコンテンツが常に古い、またはタイムリーでない。

ユーザーがウィジェットからアクションを完了しても、ウィジェットが更新されない。

ユーザーがアプリ内から関連するアクションを完了しても、ウィジェットが更新されない。

ウィジェットの UI が機能しない、またはコンテンツが切り抜かれている。

ウィジェットは、縦軸または横軸で他のホスト要素と揃えられ、余分なスペースを占有しません。

すべての図形は、グリッドの境界の少なくとも 2 つの対向するエッジに接する必要があります。

ウィジェットのサイズを変更できる場合は、最小サイズと最大サイズを定義します。ウィジェットが大きくなるにつれて、より多くのコンテンツが表示されるようにレイアウトを再配置します。テキストとアイコンを線形にスケーリングしないでください。

ウィジェットのサイズを大きくしても空白スペースが増えるだけの場合は、最大幅または最大高さを設定します。ウィジェットを大きくすると、より多くのコンテンツ（縦長のスクロール リストなど）が表示される場合は、サイズ変更を制限しないようにします。

ウィジェットの最小サイズは、明確なユースケースを表示し、48x48 dp のタップ ターゲット要件を満たすのに十分な大きさにする必要があります。システムは、パソコンや車載画面のタップ ターゲットをスケーリングできます。

ウィジェット選択ツールに正確なプレビュー（静的アセット）が表示される。

ゼロ状態と空の状態は、まばらな領域がないように、より大きなウィジェット境界にスケーリングする必要があります。ユーザーがログインする前にウィジェットをインストールした場合、ウィジェットには明確なユースケースまたは行動を促すフレーズを表示する必要があります。

データが UI よりも頻繁に更新されることが想定される場合、ウィジェットを使用すると、ユーザーはコンテンツを手動で更新できます。

ウィジェットは、縦軸または横軸で他のホスト要素と揃えられ、余分なスペースを占有しません。

すべての長方形ウィジェットは、グリッドの境界の 4 つの端すべてに接しなければなりません。カスタム形状のウィジェットはすべて、正方形グリッドの境界の 4 つのエッジすべてに接しなければなりません。サイズが 4x1 で、検索バーが含まれている場合は、2 つの端にのみ接することができます。

ユーザーはウィジェットのサイズを 2x1 と、1x1、2x2、4x2、4x4 のうち少なくとも 2 つのサイズに変更できます。

ウィジェット ヘッダーが使用され、一貫して適用されている。

• 次のような場合は、ヘッダーを使用することをおすすめします。
  • ウィジェットにスクロール コンテンツが含まれている。
  • ヘッダー コンテンツは、リストの名前など、有用なコンテキストを提供します。
• 次の場合、ヘッダーの使用は任意です。
  • ウィジェットがフルブリード（写真ウィジェットなど）である。
  • 参加枠には限りがあります。
  • ヘッダー コンテンツが重複している場合。
• ヘッダーを使用する場合は、次の点を確認してください。
  • アイコンが常に表示される
  • 十分なスペースがある場合にタイトルが表示される
  • アクションはウィジェットのコンテキストに基づきます。

コレクション ウィジェットとフィード ウィジェットは、垂直スクロール コンテナをサポートしています。4x2 や 4x4 などの大きなサイズでは、これらのウィジェットに表示されるアイテム数が増え、アイテムごとの詳細情報も増えます。

ウィジェットは、デバイスまたはアプリのコンテキストに基づくカラーテーマをサポートしています。

ウィジェットは、ライトモードとダークモードのパレットをサポートしています。

プレビューには、ターゲット フォーム ファクタのレイアウト比率が表示され、ユーザー コンテンツが含まれるか、システムテーマが適用されるか、またはその両方が行われます。

ウィジェットに、ユーザーがウィジェットの価値を理解するのに役立つ説明がある。

ウィジェット名がわかりやすく、アプリの他のウィジェットと重複していない。

長方形のウィジェットでは、システム（OEM 固有）が提供する角丸を使用する必要があります。

ウィジェットは読み込み状態の仕様を使用し、ウィジェットの UI にエラーを直接表示します。

ウィジェットが、カスタム ウィジェット設定のエントリ ポイントではなく、システム構成を使用している。

ウィジェットからアプリを起動または終了するときに、ウィジェットがシステム起動遷移を使用する。