다음을 통해 공유


CreateUiDefinition 요소

이 문서에서는 createUiDefinition.json 파일의 지원되는 모든 요소에 대한 스키마 및 속성을 설명합니다.

스키마

대부분의 요소에 대한 스키마는 다음과 같습니다.

{
  "name": "element1",
  "type": "Microsoft.Common.TextBox",
  "label": "Some text box",
  "defaultValue": "my value",
  "toolTip": "Provide a descriptive name.",
  "constraints": {},
  "options": {},
  "visible": true
}
속성 필수 설명
name 요소의 특정 인스턴스를 참조하는 내부 식별자입니다. 요소 이름의 가장 일반적인 사용법은 outputs에 있으며, 지정된 요소의 출력 값이 템플릿의 매개 변수에 매핑됩니다. 또한 요소의 출력 값을 다른 요소의 defaultValue에 바인딩하는 데 사용할 수 있습니다.
type 요소에 대해 렌더링할 UI 컨트롤입니다. 지원되는 형식 목록은 요소를 참조하세요.
label 요소의 표시 텍스트입니다. 일부 요소 형식에는 여러 개의 레이블이 포함되므로 값은 여러 문자열을 포함하는 개체가 될 수 있습니다.
defaultValue 아니요 요소의 기본값입니다. 일부 요소 형식에서 복잡한 기본값을 지원하므로 이 값은 개체가 될 수 있습니다.
toolTip 아니요 요소의 도구 설명에 표시할 텍스트입니다. label과 마찬가지로 일부 요소에서 여러 개의 도구 설명 문자열을 지원합니다. Markdown 구문을 사용하여 인라인 링크를 포함할 수 있습니다.
constraints 아니요 요소의 유효성 검사 동작을 사용자 지정하는 데 사용되는 하나 이상의 속성입니다. 제약 조건에 지원되는 속성은 요소 형식에 따라 다릅니다. 일부 요소 형식은 유효성 검사 동작의 사용자 지정을 지원하지 않으므로 제약 조건 속성이 없습니다.
options 아니요 요소의 동작을 사용자 지정하는 추가 속성입니다. constraints과 마찬가지로 지원되는 속성은 요소 형식에 따라 다릅니다.
visible 아니요 요소가 표시되는지 여부를 나타냅니다. true이면 요소 및 적용 가능한 자식 요소가 표시됩니다. 기본값은 true입니다. 논리 함수를 사용하여 이 속성의 값을 동적으로 제어합니다.

Elements

각 요소에 대한 설명서에는 UI 샘플, 스키마, 요소의 동작에 대한 설명(일반적으로 유효성 검사 및 지원되는 사용자 지정과 관련됨) 및 샘플 출력이 포함되어 있습니다.

다음 단계

UI 정의 만들기에 대한 소개는 CreateUiDefinition 시작을 참조하세요.