PowerApps의 카드 컨트롤Card control in PowerApps

표시 양식 또는 편집 양식 컨트롤의 단일 필드에 대한 표시 및 편집 경험을 제공합니다.Provides the display and editing experience for a single field of a Display form or Edit form control.

설명Description

표시 양식편집 양식 컨트롤은 레코드 전체를 표시하고 볼 수 있는 컨테이너의 역할을 합니다.Display form and Edit form controls act as containers for displaying and viewing entire records. 각 컨테이너는 개별 필드를 표시하거나 이러한 필드를 업데이트할 방법을 제공하는 카드 컨트롤 집합을 포함할 수 있습니다.Each container can hold a set of Card controls that display individual fields or provide a way to update those fields. 각 카드에는 작동하는 레코드의 필드를 지정하는 DataField 속성이 있습니다.Each card has a DataField property that specifies which field of the record it works on.

미리 정의된 카드는 다양한 데이터 형식과 사용자 경험에 대해 정의됩니다.Predefined cards are defined for different data types and user experiences. 예를 들어, 키보드와 함께 사용하기 좋은 텍스트 입력 컨트롤로 숫자 필드를 편집하기 위한 카드가 있을 수 있으며,For example, there may be a card to edit a number field with a Text input control, which is great for use with the keyboard. 슬라이더 컨트롤을 사용하여 숫자 편집을 지원하는 카드가 있을 수도 있습니다.Another card might support editing a number by using a Slider control instead. 양식 컨트롤을 선택하면 오른쪽 창에서 필드에 따라 카드를 쉽게 선택할 수 있습니다.With the form control selected, you can, in the right-hand pane, easily select a card based on a field.

카드 자체에 컨트롤이 있습니다.Cards themselves contain controls. 카드의 컨트롤은 단일 필드를 표시하고 편집하기 위한 경험을 구성합니다.The controls of a card make up the experience for displaying and editing a single field. 예를 들어, 숫자 카드는 필드의 표시 이름을 제공하는 레이블 컨트롤, 필드의 값에 편집기를 제공하는 텍스트 입력 컨트롤로 구성될 수 있습니다.For example, a number card may consist of a Label control to provide the display name of the field and a Text input control to provide an editor for the value of the field. 또한, 카드에는 발생하는 유효성 검증 오류를 보여주는 레이블 컨트롤, 필드가 필수 항목임을 나타내기 위한 일반 별표에 대한 레이블 컨트롤이 있을 수 있습니다.The card may also have a Label control that shows any validation errors that occur and a Label control for the common asterisk to indicate that a field is required.

크기를 조정하고 숨기고 컨트롤을 추가하고 다른 변경 사항을 적용하여 미리 정의된 카드의 컨트롤을 사용자 지정할 수 있습니다.You can customize the controls of a predefined card by resizing it, moving it, hiding it, adding controls to it, and making other changes. 또한, 처음부터 컨트롤을 추가하도록 완전히 비어 있는 카드, "사용자 지정 카드"로 시작할 수도 있습니다.You can also start with an entirely blank card, a "custom card", to which you add controls from scratch.

미리 정의된 카드는 기본적으로 잠겨 있습니다.Predefined cards are locked by default. 잠긴 카드에서는 카드의 일부 속성 또는 카드 내부의 컨트롤만 수정할 수 있으며 잠긴 카드는 삭제할 수 없습니다.In a locked card, you can modify only certain properties of the card or the controls within the card, and you can't delete a locked card. 고급 보기의 보기 탭에서 카드 잠금 및 잠금 해제를 볼 수 있습니다.You can show the card lock and unlock it on the View tab of the Advanced view. 속성이 잠겨 있고 수정할 수 없는 경우 해당 이름 옆에 자물쇠 아이콘이 나타납니다.If a property is locked and can't be modified, it appears with a lock icon next to its name. 해당 카드에 대해 자동 수식이 더 이상 생성되지 않으므로, 카드 잠금 해제는 주의하여 수행해야 하는 고급 작업이며 카드를 다시 잠글 수 없습니다.Unlocking a card is an advanced activity and should be done with care, because automatic formula generation will no longer occur for the card, and you can't relock a card.

