PowerApps의 등급 컨트롤Rating control in PowerApps

사용자가 1과 사용자가 지정하는 최대 숫자 사이의 값을 나타낼 수 있는 컨트롤입니다.A control with which users can indicate a value between 1 and a maximum number that you specify.

설명Description

이 컨트롤에서 사용자는 몇 개의 별을 선택하여 좋아하는 정도 등을 나타낼 수 있습니다.In this control, the user can indicate, for example, how much they liked something by selecting a certain number of stars.

주요 속성Key properties

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

Max – 사용자가 슬라이더 또는 등급을 설정할 수 있는 최대값입니다.Max – The maximum value to which the user can set a slider or a rating.

추가 속성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).

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.

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

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

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

RatingFill – 등급 컨트롤에서 별의 색입니다.RatingFill – The color of the stars in a rating control.

ReadOnly – 사용자가 슬라이더 또는 등급 컨트롤을 변경할 수 있는지 여부를 선택합니다.ReadOnly – Whether a user can change the value of a slider or rating control.

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

ShowValue – 사용자가 해당 값을 변경하거나 마우스로 컨트롤을 가리킬 때 슬라이더 또는 등급의 값을 표시하는지 여부입니다.ShowValue – Whether a slider's or rating's value appears as the user changes that value or hovers over the control.

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

Tooltip – 사용자가 마우스로 컨트롤을 가리킬 때 표시되는 설명 텍스트입니다.Tooltip – Explanatory text that appears when the user hovers over a 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).

평균(Value1, Value2, ... )Average( Value1, Value2, ... )

Example

  1. 등급 컨트롤을 추가하고 Quantitative로 이름을 지정합니다.Add a Rating control, and name it Quantitative.

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

  2. 텍스트 입력 컨트롤을 추가하고 Qualitative로 이름을 지정한 후 등급 컨트롤 아래로 이동합니다.Add a Text input control, name it Qualitative, and move it below the Rating control.

  3. 텍스트 입력기본값 속성을 "" 로 설정하고 다음 수식에 HintText를 설정합니다.Set the Default property of the Text input control to "", and set its HintText to this formula:
    If(Quantitative.Value > 3, "특별히 무엇을 하는 것이 좋았나요?", "개선하려면 어떻게 하나요?")If(Quantitative.Value > 3, "What did you especially like?", "How might we do better?")

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

  4. F5 키를 누르거나 등급 컨트롤에서 4개 또는 5개의 별을 클릭하거나 탭합니다.Press F5, and then click or tap either four or five stars in the Rating control.

    텍스트 입력 컨트롤의 힌트 텍스트가 변경되어 높은 등급을 반영합니다.The hint text in the Text input control changes to reflect the high rating.

  5. Quantitative에서 4개 미만의 별을 클릭하거나 탭합니다.Click or tap fewer than four stars in Quantitative.

    텍스트 입력 컨트롤의 힌트 텍스트가 변경되어 낮은 등급을 반영합니다.The hint text in the Text input control changes to reflect the low rating.

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

접근성 지침Accessibility guidelines

색 대비Color contrast

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

  • RatingFillFillRatingFill and Fill

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

화면 판독기 지원Screen reader support

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

    참고

    화면 읽기 프로그램은 등급 컨트롤을 라디오 단추로 처리합니다.Screen readers treat the Rating control as radio buttons.

키보드 지원Keyboard support

  • 키보드 사용자가 탐색할 수 있도록 TabIndex 가 0 이상이어야 합니다.TabIndex must be zero or greater so that keyboard users can navigate to it.

  • 포커스 표시기가 명확하게 표시되어야 합니다.Focus indicators must be clearly visible. FocusedBorderColorFocusedBorderThickness 를 사용하여 이를 달성합니다.Use FocusedBorderColor and FocusedBorderThickness to achieve this.

  • 별이 너무 많은 경우에는 다른 컨트롤을 사용하는 것이 좋습니다.Consider using a different control if there are too many stars. 키보드로 탐색하는 것은 지루하고 터치 스크린으로 정확하게 선택하는 것은 어려울 수 있습니다.It can be tedious to navigate with a keyboard and difficult to select accurately with a touch screen.

    참고

    등급에서 라디오 단추에 대해 동일한 키보드 조작을 사용할 수 있습니다.The same keyboard interactions for radio buttons can be used on Rating.