PowerApps의 토글 컨트롤Toggle control in PowerApps

핸들을 움직여 사용자가 켜거나 끌 수 있는 컨트롤입니다.A control that the user can turn on or off by moving its handle.

설명Description

토글은 최근 GUI용으로 설계되었으나 확인란과 동일한 방식으로 작동합니다.A toggle is designed for recent GUIs but behaves the same way as a check box.

주요 속성Key properties

Default – 사용자가 컨트롤을 변경하기 전의 초기 값입니다.Default – The initial value of a control before it is changed by the user.

Value – 입력 컨트롤의 값입니다.Value – The value of an input control.

추가 속성Additional properties

AccessibleLabel – 화면 읽기 프로그램의 레이블입니다.AccessibleLabel – Label for screen readers.

BorderColor - 컨트롤의 테두리 색입니다.BorderColor – The color of a control's border.

BorderStyle - 컨트롤의 테두리는 Solid, Dashed, Dotted, None입니다.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness - 컨트롤의 테두리 굵기입니다.BorderThickness – The thickness of a control's border.

DisplayMode – 컨트롤이 사용자 입력을 허용(편집)하거나, 데이터만 표시(보기)하거나 사용 안 하도록(사용 안 함) 설정할지 선택합니다.DisplayMode – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

DisabledBorderColor – 컨트롤의 DisplayMode 속성이 Disabled로 설정된 경우 컨트롤의 테두리 색입니다.DisabledBorderColor – The color of a control's border if the control's DisplayMode property is set to Disabled.

FalseFill – 토글이 꺼진 경우 토글 채우기 색입니다.FalseFill – The toggle fill color when the toggle is off.

FalseHoverFill – 토글이 꺼진 경우 가리킨 항목의 채우기 색입니다.FalseHoverFill – The toggle hover fill color when toggle is off.

FalseText – 토글이 꺼진 경우 표시되는 텍스트입니다.FalseText – The text shown when the toggle is off.

Fill - 컨트롤의 배경색입니다.Fill – The background color of a control.

FocusedBorderColor – 컨트롤에 포커스가 있을 때 컨트롤의 테두리 색입니다.FocusedBorderColor – The color of a control's border when the control is focused.

FocusedBorderThickness – 컨트롤에 포커스가 있을 때 컨트롤의 테두리 두께입니다.FocusedBorderThickness – The thickness of a control's border when the control is focused.

HandleFill - 토글 핸들의 채우기 색입니다.HandleFill – The fill color of the toggle handle.

Height – 컨트롤의 위쪽 및 아래쪽 가장자리 사이의 간격입니다.Height – The distance between a control's top and bottom edges.

HoverBorderColor – 사용자가 해당 컨트롤에 마우스 포인터를 올려두는 경우 컨트롤의 테두리 색입니다.HoverBorderColor – The color of a control's border when the user keeps the mouse pointer on that control.

OnChange – 사용자가 컨트롤의 값을 변경할 때(예: 슬라이더 조절) 앱이 응답하는 방식입니다.OnChange – How the app responds when the user changes the value of a control (for example, by adjusting a slider).

OnCheck - 확인란의 값이나 토글이 true로 변경되었을 때 앱이 응답하는 방식입니다.OnCheck – How an app responds when the value of a checkbox or a toggle changes to true.

OnSelect – 사용자가 앱을 클릭하거나 탭할 때 앱이 응답하는 방법입니다.OnSelect – How the app responds when the user taps or clicks a control.

OnUncheck - 확인란의 값이나 토글이 false로 변경되었을 때 앱이 응답하는 방식입니다.OnUncheck – How an app responds when the value of a checkbox or a toggle changes to false.

PressedBorderColor – 사용자가 컨트롤을 탭하거나 클릭하는 경우 컨트롤의 테두리 색입니다.PressedBorderColor – The color of a control's border when the user taps or clicks that control.

RailFill – 토글 컨트롤의 값이 false일 때 해당 컨트롤의 사각형 배경색이거나 슬라이더 컨트롤에 있는 핸들 오른쪽의 선 색입니다.RailFill – The background color of the rectangle in a toggle control when its value is false or the color of the line to the right of the handle in a slider control.

RailHoverFill – 토글 컨트롤 또는 슬라이더에 마우스를 가져가는 경우, 토글 컨트롤의 값이 false일 때 해당 컨트롤의 사각형 배경색이거나 슬라이더 컨트롤에 있는 핸들 오른쪽의 선 색입니다.RailHoverFill – When you hover on a toggle control or a slider, the background color of the rectangle in a toggle control when its value is false or the color of the line to the right of the handle in a slider control.

Reset – 컨트롤이 기본값으로 되돌아가는지 여부입니다.Reset – Whether a control reverts to its default value.

ShowLabel – 토글 컨트롤 옆에 텍스트 레이블을 표시할지 여부입니다.ShowLabel – Whether a text label is shown beside the toggle control.

