PowerApps의 라디오 컨트롤Radio control in PowerApps

사용자가 한 번에 하나만을 선택할 수 있는 여러 옵션을 보여주는 입력 컨트롤입니다.An input control that shows multiple options, of which users can select only one at a time.

설명Description

표준 HTML 입력 컨트롤인 Radio 컨트롤은 몇 가지 상호 배타적인 옵션과 함께 사용되는 것이 가장 적합합니다.A Radio control, a standard HTML input control, is best used with only a few, mutually exclusive options.

컨트롤에는 가로 또는 세로 레이아웃이 있을 수 있습니다.The control can have a horizontal or vertical layout.

주요 속성Key properties

**Default ** – 사용자가 변경하기 전의 컨트롤의 값입니다.Default – The value of a control before the user changes it.

Items – 갤러리, 목록 또는 차트와 같은 컨트롤에 표시되는 데이터 원본입니다.Items – The source of data that appears in a control such as a gallery, a list, or a chart.

Layout – 가로 또는 세로로 레이아웃되는지 옵션입니다.Layout – Whether the options are laid out vertically or horizontally.

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

선택한 – 선택한 항목을 나타내는 데이터 레코드입니다.Selected – The data record that represents the selected item.

모든 속성All properties

Align - 컨트롤의 가로 가운데를 기준으로 한 텍스트의 위치입니다.Align – The location of text in relation to the horizontal center of its control.

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.

Color – 컨트롤의 텍스트 색입니다.Color – The color of text in a control.

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.

DisabledColor – 컨트롤의 DisplayMode 속성이 Disabled로 설정된 경우 컨트롤의 텍스트 색입니다.DisabledColor – The color of text in a control if its DisplayMode property is set to Disabled.

DisabledFill – 컨트롤의 DisplayMode 속성이 Disabled로 설정된 경우 컨트롤의 배경색입니다.DisabledFill – The background color of a control if its DisplayMode property is set to 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.

Font – 텍스트가 표시되는 글꼴의 제품군 이름입니다.Font – The name of the family of fonts in which text appears.

**FontWeight ** – 컨트롤의 텍스트의 가중치: 굵게, Semibold, 정상, 또는 밝은.FontWeight – The weight of the text in a control: Bold, Semibold, Normal, or Lighter.

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

HoverColor – 사용자가 해당 컨트롤에 마우스 포인터를 올려두는 경우 컨트롤의 텍스트 색입니다.HoverColor – The color of the text in a control when the user keeps the mouse pointer on it.

HoverFill – 사용자가 해당 컨트롤에 마우스 포인터를 올려두는 경우 컨트롤의 배경색입니다.HoverFill – The background color of a control when the user keeps the mouse pointer on it.

Italic - 컨트롤의 텍스트를 기울임꼴로 설정할지 여부를 선택합니다.Italic – Whether the text in a control is italic.

LineHeight - 예를 들어 텍스트 선 또는 목록의 항목 사이의 거리입니다.LineHeight – The distance between, for example, lines of text or items in a list.

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.

PaddingBottom – 컨트롤의 텍스트와 해당 컨트롤의 아래쪽 가장자리 사이의 거리입니다.PaddingBottom – The distance between text in a control and the bottom edge of that control.

PaddingLeft – 컨트롤의 텍스트와 해당 컨트롤의 왼쪽 가장자리 사이의 거리입니다.PaddingLeft – The distance between text in a control and the left edge of that control.

PaddingRight – 컨트롤의 텍스트와 해당 컨트롤의 오른쪽 가장자리 사이의 거리입니다.PaddingRight – The distance between text in a control and the right edge of that control.

PaddingTop – 컨트롤의 텍스트와 해당 컨트롤의 위쪽 가장자리 사이의 거리입니다.PaddingTop – The distance between text in a control and the top edge of that control.

PressedColor – 사용자가 컨트롤을 탭하거나 클릭하는 경우 컨트롤의 텍스트 색입니다.PressedColor – The color of text in a control when the user taps or clicks that control.

PressedFill – 사용자가 컨트롤을 탭하거나 클릭하는 경우 컨트롤의 배경색입니다.PressedFill – The background color of a control when the user taps or clicks that control.

RadioBackgroundFill – 라디오 단추 컨트롤에서 원의 배경색입니다.RadioBackgroundFill – The background color of the circles in a radio-button control.

RadioBorderColor - 라디오 단추 컨트롤에서 각 옵션의 원 색입니다.RadioBorderColor – The color of the circle for each option in a radio-button control.

RadioSelectionFill – 라디오 단추 컨트롤에서 선택된 원 안에 표시되는 색입니다.RadioSelectionFill – The color that appears inside the circle of the selected option in a radio-button control.

RadioSize – 라디오 단추 컨트롤에서 원의 직경입니다.RadioSize – The diameter of the circles in a radio-button control.

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

(사용 되지 않음) SelectedText – 선택한 항목을 나타내는 하는 문자열 값입니다.SelectedText (Deprecated) – A string value that represents the selected item.

Size -컨트롤에 표시되는 텍스트의 글꼴 크기입니다.Size – The font size of the text that appears on a control.

Strikethrough - 컨트롤에 표시되는 텍스트 중앙에 선을 표시할지 여부를 선택합니다.Strikethrough – Whether a line appears through the text that appears on a control.

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

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

Underline – 컨트롤에 표시되는 텍스트 아래에 선을 표시할지 여부를 선택합니다.Underline – Whether a line appears under the text that appears on 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).

Distinct( DataSource, ColumnName )Distinct( DataSource, ColumnName )

Example

  1. 라디오 컨트롤을 추가하고 이름을 Pricing으로 지정한 후, Items 속성을 다음 수식으로 설정합니다.Add a Radio control, name it Pricing, and set its Items property to this formula:

    ["Standard", "Premium"]["Standard", "Premium"]

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

  2. 레이블 컨트롤을 추가하고 라디오 컨트롤 아래로 이동한 후, 레이블 컨트롤의 Text 속성을 다음 수식으로 설정합니다.Add a Label control, move it below the Radio control, and set the Text property of the Label control to this formula:

    If("Premium" in Pricing.Selected.Value, "$200 per day", "$150 per day")If("Premium" in Pricing.Selected.Value, "$200 per day", "$150 per day")

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

  3. Alt 키를 누른 채로 Radio 컨트롤에서 옵션 중 하나를 선택합니다.While holding down the Alt key, select either option in the Radio control.

    레이블 컨트롤이 선택에 적합한 텍스트를 표시합니다.The Label control shows the appropriate text for your choice.

  4. (선택 사항) Alt 키를 누른 채로 다른 옵션을 선택하여 적합한 텍스트가 표시되는지 확인합니다.(optional) While holding down the Alt key, select the other option to confirm that the appropriate text appears.

접근성 지침Accessibility guidelines

색 대비Color contrast

표준 색 대비 요구 사항 외에도 다음 사이에 적절한 색 대비를 확인합니다.In addition to the standard color contrast requirements, ensure adequate color contrast between:

  • RadioSelectionFillRadioBackgroundFillRadioSelectionFill and RadioBackgroundFill
  • RadioBackgroundFillFillRadioBackgroundFill and Fill

화면 reader 지원Screen-reader support

  • 모든 옵션에 이 있는지 확인합니다.Ensure that every option has a Value.
  • 제목으로 사용할 라디오 컨트롤 바로 앞에 레이블 을 추가하는 것이 좋습니다.Consider adding a Label immediately before the Radio control to serve as the heading.

키보드 지원Keyboard support