Power Apps でのカード コントロール

Display form または Edit form コントロールの単一フィールドに対する表示および編集エクスペリエンスを提供します。

内容

Display form および Edit form コントロールは、レコード全体を表示するためのコンテナーとして機能します。 各コンテナーでは一連の カード コントロールを保持し、個々のフィールドを表示したり、これらのフィールドを更新する方法を提供したりできます。 各カードには、動作するレコードのフィールドを指定する DataField プロパティがあります。

事前定義されたカードは、さまざまなデータ タイプやユーザー エクスペリエンスに対して定義されます。 たとえば、キーボードで使用しやすい、Text input コントロールで数値フィールドを編集するカードが存在する場合があります。 別のカードは、代わりに Slider コントロールを使用した数値の編集をサポートしている可能性があります。 選択されたフォーム コントロールにより、右側のウィンドウで、フィールドに基づいて容易にカードを選択できます。

カード自体には、コントロールが含まれます。 カードのコントロールが、単一のフィールドを表示したり編集したりするエクスペリエンスを構成します。 たとえば、数値カードは、フィールドの表示名を提供する Label コントロールと、フィールドの値に対してエディターを提供する Text input コントロールで構成されている可能性があります。 このカードにはまた、発生する任意の検証エラーを表示する Label コントロールや、フィールドが必要であることを示す一般的なアスタリスクのための Label コントロールも含まれている可能性があります。

事前定義されたカードのコントロールは、サイズ変更、移動、非表示化、コントロールの追加や他の変更を加えることによりカスタマイズできます。 また、最初からコントロールを追加する、完全に空白カードである "ユーザー定義カード" から始めることもできます。

事前定義されたカードは、既定では ロック済み になっています。 ロック済みカードでは、カードまたはカード内のコントロールの特定のプロパティしか変更できず、またロック済みカードを削除することはできません。 詳細 ビューの 表示 タブで、カード ロックの表示およびロック解除ができます。 プロパティがロックされていて変更できない場合は、その名前の横にロック アイコンが表示されます。 カードのロック解除は高度な操作であり、ロックを解除するとカードの自動数式生成が実行されず、カードを再びロックすることもできないため、くれぐれも慎重に行うようにしてください。

フォームのコンテナー内では ThisItem レコードが使用可能であり、そこにはレコードのすべてのフィールドが含まれます。 たとえば、カードの 既定 プロパティは多くの場合、ThisItem.FieldName に設定されています。

参照を使用して、カードのプロパティを参照するためのコントロールを構成できます。 たとえば、コントロールは Parent.Default を使用して、データ ソースからフィールドの初期状態を読み取る必要があります。 必要な情報に直接アクセスする代わりに を使用することにより、カードのカプセル化が向上し、内部の数式を壊すことなくそれを別のフィールドに変更できます。

カードをカスタマイズしたり、ロック解除したり、作成したりする方法の例については、「データ カードについて」を参照してください。

主要なプロパティ

DataField – このカードが表示および編集するレコード内のフィールドの名前。

  • 数式ではなく、二重引用符で囲まれた単一の静的な文字列 (たとえば、"名前") として名前を指定します。
  • その DataField プロパティを 空白 に設定することにより、カードをアンバインドします。 バインドされていないカードの 有効 および 更新 プロパティは無視されます。

Default – ユーザーが変更する前のコントロールの初期値です。

  • カード内のコントロールごとに、このプロパティを Parent.Default に設定して、データ ソースに応じてフィールドの既定値を参照します。 たとえば、ユーザーがそのスライダーの一般的な汎用値で始めるようにするには、スライダーの 既定 プロパティを Parent.Default に設定します。

DisplayMode – 値は Edit、ViewDisabled のいずれかになります。 カード内のコントロールがユーザー入力を許可するか (編集)、データのみを表示するか (表示)、無効にするか (無効) を構成します。

  • 既定ではフォームの動作に関連するこのプロパティを構成することにより、編集フォームと表示フォームの両方で単一のカードを使用できます。
  • 表示 モードでは、Text inputDrop downDate Picker などの子コントロールでテキスト値のみが表示され、対話型要素や装飾は表示されません。

DisplayName – データ ソース内のフィールドのユーザー フレンドリ名。

  • DataSourceInfo 関数では、データ ソースからこのメタデータを提供します。
  • カード内のコントロールは、Parent.DisplayName を使用してフィールドの名前を参照する必要があります。

エラー – 検証が失敗した場合にこのフィールドに表示するユーザー フレンドリなエラー メッセージ。

  • このプロパティは、SubmitForm が呼び出されるときに設定されます。
  • このメッセージは、データ ソースのメタデータに基づく検証問題および、カードの 必須 プロパティの確認について説明します。

必須 – データ ソースのフィールドの編集時に、カードに値が含まれる必要があるかどうか。

  • DataSourceInfo 関数は、データ ソースからの必要なメタデータを提供します。
  • カード内のコントロールは、Parent.Required を使用して、そのカードのフィールドが必要かどうかを判定する必要があります。

更新 – フィールドのデータ ソースに書き戻す値。

  • データ ソースに書き戻すためにカードの編集コントロールから値をプルするには、このプロパティの数式を使用します。 たとえば、そのカード内のスライダーからの値でデータ ソースを更新するには、カードの 更新 プロパティを Slider.Value に設定します。

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

WidthFitEdit form コントロールなどのコンテナー コントロールで、コントロールを水平方向に自動的に拡大して空の領域を埋めるかどうか。 複数のカードでこのプロパティが true に設定されている場合、領域はカード間で分割されます。 詳細については、データ フォームのレイアウトについて を参照してください。

追加のプロパティ

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

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

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

塗りつぶし – コントロールの背景色。

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

有効カード または Edit form コントロールに、データ ソースに送信する準備ができた有効なエントリが含まれているかどうか。

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

X – コントロールの左端とその親コンテナー (親コンテナーがない場合は画面) の左端間の距離。 複数の列を持つコンテナーの Card コントロールの場合、このプロパティは、カードが表示される列を決定します。

Y – コントロールの上端とその親コンテナー (親コンテナーがない場合は画面) の上端間の距離。 複数の行を持つコンテナーの Card コントロールの場合、このプロパティは、カードが表示される行を決定します。

例については、「データ カードについて」および「データ フォームのレイアウトについて」を参照してください。

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

色のコントラスト

次の間には適切な色のコントラストが必要です:

  • 塗りつぶし および任意の子コントロール。 たとえば、カードに Label が含まれ、ラベルの塗りつぶしが透明な場合、カードの Fill は実質的にはラベルの背景色になります。 そのため、カードの 塗りつぶし およびラベルの との間には適切なコントラストが必要です。

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

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