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 – コントロールの上端とその親コンテナー (親コンテナーがない場合は画面) の上端間の距離。
関連する関数
例
トグルを追加し、名前を MemberDiscount にします。
コントロールの追加、名前付け、構成 についてはこちらをご覧ください。
ラベルを追加し、その Text プロパティを次の数式に設定します。
If(MemberDiscount.Value = true, "Price: $75", "Price: $100")F5 キーを押し、MemberDiscount の値を変更します。
MemberDiscount がオンかオフかに応じて、ラベルに異なる価格が表示されます。
既定のワークスペースに戻るには、Esc キーを押します。
アクセシビリティ ガイドライン
色のコントラスト
次の間には適切な色のコントラストが必要です:
- HandleFill および FalseFill
- HandleFill および FalseHoverFill
- HandleFill および TrueFill
- HandleFill および TrueHoverFill
- FalseFill およびコントロールの外側の色
- FalseHoverFill およびコントロールの外側の色
- TrueFill およびコントロールの外側の色
- TrueHoverFill およびコントロールの外側の色
これは、標準の色のコントラスト要件 に追加されるものです。
スクリーン リーダー サポート
- AccessibleLabel が存在する必要があります。
- FalseText を指定する必要があります。
- TrueText を指定する必要があります。
弱視のサポート
- ユーザーがトグル値をすばやく判断できるように、ShowLabel を true に設定することを検討してください。
キーボードのサポート
- TabIndex を 0 以上にして、キーボード ユーザーがそこに移動できるようにする必要があります。
- フォーカス インジケーターは明確に表示する必要があります。 これを実現するには FocusedBorderColor および FocusedBorderThickness を使用します。
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。