양식의 컨테이너 내부에서 ThisItem 레코드가 사용 가능하며 해당 레코드의 모든 필드를 포함합니다.Within the form's container, the ThisItem record is available and contains all the fields of the record. 예를 들어, 카드의 Default 속성은 ThisItem.FieldName으로 설정되는 경우가 많습니다.For example, the card's Default property is often set to ThisItem.FieldName.

부모 참조를 사용하여 카드의 속성을 참조하도록 컨트롤을 구성할 수 있습니다.You can use the Parent reference to configure a control to reference the properties of a card. 예를 들어, 컨트롤은 Parent.Default를 사용하여 데이터 원본에서 필드의 초기 상태를 읽어야 합니다.For example, a control should use Parent.Default to read the initial state of the field from the data source. 원하는 정보에 직접 액세스하는 대신 부모를 사용하면 카드의 암호화가 개선되며, 내부 서식을 깨지 않고도 다른 필드로 바꿀 수 있습니다.By using Parent instead of directly accessing the information that you want, the card is better encapsulated, and you can change it to a different field without breaking internal formulas.

카드를 사용자 지정, 잠금 해제 및 만드는 방법에 대한 예는 데이터 카드 이해를 참조하세요.See Understand data cards for examples of how to customize, unlock, and create cards.

주요 속성Key properties

DataField - 이 카드가 표시하고 편집하는 레코드 내부의 필드 이름입니다.DataField – The name of the field within a record that this card displays and edits.

  • 이름을 수식이 아닌 큰따옴표로 묶은 단일 정적 문자열로 지정합니다(예: "Name").Specify the name as a single static string that's enclosed in double quotation marks (for example, "Name"), not a formula.
  • DataField 속성을 blank로 설정하여 카드의 바인딩을 해제합니다.Unbind a card by setting its DataField property blank. ValidUpdate 속성은 바인딩 해제된 카드에는 무시됩니다.The Valid and Update properties are ignored for unbound cards.

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

  • 카드의 각 컨트롤은 데이터 원본에 따라 필드의 기본값을 참조하도록 이 속성을 Parent.Default로 설정하세요.For each control in a card, set this property to Parent.Default to refer to the default value of the field according to the data source. 예를 들어, 사용자가 해당 슬라이더에 대한 일반 값으로 시작할 수 있도록 슬라이더의 Default 속성을 Parent.Default로 설정합니다.For example, set a slider's Default property to Parent.Default to ensure that the user starts with a generic value for that slider.

DisplayMode – 값은 Edit, View, 또는 Disabled가 될 수 있습니다.DisplayMode – Values can be Edit, View, or Disabled. 카드 내부의 컨트롤이 사용자 입력을 허용(편집)하거나, 데이터만 표시(보기)하거나 사용 안 하도록(사용 안 함) 설정할지 구성합니다.Configures whether the control inside the card allows user input (Edit), only displays data (View) or is disabled (Disabled).

  • 단일 카드를 기본적으로 양식의 동작에 연결되어 있는 이 속성을 구성하여 편집 및 보기 양식 모두에 사용할 수 있도록 허용합니다.Allows a single card to be used in both edit and view forms, by configuring this property, which is tied to the Form's behavior by default.
  • 보기 모드에서 텍스트 입력, 드롭다운, 날짜 선택기 등의 자식 컨트롤은 텍스트 값만 표시하고 다른 대화형 요소 또는 장식을 렌더링하지 않습니다.In View mode, child controls such as Text input, Drop down, Date Picker will only display the text value and will not render any interactive elements or decorations.

DisplayName – 데이터 원본의 필드에 대한 사용자에게 친숙한 이름입니다.DisplayName – The user friendly name for a field in a data source.

  • DataSourceInfo 함수는 데이터 원본에서 이 메타데이터를 제공합니다.The DataSourceInfo function provides this metadata from the data source.
  • 카드 내부의 컨트롤은 필드의 이름을 참조하도록 Parent.DisplayName을 사용해야 합니다.Controls within the card should use Parent.DisplayName to refer to the name of the field.

