Picker 제어
검색 환경을 제공하는 데 사용되는 컨트롤입니다.
노트
GitHub 코드 구성 요소 리포지토리에서 전체 설명서 및 소스 코드를 확인할 수 있습니다.
Description
선택기는 큰 목록에서 태그나 파일과 같은 하나 이상의 항목을 선택하는 데 사용됩니다.
Picker 코드 구성 요소를 사용하면 캔버스 앱 및 사용자 지정 페이지 내부에서 유창한 UI picker 메뉴 구성 요소를 사용할 수 있습니다.
Tag Picker 코드 구성요소는 다음 기능을 제공합니다.
- 선택한 태그에 대한 입력 컬렉션에 바인딩합니다.
- 제안된 태그에 대한 입력 컬렉션에 바인딩합니다.
- 사용자가 제안에서 선택하거나 자유 텍스트 태그를 입력할 수 있습니다.
- 사용자가 태그를 추가하거나 제거하면 변경 시 이벤트가 발생합니다.
- 프로그래밍 방식 초점 설정을 허용합니다.
데이터 집합
Tag Picker에는 이 문서 뒷부분의 키 속성에서 자세히 설명하는 다음과 같은 입력 데이터 집합이 있습니다.
TagsTagsDisplayName
SuggestionsSuggestionsDisplayNameSuggestionSubDisplayName
Suggestions 데이터 집합은 SearchTerm 출력 속성을 사용하여 필터링해야 합니다. 예를 들면 다음과 같습니다.
Search(colSuggestions,TagPicker.SearchTerm,"name")
속성
키 속성
| Property | Description |
|---|---|
Items |
태그 컬렉션(테이블). 앱은 구성 요소에서 발생하는 추가 또는 제거 이벤트에 대한 응답으로 태그를 추가하거나 제거할 책임이 있습니다(다음 OnChange 이벤트 섹션에 설명). |
Suggestions_Items |
제안 컬렉션(테이블). |
TagMaxWidth |
렌더링 시 태그의 최대 너비입니다. 오버플로 텍스트는 줄임표로 잘리고 호버 도구 설명에 전체 텍스트가 표시됩니다. |
AllowFreeText |
값을 입력할 때 사전 정의된 목록에서 선택하는 대신 자유 텍스트 항목이 제공될 수 있도록 첫 번째 제안을 자동으로 선택하지 마십시오. |
SearchTermToShortMessage |
검색어가 MinimumSearchTermLength 미만일 때 표시되는 메시지입니다. |
HintText |
검색어가 제공되지 않은 경우 선택기 내부에 표시할 메시지입니다. |
NoSuggestionsFoundMessage |
제안 컬렉션에 결과가 없을 때 표시할 메시지입니다. |
MinimumSearchTermLength |
제안 플라이아웃을 트리거할 최소 문자 수입니다. |
MaxTags |
추가할 수 있는 최대 태그 수입니다. 이 번호 이후에는 태그가 제거될 때까지 태그 선택기를 다시 사용할 수만 있습니다. |
Error |
빨간색 오류 테두리가 표시되어야 하는 경우 True입니다. |
Items 속성
| Property | Description |
|---|---|
TagsDisplayName |
태그 표시 이름을 보유하는 열의 이름으로 설정합니다. |
Suggestions 속성
| Property | Description |
|---|---|
SuggestionsDisplayName |
제안 표시 이름을 보유하는 열의 이름으로 설정합니다. |
SuggestionsSubDisplayName |
(선택 사항) - 텍스트의 두 번째 줄을 포함하는 열의 이름으로 설정합니다. |
스타일 속성
| Property | Description |
|---|---|
Theme |
유창한 UI 테마 디자이너(windows.net)를 사용하여 생성된 JSON 문자열을 허용합니다. 이 항목을 비워 두면 Power Apps에서 정의한 기본 테마가 사용됩니다. 설정 방법은 테마 설정을 참고하세요. |
FontSize |
선택기 내부에 표시되는 태그의 글꼴 크기입니다. |
BorderRadius |
선택기 내부에 표시되는 태그의 테두리 반경입니다. |
ItemHeight |
선택기 내부에 표시되는 태그(픽셀)의 높이입니다. |
AccessibilityLabel |
화면 읽기 프로그램 아리아-레이블 |
이벤트 속성
| Property | Description |
|---|---|
Input Event |
TagPicker로 보낼 이벤트로 설정 |
Output 속성
| Property | Description |
|---|---|
SearchTerm |
제안 데이터 세트를 필터링하는 데 사용할 수 있는 태그 선택기에 입력된 텍스트입니다. |
TagsDisplayName |
On Change 이벤트가 발생할 때 새로운 태그를 생성하는 데 사용되는 텍스트 |
AutoHeight |
태그 선택기가 여러 줄로 줄 바꿈되는 경우 자동 높이 속성을 사용하여 반응형 컨테이너 높이의 높이를 제어할 수 있습니다. |
동작
SetFocus를 InputEvent로 지원합니다.
OnChange 이벤트
TagPicker 구성 요소는 태그가 추가되거나 제거될 때 OnChange 이벤트를 발생시킵니다. 사용된 속성은 다음과 같습니다.
| Property | Description |
|---|---|
TagEvent |
발생한 이벤트의 이름 |
TagKey |
이벤트를 발생시킨 항목의 키(이벤트가 태그와 관련된 경우) |
이벤트에는 다음과 유사한 표현식이 포함되어야 합니다.
If( TagPicker.TagEvent = "Add" && CountRows(Filter(colTags,name=TagPicker.TagsDisplayName)) = 0,
Collect( colTags, { name:TagPicker.TagsDisplayName })
);
If( TagPicker.TagEvent="Remove",
RemoveIf( colTags,name=Text(TagPicker.TagsDisplayName) )
);
제한 사항
이 코드 구성 요소는 캔버스 앱 및 사용자 정의 페이지에서만 사용할 수 있습니다.