다음을 통해 공유


카드의 컨트롤 및 속성

속성 중 하나를 설정하여 컨트롤의 모양과 동작을 구성합니다. 각 유형의 컨트롤에는 서로 다른 속성 집합이 있습니다. 높이너비와 같은 일부 속성은 거의 모든 유형의 컨트롤에 공통적이지만 OnSelect와 같은 다른 속성은 한 유형의 컨트롤에만 적용됩니다.

컨트롤

버튼 – 클릭 시 Power Fx를 실행하는 버튼 요소입니다.

버튼 세트 – 버튼 요소 세트의 컨테이너입니다.

확인란 - 사용자가 선택하거나 선택 취소하여 두 가지 옵션 중에서 선택할 수 있는 확인란입니다.

- 다른 요소의 컨테이너 역할을 하는 개별 열입니다.

열 세트 - 열 모음이며 각 열은 컨테이너입니다.

컨테이너 - 다른 요소의 모음입니다.

날짜 선택기 – 사용자가 날짜를 선택하는 필드입니다.

드롭다운 – 사용자가 확장 가능한 항목 목록에서 하나의 항목을 선택할 수 있는 메뉴입니다.

팩트 세트 – 팩트에 대한 컨테이너 요소입니다.

이미지 – 이미지 모양을 제어하는 속성이 있는 이미지입니다.

이미지 세트 – 사진 갤러리 역할을 하는 이미지 컨테이너입니다.

미디어 – URL 및 MimeType으로 지정된 비디오 또는 이미지입니다.

숫자 입력 – 사용자가 숫자를 입력하는 필드입니다.

테이블 – 테이블 형식의 데이터 또는 행과 열에 가장 잘 배치된 구조화된 정보를 표시합니다.

텍스트 입력 – 사용자가 텍스트를 입력하는 필드입니다.

텍스트 레이블 – 텍스트의 모양을 제어하는 속성이 있는 텍스트 블록입니다.

시간 선택기 – 사용자가 시간을 선택하는 필드입니다.

모든 속성

A

대체 텍스트 - 이미지, 오디오 또는 비디오를 설명하는 대체 텍스트입니다.

연결된 입력 - 작업과 연결된 입력을 제어합니다.

B

배경색 – 투명한 이미지에 배경을 적용합니다. 이 속성은 이미지 스타일을 준수합니다.

배경 이미지 – 배경 이미지를 지정합니다. 허용되는 형식은 PNG, JPEG 및 GIF입니다.

블리드 – 컨트롤이 부모 패딩을 통해 블리드할지 여부를 결정합니다.

C

선택 - 사용자가 선택할 수 있는 항목 목록입니다.

색상 – 텍스트의 색상을 제어합니다.

콘텐츠 정렬 – 열 내에서 콘텐츠를 세로로 정렬하는 방법을 정의합니다.

D

기본값 – 속성의 초기 값입니다.

구분선 – true인 경우 컨트롤 상단에 구분선을 그립니다.

E

오류 메시지 - 입력한 내용이 유효하지 않을 때 표시할 오류 메시지입니다.

F

팩트 - 팩트 세트에 표시할 팩트입니다.

글꼴 유형 - 렌더링에 사용할 글꼴 유형

H

높이 - 속성의 높이를 지정합니다.

수평 정렬 - 수평 정렬을 제어합니다.

I

IconUrl - 제목 옆의 버튼에 표시되는 옵션 아이콘입니다. 버전 1.2+에서 데이터 URI를 지원합니다.

이미지 크기 - 각 이미지의 대략적인 크기를 제어합니다. 물리적 크기는 호스트마다 다릅니다. 이미지 세트에는 자동 및 늘이기 기능이 지원되지 않습니다. 해당 값이 설정된 경우 크기는 기본적으로 중간으로 설정됩니다.

InlineAction – 입력에 대한 인라인 작업입니다. 일반적으로 입력 오른쪽에 표시됩니다. 작업에 아이콘을 제공하는 것이 좋습니다(작업 제목 대신 표시됨).

처음에 표시 – false인 경우 이 항목이 시각적 트리에서 제거됩니다.

L

레이블 – 입력 레이블입니다.

M

최대 길이 – 수집할 최대 문자 길이에 대한 힌트입니다(일부 클라이언트에서는 무시할 수 있음).

최대 줄 – 표시할 최대 줄 수를 지정합니다.

최대값 – 최대값에 대한 힌트(일부 클라이언트에서는 무시할 수 있음).

최소 높이 – "80px"와 같이 픽셀 단위로 설정된 열의 최소 높이를 지정합니다.