Error - 유효성 검사가 실패할 때 이 필드에 표시할 사용자에게 친숙한 오류 메시지입니다.Error – The user friendly error message to display for this field when validation fails.

  • 이 속성은 SubmitForm이 호출되면 설정됩니다.This property is set when SubmitForm is called.
  • 메시지는 데이터 원본의 메타데이터에 따라 유효성 검사 문제를 설명하고 카드의 Required 속성을 확인합니다.The message describes validation problems based on the data source's metadata and checking the card's Required property.

Required – 데이터 원본의 필드를 편집하는 카드에 값을 포함해야 하는지 여부를 선택합니다.Required – Whether a card, editing the field of a data source, must contain a value.

  • DataSourceInfo 함수는 데이터 원본에서 필요한 메타데이터를 제공합니다.The DataSourceInfo function provides the required metadata from the data source.
  • 카드 내 컨트롤은 Parent.Required를 사용하여 카드의 필드가 필요한지 여부를 결정합니다.Controls within the card should use Parent.Required to determine whether that card's field is required.

Update – 필드에 대한 데이터 원본에 다시 쓸 값입니다.Update – The value to write back to the data source for a field.

  • 데이터 원본에 다시 쓰려면 이 속성의 서식을 사용하여 카드의 편집 컨트롤에서 값을 가져옵니다.Use this property's formula to pull the values from the edit controls of the card in order to write back to the data source. 예를 들어, 카드의 Update 속성을 Slider.Value로 설정하여 해당 카드에 있는 슬라이더의 값으로 데이터 원본을 업데이트합니다.For example, set a card's Update property to Slider.Value to update the data source with a value from the slider in that card.

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

WidthFit편집 양식 컨트롤처럼 컨테이너 컨트롤의 빈 공간을 채우기 위해 컨트롤의 가로가 자동으로 커지는지 여부입니다.WidthFit – Whether a control automatically grows horizontally to fill any empty space in a container control such as an Edit form control. 여러 카드에서 이 속성이 true로 설정되면 카드 사이의 공간이 분할됩니다.If multiple cards have this property set to true, the space is divided between them. 자세한 내용은 데이터 양식 레이아웃 이해를 참조하세요.For more information, see Understand data form layout.

추가 속성Additional properties

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.

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

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

Valid카드 또는 편집 양식 컨트롤에 올바른 항목이 있고 데이터 원본에 제출할 수 있는지의 여부입니다.Valid – Whether a Card or Edit form control contains valid entries, ready to be submitted to the data source.

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

X – 컨트롤의 왼쪽 가장자리와 해당 부모 컨테이너(부모 컨테이너가 없는 경우 화면)의 왼쪽 가장자리 사이의 거리입니다.X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container). 여러 열이 있는 컨테이너의 카드 컨트롤에서 이 속성은 카드가 표시되는 열을 결정합니다.For a Card control in a container that has multiple columns, this property determines the column in which the card appears.

Y – 컨트롤의 위쪽 가장자리와 해당 부모 컨테이너(부모 컨테이너가 없는 경우 화면)의 위쪽 가장자리 사이의 거리입니다.Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container). 여러 행이 있는 컨테이너의 카드 컨트롤에서 이 속성은 카드가 표시되는 행을 결정합니다.For a Card control in a container that has multiple rows, this property determines the row in which the card appears.

Examples

데이터 카드 이해데이터 양식 레이아웃 이해에서 예를 참조하세요.See Understand data cards and Understand data form layout for examples.

접근성 지침Accessibility guidelines

색 대비Color contrast

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

  • Fill 및 자식 컨트롤.Fill and any child controls. 예를 들어 카드에 레이블 이 포함되어 있고 레이블에 투명한 채우기가 있는 경우 카드의 Fill 은 효과적으로 레이블의 배경색이 됩니다.For example, if a card contains a Label and the label has transparent fill, then the card's Fill effectively becomes the background color for the label. 따라서 카드의 Fill 과 레이블의 Color 사이에 적절한 대비가 있어야 합니다.Thus, there should be adequate contrast between the card's Fill and the label's Color.

화면 판독기 지원Screen reader support

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