SearchBox 제어 (프리뷰)
[이 문서는 시험판 문서이며 변경될 수 있습니다.]
검색 환경을 만드는 데 사용되는 컨트롤입니다.
설명
검색창(SearchBox)은 특정 항목을 찾기 위해 사이트 또는 앱 내에서 검색하기 위한 입력 필드를 제공합니다.
이 코드 구성 요소는 캔버스 및 사용자 지정 페이지에서 사용하기 위해 유창한 UI SearchBox 컨트롤 주위에 래퍼를 제공합니다.
중요
- 이는 프리뷰 기능입니다.
- 프리뷰 기능은 생산용으로 만들어진 것이 아니므로 기능이 제한될 수 있습니다. 이런 기능은 공식 릴리스 전에 사용할 수 있으므로 고객이 조기에 액세스하고 피드백을 제공할 수 있습니다.
키 속성
| Property | Description |
|---|---|
SearchText |
사용자가 입력한 텍스트입니다. 이것을 검색 기능의 입력으로 참조하십시오. |
IconName |
유창한 UI 아이콘의 이름입니다(유창한 UI 아이콘 참조). |
Underlined |
검색창에 밑줄이 표시되는지 여부입니다. |
DisableAnimation |
포커스가 있을 때 검색창 아이콘에 애니메이션을 적용할지 여부입니다. |
PlaceholderText |
검색창의 자리 표시자입니다. |
추가 속성
| Property | Description |
|---|---|
Theme |
테마 개체(Json 형식이 아님). 설정 방법은 테마 설정을 참고하세요. |
AccessibilityLabel |
화면 읽기 프로그램 아리아-레이블입니다. |
InputEvent |
컨트롤에 보낼 이벤트입니다. 예: SetFocus. |
예
검색 동작 구성
일반적으로 갤러리, DetailsList 또는 데이터 세트를 표시할 수 있는 모든 컨트롤과 결합된 검색 인터페이스가 필요한 앱에 이 컨트롤을 추가합니다.
SearchBox의 SearchText 속성 값을 사용하는 Search() 또는 Filter() 표현식을 사용하여 검색 환경을 만듭니다.
Search( Accounts, SearchBox.SearchText, "name" )
제한 사항
이 코드 구성 요소는 캔버스 앱 및 사용자 정의 페이지에서만 사용할 수 있습니다.