최소값 – 최소값에 대한 힌트(일부 클라이언트에서는 무시할 수 있음).

모드 – 모드는 카드 요소 간의 계층 구조를 설정하기 위해 기본 또는 보조로 정의할 수 있습니다.

여러 줄 - true인 경우 여러 줄의 입력을 허용합니다.

다중 선택 - 여러 항목을 선택할 수 있습니다.

O

OnSelect - 사용자가 버튼을 탭하거나 클릭할 때 수행할 작업입니다.

P

자리 표시자 – 원하는 입력에 대한 설명입니다. 선택하지 않았을 때 표시됩니다.

포스터 - 재생하기 전에 표시할 이미지의 URL입니다. 버전 1.2+에서 데이터 URI 지원

오른쪽에서 왼쪽으로 표시 – 활성화되면 컨테이너의 콘텐츠가 오른쪽에서 왼쪽으로 표시되어야 합니다. 비활성화되면 이 컨테이너의 콘텐츠가 왼쪽에서 오른쪽으로 표시되어야 합니다. 설정하지 않으면 레이아웃 방향이 상위 컨테이너 또는 열에서 상속됩니다. 모든 상위 항목에서 설정을 해제하면 기본 플랫폼 동작이 적용됩니다.

R

Regex – 이 텍스트 입력의 필수 형식을 나타내는 정규식입니다.

매번 반복 – 매번 반복은 데이터 원본을 기반으로 컨트롤을 여러 번 표시하는 데 사용됩니다. 모든 속성에 대한 반복이 컬렉션 또는 데이터 원본으로 설정되면 관련 속성이 ThisItem를 사용하여 컬렉션 또는 데이터 소스 내의 특정 항목을 참조할 수 있습니다.

Dataverse 계정 테이블과 텍스트 레이블의 매번 반복 속성을 사용하여 제작자는 계정 테이블 내의 모든 계정의 계정 이름을 표시하는 카드를 만들 수 있습니다.

  1. Dataverse 연결을 사용하여 계정 테이블을 추가합니다.
  2. 텍스트 레이블 컨트롤을 추가합니다.
  3. 텍스트 레이블 매번 반복 속성을 Accounts로 설정합니다.
  4. 텍스트 레이블 Text 속성을 ThisItem.'Account Name'으로 설정합니다.
  5. 계정 테이블 길이에 걸쳐 각각 계정 이름을 표시하는 텍스트 레이블 목록을 표시하는 카드를 사용하세요.

필수 필드 – 이 입력이 필수인지 여부입니다.

S

화면 - 사용자가 '화면 표시' 유형의 버튼을 탭하거나 클릭하면 현재 카드 아래에 표시되는 화면입니다.

눈금선 표시 – 눈금선을 표시할지 여부를 지정합니다.

표시 시기 – 조건부 레이아웃 식입니다.

크기 – 이미지 또는 텍스트의 대략적인 크기를 제어합니다.

소스 - 재생할 미디어 콘텐츠입니다. 기본적으로 지정된 첫 번째 항목을 재생합니다.

간격 - 이 컨트롤과 이전 컨트롤 사이의 간격을 제어합니다.

스타일 - 컨트롤의 스타일을 결정합니다.

미세 조정 – true일 경우 텍스트를 약간 톤 다운하여 눈에 잘 띄지 않게 표시합니다.

T

대상 요소 - 사용자가 '가시성 전환' 유형의 버튼을 탭하거나 클릭할 때의 가시성을 변경하는 요소입니다.

텍스트 - 표시할 텍스트입니다. 마크다운의 하위 집합이 지원됩니다(https://aka.ms/ACTextFeatures).

제목 - 이 버튼의 레이블입니다.

도구 설명 - 최종 사용자가 작업 위로 마우스를 가져갈 때 표시되고 내레이션 소프트웨어를 사용할 때 읽어야 하는 텍스트를 정의합니다.

유형 – 선택 시 버튼이 수행해야 하는 작업 - 화면 표시, Power Fx 실행, URL 열기 또는 가시성 전환이 될 수 있습니다.

U

URL – 이미지에 대한 URL 또는 버튼을 선택할 때 열릴 URL입니다. 버전 1.2+에서 데이터 URI를 지원합니다.

V

– 선택해야 하는 초기 항목(또는 항목 집합)입니다. 다중 선택의 경우 쉼표로 구분된 값 문자열을 지정합니다.

W

가중치 – 텍스트의 가중치를 제어합니다.

너비 – 속성의 원하는 너비입니다.

래핑 – true인 경우 텍스트 래핑을 허용합니다. 그렇지 않으면 텍스트가 잘립니다.