양식 텍스트 구성 요소 form-text-component
핵심 구성 요소의 양식 텍스트 구성 요소를 사용하여 제출용 양식 텍스트를 입력합니다.
사용량 usage
양식 텍스트 구성 요소를 사용하여 다양한 유형의 텍스트를 제출하고, 양식 컨테이너 구성 요소와 함께 이 구성 요소를 사용할 수 있습니다. 콘텐츠 편집기는 구성 대화 상자에서 텍스트 유효성 검사 유형, 라벨 및 도움말 메시지를 정의할 수 있습니다.
버전 및 호환성 version-and-compatibility
현재 버전의 양식 텍스트 구성 요소는 2018년 1월 핵심 구성 요소 릴리스 2.0.0과 함께 도입된 v2입니다. 이 문서에서는 해당 구성 요소에 대해 설명합니다.
다음 표에서 구성 요소의 모든 지원 버전, 구성 요소 버전과 호환되는 AEM 버전 및 이전 버전에 대한 설명서 링크에 대해 자세히 살펴볼 수 있습니다.
핵심 구성 요소 버전 및 릴리스에 대한 자세한 내용은 핵심 구성 요소 버전을 참조하십시오.
샘플 구성 요소 출력 sample-component-output
양식 텍스트 구성 요소를 경험하고 구성 옵션의 샘플뿐만 아니라 HTML 및 JSON 출력을 확인하려면 구성 요소 라이브러리를 참조하십시오.
기술 세부 사항 technical-details
양식 텍스트 구성 요소에 대한 최신 기술 설명서는 GitHub에서 확인할 수 있습니다.
핵심 구성 요소 개발에 대한 자세한 내용은 핵심 구성 요소 개발자 설명서를 참조하십시오.
구성 대화 상자 configure-dialog
콘텐츠 작성자는 구성 대화 상자를 통해 입력할 텍스트 유형뿐만 아니라 기본값 및 라벨을 정의할 수 있습니다.
속성 탭 properties-tab
-
제한 - 입력할 텍스트 유형은 다음을 통해 유효성이 확인됩니다.
- 텍스트
- 텍스트 영역
- 이메일
- 전화
- 날짜
- 번호
- 암호
-
텍스트 라인 - 텍스트 영역에 표시될 라인 수(제한 이 텍스트 영역 으로 설정될 경우에만 표시)
-
라벨 - 필드에 표시될 라벨
-
라벨이 표시되지 않도록 숨기기 - 손쉬운 사용을 위해 라벨이 필요한 경우. 필드에 대해 시각적 정보를 추가로 제공하지 않음
-
요소 이름 - 양식 데이터로 제출된 필드의 이름
-
값 - 필드에 미리 채워진 기본값
-
ID - 이 옵션을 통해 HTML과 데이터 레이어에서 구성 요소의 고유 식별자를 제어할 수 있습니다.
- 비워 두면 고유 ID는 자동으로 생성되고 결과 페이지 검사를 통해 발견될 수 있습니다.
- ID가 지정된 경우 작성자는 ID가 고유한지 확인해야 합니다.
- ID가 변경되면 CSS, JS 및 데이터 레이어 추적에 영향을 미칠 수 있습니다.
탭 정보 about-tab
- 도움말 메시지 - 필드에 입력할 수 있는 것에 대한 사용자용 힌트
- 도움말 메시지를 자리 표시자로 표시 - 양식이 비어 있고 포커스를 두지 않았을 때 양식 입력 내부에 도움말 메시지를 표시할지 여부
제한 탭 constraints-tab
-
제한 메시지
- 값이 선택된 유형에 대한 유효성을 검사하지 못할 경우 양식을 제출할 때 도구 설명으로 표시되는 메시지
- 텍스트 및 텍스트 영역 제한 유형에 표시되지 않음
-
필수 - 이 옵션을 선택하면 사용자는 양식을 제출하기 전에 값을 채워야 함
- 필수 메시지 - 필드를 비워 두면 툴팁으로 표시되는 메시지
-
읽기 전용 - 이 옵션을 선택하면 사용자는 필드 값을 수정할 수 없음
디자인 대화 상자 design-dialog
스타일 탭 styles-tab
양식 텍스트 구성 요소는 AEM 스타일 시스템을 지원합니다.