Power Apps での ギャラリー コントロール

その他のコントロールが含まれており、一連のデータを表示するコントロール。

内容

ギャラリー コントロールにデータ ソース内のさまざまなレコードを表示できます。各レコードにさまざまなタイプのデータを含めることができます。 たとえば、ギャラリー コントロールを使用して、各連絡先の名前、住所、電話番号を含む連絡先情報を表示する各項目に複数の連絡先を表示します。

各データ フィールドは、ギャラリー コントロール内の個別のコントロールに表示されます。 さらに、それらのコントロールをテンプレートで構成できます。 テンプレートがギャラリー内の最初の項目として表示されます:

• 水平/横方向のギャラリー コントロールの左端。
• 垂直/縦方向のギャラリー コントロールの上部。

テンプレートで加えた変更は、ギャラリー コントロール全体に反映されます。

ギャラリーで画像やテキストを表示する事前定義されたテンプレート、および高さが可変の項目のギャラリーを利用できます。

制限

ギャラリー コントロールには、次の制限があります:

1. ユーザーが、すべての項目が読み込まれる前に伸縮可能な高さギャラリーコントロールをスクロールする場合、データの読み込みが完了すると、現在表示されている項目が押し出されて表示されなくなる場合があります。 この問題を回避するには、伸縮可能な高さバリアントの代わりに、標準の ギャラリー コントロールを使用します。
2. 次のコントロールは、ギャラリー内ではサポートされていません:
   • 表示フォーム
   • 編集フォーム
   • PDF ビューア―
   • Power BI タイル
   • リッチ テキスト エディター
   • スクロール可能な画面 (流体グリッド)
   • Web バーコード スキャナー
3. 別のギャラリー内に追加できるギャラリーは 1 つだけです。
4. 最小 TemplateSize は 1 です。 これは、テンプレートのサイズを考慮しない場合、ギャラリー のコントロールが予想される X または Y 値からずれる原因になります。
5. アプリをデータから自動的に生成し、アプリを保存してからもう一度開くと、閲覧ギャラリーにすぐにはデータが表示されない場合があります。 この問題を解決するには、検索ボックスに、少なくとも 1 つの文字を入力し、入力したテキストを削除します。 ギャラリーは、意図したとおりにデータを表示します。
6. ギャラリーに、ギャラリーと同じ データ ソース またはコレクションにパッチを適用するルールを含むComboBox、DatePicker、Slider、またはToggleコントロールが含まれている場合、予期しないパフォーマンスの低下やパフォーマンスの低下が発生する可能性があります。 OnChange これは、ギャラリーの データ ソース にパッチを適用するルールによって、パッチ適用と再読み込みの無限のサイクルが作成される可能性があるためです。 OnChange この問題を回避するには、これらのコントロールをギャラリー内に配置する際にルールを使用しないことをお勧めします。 OnChange

重要なプロパティ

Default – アプリの起動時に、ギャラリーで選択されるデータ ソースからの項目またはレコード。

Items – ギャラリー、リスト、グラフなどのコントロールに表示されるデータのソース。

Selected – 選択された項目です。

追加のプロパティ

AccessibleLabel – スクリーン リーダー用のギャラリーのラベル (含まれている項目ではない)。 項目の一覧について説明する必要があります。

AllItems – ギャラリーに読み込まれたアイテム。 これは、データ ソース の アイテム の実際の数よりも少ない場合があります。 ギャラリーをスクロールすると、さらに多くのアイテムが読み込まれる場合があります。 AllItems には、各ギャラリー アイテムで使用されるコントロールも含まれています。

AllItemsCount – ギャラリーに読み込まれたアイテム数。 これは、データ ソース の アイテム の実際の数よりも少ない場合があります。 ギャラリーをスクロールすると、さらに多くのアイテムが読み込まれる場合があります。

BorderColor – コントロールの境界線の色。

BorderStyle – コントロールの境界線が実線、破線、点線、またはなしかどうか。

BorderThickness – コントロールの境界線の太さ。

DelayItemLoading - 画面が最初に読み込まれるまで、項目 (行) の読み込みを遅延させます。

DisplayMode – コントロールがユーザー入力を許可するか (編集)、データのみを表示するか (表示)、または無効にするか (無効)。

Fill – コントロールの背景色。

Height – コントロールの上端と下端間の距離。

ItemAccessibleLabel – スクリーン リーダー用の各ギャラリー項目のラベル。 各アイテムについて説明する必要があります。

