Power Apps の トグル コントロール

  • [アーティクル]

ユーザーがハンドルを動かすことでオンまたはオフにできるコントロールです。

内容

トグルは最近の GUI 向けのデザインですが、動作はチェック ボックスと同じです。

主要なプロパティ

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

Value – 入力コントロールの値です。

追加のプロパティ

AccessibleLabel – スクリーン リーダー用のラベル。

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

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

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

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

DisabledBorderColor – コントロールの DisplayMode プロパティが無効に設定されている場合のコントロールの境界線の色。

FalseFill – トグルが無効な場合の、トグルの塗りつぶしの色です。

FalseHoverFill – トグルが無効な場合の、トグルのポイント時の塗りつぶしの色です。

FalseText – トグルが無効な場合に表示されるテキストです。

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

FocusedBorderColor – コントロールがフォーカスされているときのコントロールの境界線の色。

FocusedBorderThickness – コントロールがフォーカスされているときのコントロールの境界線の太さ。

HandleFill – トグル ハンドルの塗りつぶしの色。

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

HoverBorderColor – ユーザーがコントロール上にマウス ポインターを重ねているときのコントロールの境界線の色。

OnChange – ユーザーが (スライダーを調整するなどして) コントロールの値を変更したときに実行するアクション。

OnCheck – チェック ボックスまたはトグルの値が true に変わったときに実行するアクション。

OnSelect – ユーザーがコントロールをタップまたはクリックしたときに実行するアクション。

OnUncheck – チェック ボックスまたはトグルの値が false に変わったときに実行するアクション。

PressedBorderColor – ユーザーがコントロールをタップまたはクリックしたときのコントロールの境界線の色。

RailFill – 値が false の場合のトグル コントロール内の四角形の背景色、またはスライダー コントロールのハンドルの右側の線の色です。

RailHoverFill – 値が false の場合に、トグル コントロールまたはスライダーをポイントしたときの、トグル コントロール内の四角形の背景色、またはスライダー コントロールのハンドルの右側の線の色です。

Reset – コントロールを既定値に戻すかどうかを指定します。

ShowLabel – テキスト ラベルをトグル コントロールの横に表示するかどうかを指定します。

TabIndex – 他のコントロールに関連するキーボード ナビゲーションの順序。

TextPosition – ラベルをトグル コントロールの右側と左側のどちらにするかを指定します。

Tooltip – ユーザーがコントロールにカーソルを置くときに表示される説明テキスト。

TrueFill – トグルが有効な場合の、トグルの塗りつぶしの色です。

TrueHoverFill – トグルが有効な場合の、トグルのポイント時の塗りつぶしの色です。

TrueText – トグルが有効な場合に表示されるテキストです。

ValueFill – 値が true の場合の、トグル コントロール内の四角形の背景色、またはスライダー コントロールのハンドルの左側の線の色です。

ValueHoverFill – 値が true の場合に、トグル コントロールまたはスライダーにポインターを合わせたときの、トグル コントロール内の四角形の背景色、またはスライダー コントロールのハンドルの左側の線の色です。

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

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

X – コントロールの左端とその親コンテナー (親コンテナーがない場合は画面) の左端間の距離。

Y – コントロールの上端とその親コンテナー (親コンテナーがない場合は画面) の上端間の距離。

If( Condition, Result )

例

  1. トグルを追加し、名前を MemberDiscount にします。

    コントロールの追加、名前付け、構成 についてはこちらをご覧ください。

  2. ラベルを追加し、その Text プロパティを次の数式に設定します。
    If(MemberDiscount.Value = true, "Price: $75", "Price: $100")

    If 関数または その他の関数 の詳細については各関連記事を参照してください。

  3. F5 キーを押し、MemberDiscount の値を変更します。

    MemberDiscount がオンかオフかに応じて、ラベルに異なる価格が表示されます。

  4. 既定のワークスペースに戻るには、Esc キーを押します。

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

色のコントラスト

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

  • HandleFill および FalseFill
  • HandleFill および FalseHoverFill
  • HandleFill および TrueFill
  • HandleFill および TrueHoverFill
  • FalseFill およびコントロールの外側の色
  • FalseHoverFill およびコントロールの外側の色
  • TrueFill およびコントロールの外側の色
  • TrueHoverFill およびコントロールの外側の色

これは、標準の色のコントラスト要件 に追加されるものです。

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

  • AccessibleLabel が存在する必要があります。
  • FalseText を指定する必要があります。
  • TrueText を指定する必要があります。

弱視のサポート

  • ユーザーがトグル値をすばやく判断できるように、ShowLabel を true に設定することを検討してください。

キーボードのサポート

  • TabIndex を 0 以上にして、キーボード ユーザーがそこに移動できるようにする必要があります。
  • フォーカス インジケーターは明確に表示する必要があります。 これを実現するには FocusedBorderColor および FocusedBorderThickness を使用します。

注意

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

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