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

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

内容

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

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

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

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

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

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

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

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

主要なプロパティ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

追加のプロパティ

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

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

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

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

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

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

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

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

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

例

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

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

色のコントラスト

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

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

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

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