TabIndex – 다른 컨트롤에 관련된 키보드 탐색 순서입니다.TabIndex – Keyboard navigation order in relation to other controls.

TextPosition – 레이블을 토클 컨트롤의 왼쪽에 둘지 또는 오른쪽에 둘지 여부입니다.TextPosition – Whether the label is to the left or the right of the toggle control.

Tooltip – 사용자가 마우스로 컨트롤을 가리킬 때 표시되는 설명 텍스트입니다.Tooltip – Explanatory text that appears when the user hovers over a control.

TrueFill – 토글 켜진 경우 토글 채우기 색입니다.TrueFill – Toggle fill color when the toggle is on.

TrueHoverFill – 토글이 켜진 경우 가리킨 항목의 채우기 색입니다.TrueHoverFill – Toggle hover fill color when the toggle is on.

TrueText – 토글이 켜진 경우 표시되는 텍스트입니다.TrueText – Text shown when the toggle is on.

ValueFill – 토글 컨트롤의 값이 true일 때 해당 컨트롤의 사각형 배경색이거나 슬라이더 컨트롤에 있는 핸들 왼쪽의 선 색입니다.ValueFill – The background color of the rectangle in a toggle control when its value is true or the color of the line to the left of the handle in a slider control.

ValueHoverFill – 토글 컨트롤 또는 슬라이더 위에 마우스 포인터를 두고 있는 경우, 토글 컨트롤의 값이 true일 때 해당 컨트롤의 사각형 배경색이거나 슬라이더 컨트롤에 있는 핸들 왼쪽의 선 색입니다.ValueHoverFill – When you keep the mouse pointer on a toggle control or a slider, the background color of the rectangle in a toggle control when its value is true or the color of the line to the left of the handle in a slider control.

Visible – 컨트롤을 표시하거나 숨길지 여부를 선택합니다.Visible – Whether a control appears or is hidden.

Width – 컨트롤의 왼쪽 및 오른쪽 가장자리 사이의 간격입니다.Width – The distance between a control's left and right edges.

X – 컨트롤의 왼쪽 가장자리와 해당 부모 컨테이너(부모 컨테이너가 없는 경우 화면)의 왼쪽 가장자리 사이의 거리입니다.X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

Y – 컨트롤의 위쪽 가장자리와 해당 부모 컨테이너(부모 컨테이너가 없는 경우 화면)의 위쪽 가장자리 사이의 거리입니다.Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).

If( Condition, Result )If( Condition, Result )

Example

  1. 토글을 추가하고 이름을MemberDiscount로 지정합니다.Add a toggle, and name it MemberDiscount.

    컨트롤을 추가, 이름을 지정하고, 구성하는 방법을 모르시나요?Don't know how to add, name, and configure a control?

  2. 레이블을 추가하고 Text 속성을 다음 수식으로 설정합니다.Add a label, and set its Text property to this formula:
    If(MemberDiscount.Value = true, "Price: $75", "Price: $100")If(MemberDiscount.Value = true, "Price: $75", "Price: $100")

    If 함수 또는 다른 함수에 대해 더 알고 싶으신가요?Want more information about the If function or other functions?

  3. F5 키를 누르고 MemberDiscount의 값을 변경합니다.Press F5, and change the value of MemberDiscount.

    레이블에 MemberDiscount의 설정 여부에 따라 다른 가격이 표시됩니다.The label shows a different price, depending on whether MemberDiscount is on or off.

  4. 기본 작업 영역으로 돌아가려면 Esc 키를 누릅니다.To return to the default workspace, press Esc.

접근성 지침Accessibility guidelines

색 대비Color contrast

다음 사이에 적절한 색 대비가 있어야 합니다.There must be adequate color contrast between:

  • HandleFillFalseFillHandleFill and FalseFill
  • HandleFillFalseHoverFillHandleFill and FalseHoverFill
  • HandleFillTrueFillHandleFill and TrueFill
  • HandleFillTrueHoverFillHandleFill and TrueHoverFill
  • FalseFill 및 컨트롤 외부 색FalseFill and color outside the control
  • FalseHoverFill 및 컨트롤 외부 색FalseHoverFill and color outside the control
  • TrueFill 및 컨트롤 외부 색TrueFill and color outside the control
  • TrueHoverFill 및 컨트롤 외부 색TrueHoverFill and color outside the control

이는 표준 색 대비 요구 사항에 추가됩니다.This is in addition to the standard color contrast requirements.

화면 판독기 지원Screen reader support

  • AccessibleLabel 이 있어야 합니다.AccessibleLabel must be present.
  • FalseText가 있어야 합니다.FalseText must be present.
  • TrueText가 있어야 합니다.TrueText must be present.

저시력 사용자 지원Low vision support

  • 사용자가 토글 값을 빠르게 확인할 수 있도록 ShowLabeltrue로 설정하는 것이 좋습니다.Consider setting ShowLabel to true so that users can quickly determine the toggle value.

키보드 지원Keyboard support