LoadingSpinner (なし、コントロールまたはデータ) - なしの場合、スピナーは表示されません。 コントロール時 | 空の行が表示されるレンダリング パスが発生すると、データ、スピナーが表示されます。

LoadingSpinnerColor - スピナーを読み込む塗りつぶしの色。 既定では、BorderColor に設定されています。

NavigationStep – ShowNavigation プロパティが true に設定され、ユーザーがそのギャラリーの両端にあるナビゲーション矢印を選択する場合、ギャラリーをどの程度スクロールするか。

Selectable – ギャラリー項目を選択できるかどうか。 true に設定した場合、スクリーン リーダーはギャラリーを選択可能なリストとして識別します。 さらに、項目を選択することにより選択します。 false に設定した場合、スクリーン リーダーはギャラリーを通常のリストとして識別し、項目を選択しても選択されません。

ShowNavigation – ギャラリーの各端に矢印を表示し、矢印の選択によりギャラリー内の項目をユーザーがスクロールできるようにするかどうか。

ShowScrollbar – ユーザーがャラリーにカーソルを置くときにスクロールバーが表示されるかどうか。

TemplateFill – ギャラリーの背景色。

TemplatePadding – ギャラリー内の項目間の距離。

TemplateSize – 垂直/縦向きのギャラリーのテンプレートの高さ。 または、水平/横向きのギャラリーのテンプレートの幅。 最小サイズは 1 です。

Transition – ユーザーがギャラリー内の項目にカーソルを置くときの視覚効果 (ポップ、プッシュ、またはなし)。

Visible – コントロールが表示されるか非表示になるか。

Width – コントロールの左端と右端間の距離。

WrapCount – 水平または垂直レイアウトに合わせて行または列ごとに表示される項目の数。

X – コントロールの左端とその親コンテナまたはスクリーンの左端との間の距離。

Y – コントロールの上端と親コンテナまたはスクリーンの上端との間の距離。

関連する関数

Filter( DataSource, 式 )

リセット(コントロール) - ギャラリーを初期状態にリセットします。 初期状態には、最初の項目へのスクロールと、最初の項目または存在する場合はデフォルトの選択が含まれます。

注意

Reset コントロールは、ギャラリーのすべての子を再帰的にリセットしません。

例

データを表示およびフィルター処理する

• テキストの表示
• 画像の表示
• リスト オプションを選択してデータのフィルター処理
• スライダーを調整してデータのフィルター処理

ユーザーからデータを取得する

• テキストの取得
• 画像の取得
• 写真の取得
• サウンドの取得
• 図面の取得

アクセシビリティ ガイドライン

色のコントラスト

ギャラリー項目内のどこかをクリックするとその項目が選択される場合、次の間に適切な色のコントラストが必要です:

• BorderColor とギャラリーの外側の色 (境界線がある場合)。
• Fill とギャラリーの外側の色 (境界線がない場合)。

スクリーン リーダー サポート

• AccessibleLabel が存在する必要があります。

  注意

  ギャラリー内の項目が変更されると、スクリーン リーダーから通知されます。 AccessibleLabel についても通知されます。 これによって通知のコンテキストがわかるので、同じ画面上に複数のギャラリーがある場合にはさらに重要です。

• ギャラリー項目に複数のコントロールが含まれている場合は、ItemAccessibleLabel を使用してギャラリー項目のコンテンツを表示します。

• ユーザーにギャラリー項目を選択させる場合は、Selectableの値を true に設定します。 それ以外の場合は、その値を false に設定します。

• ギャラリー項目に複数のコントロールが含まれている場合は、ItemAccessibleLabel を使用してギャラリー項目のコンテンツの概要を提供します。

• ユーザーがギャラリー項目を選択するようになっているかどうかに応じて、Selectableを適切に設定する必要があります。

キーボードのサポート

• ShowScrollbar を true に設定することを検討してください。 ほとんどのタッチ画面を持つデバイスでは、スクロールが始まるまでスクロール バーは表示されません。

• ギャラリー項目内のどこかをクリックするとその項目が選択されるようになっている場合、キーボード ユーザーがギャラリー項目を選択できる方法も必要です。 たとえば、OnSelect プロパティが Select(Parent) に設定されている ボタン を追加します。

  注意

  ギャラリーの外部のコントロールは、ギャラリー内のキーボード ナビゲーション順には考慮されません。 ギャラリー内の TabIndex コントロールがスコープされます。 詳細については、アクセシビリティのプロパティ を参照してください。

関連項目

DelayItemLoading と 読み込みスピナーを使用して、ギャラリーのパフォーマンスを向上させる

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。