Form Builder 개요
App Builder의 Form Builder 기능은 개발자가 드래그 앤 드롭 경험을 통해 HTML 양식을 설계할 수 있게 해줍니다. API 엔드포인트에서 직접 양식 구조를 자동으로 생성하여 생성 프로세스를 단순화하고 백엔드 소스와의 원활한 데이터 연결을 허용하는 데 중점을 둡니다. 이 기능은 양식 레이아웃, 구성 요소 커스터마이제이션에서 광범위한 유연성을 제공하며 제출, 오류 및 서버 측 유효성 검사 알림 표시 옵션을 포함합니다.
Form Builder의 주요 기능
데이터 엔드포인트에서 자동 양식 생성
개발자가 데이터 엔드포인트를 디자인 표면으로 드래그할 때, 엔드포인트의 속성을 기반으로 한 세트의 양식 구성 요소가 자동으로 생성됩니다.
POST및PUT메서드는 데이터 제출을 위한 입력 필드를 생성합니다.OnSuccess및OnError상호작용 같은 기본 이벤트 처리가 자동으로 구성됩니다.
자동 양식 생성
자동 양식 컨트롤 생성 및 매핑
양식 컨트롤은 각 필드의 데이터 유형 및 메타데이터를 기반으로 생성되어 직관적인 입력 및 레이블을 보장합니다(예: 날짜 필드는 _날짜 선택기_를 사용하고, 부울 필드는 _스위치_를 사용합니다). 개발자는 속성 패널에서 직접 구성 요소를 수정하고, 유효성 검사를 추가하거나, 레이블을 조정할 수 있는 모든 제어 권한을 유지합니다.
자동 양식 컨트롤 생성
양식 수정
생성된 후, 양식을 편집하여 필드를 포함하거나 제외할 수 있고, 레이블을 커스터마이즈하며, 입력 유효성 검사를 설정할 수 있어 직관적인 디자인 경험을 제공합니다. App Builder는 개발자가 양식 레이아웃과 구성 요소를 모두 조정할 수 있게 합니다:
- 양식 내 요소를 쉽게 추가하거나 제거합니다.
- 필수 및 비활성화 유효성 검사, 레이블 커스터마이제이션 및 매핑 같은 컨트롤 속성을 조정합니다.
양식 수정
양식과의 라이브 상호작용
App Builder의 미리보기 모드에서 사용자는 양식과 상호작용하여 다음을 볼 수 있습니다:
- 실시간 입력 유효성 검사.
- 성공 또는 유효성 검사 오류를 나타내는 알림과 함께 양식을 제출합니다.
변수 및 양식 초기 상태 설정
Note
미리보기 모드에서 양식 제출 시 Post/Put 동작이 실행되어 지정된 엔드포인트를 통해 레코드를 추가하거나 업데이트합니다.
구성 가능한 동작 버튼
동작 버튼(Submit, Reset)은 완전한 커스터마이제이션을 제공하며 양식 내 및 외부 배치를 모두 지원합니다. 이 유연성은 더 복잡한 레이아웃에서 양식 동작에 대한 정확한 제어가 필요한 개발자에게 필수적입니다.
동작 버튼 구성
제출 동작 알림
성공 및 오류 메시지는 Snackbars를 통해 표시되어 양식 제출에 대한 방해가 적은 피드백을 제공합니다. 이러한 알림은 초기 릴리스에서 하드코드되어 있으며 향후 반복에서 유연한 상호작용 처리를 지원할 계획입니다.
Form Builder 컨트롤 지원
Form Builder는 특정 데이터 유형으로 매핑된 다양한 UI 컨트롤을 지원하여 개발자가 접근 가능하고 반응형인 양식을 효율적으로 만들 수 있도록 합니다. 다음은 지원되는 컨트롤과 현재 제한 사항의 요약입니다.
| Form 컨트롤 | 기본 유형 | 참고 사항 |
|---|---|---|
| Radio Group | Boolean | 필수 필드 유효성 검사 부족 |
| Checkbox | Boolean | 필수 필드 유효성 검사 부족 |
| Switch | Boolean | - |
| Slider | Number | - |
| Select | Enum | - |
| Combo Box | Enum | - |
| Date Picker | Date | - |
| Calendar | Date | 선택된 날짜를 정확하게 새로 고치지 않을 수 있습니다 |
| Input Field | String, Number | - |
Note
Form 컨트롤은 현재 기본 유효성 검사 속성(Required, Disabled)을 지원합니다.
모든 Form 컨트롤은 양방향 바인딩을 지원하며 양식 컨텍스트에 바인딩되어 있습니다.
향후 개선 사항
App Builder의 Form Builder에 대한 로드맵은 수동 양식 생성, 유효성 검사 옵션, 확장된 메타데이터 지원 및 향상된 알림과 상호작용 처리의 발전을 포함합니다.
향후 유효성 검사 개선 사항에는 다음이 포함됩니다:
- 범위 유효성 검사(
min,max). - 문자열 길이 유효성 검사(
min length,max length). - 패턴 유효성 검사(regex).
- select 및 combo box 컨트롤에 대한 Enum 유효성 검사
알려진 문제 및 제한 사항
다음 알려진 문제 및 제한 사항은 10월 28일에 출시된 Form Builder의 초기 릴리스에 적용됩니다:
- 양식 초기화 동작 App Builder 런타임 경험과 생성된 애플리케이션 런타임 간의 불일치:
- App Builder에서 초기화 버튼 클릭은 레코드를 편집할 때 초기 값으로 되돌리고, 새 레코드를 추가할 때 양식을 지웁니다.
- 생성된 애플리케이션에서 초기화 버튼 클릭은 모든 양식 컨트롤을 빈 값으로 설정하여 양식을 지웁니다.
- 양식 복사-붙여넣기: 현재 양식을 복사하고 붙여넣으면 원본 양식이 데이터 바인딩을 잃고, 새로 붙여넣은 양식 인스턴스로 전송됩니다.
- Boolean 필수 플래그: “서비스 약관에 동의” 같은 경우에 특히 필수 Boolean 필드를 구현하는 데 모호함이 있습니다.
- 제출/초기화 동작: 제출/초기화 기능은 템플릿 및 반응형 양식 내에서 작동하도록 조정되었지만 여전히 불일치를 경험할 수 있습니다.
- 코드 생성:
- 양식 모델의 유형 문제: 특히 중첩된 구조 또는 배열로 작업할 때 유형 불일치가 발생할 수 있으므로 출력 코드에서 정확한 양식 모델 생성이 복잡해집니다.
- 미리보기의
igx-hint요소:igx-hint요소는 현재 최종 코드에서 생성되지 않으므로 미리보기에서 제외됩니다. 향후 업데이트는 메시지 표시 기능에 대한 지원을 추가할 수 있습니다. - Calendar는 양식에 있을 때 생성된 앱에 표시되지 않습니다.
- 초기화 버튼 클릭 동작 - React로 생성된 프로젝트에서 양식을 지웁니다. 초기 값으로 되돌리는 대신 양식 컨트롤이 빈 값을 가집니다.
- 비활성화 속성은 Angular로 생성된 양식의 입력에서 렌더링되지 않습니다.
