양식 텍스트 구성 요소

코어 구성 요소 양식 텍스트 구성 요소를 사용하면 양식을 제출할 수 있습니다.

사용량

양식 텍스트 구성 요소는 다양한 유형의 텍스트를 전송할 수 있도록 하며 양식 컨테이너 구성 요소와 함께 사용됩니다. 텍스트 유효성 검사, 레이블 및 도움말 메시지의 유형은 구성 대화 상자에서 콘텐츠 편집기에서 정의할 수 있습니다.

버전 및 호환성

양식 텍스트 구성 요소의 현재 버전은 v2이며, 2018년 1월에 핵심 구성 요소 릴리스 2.0.0에서 도입되었으며, 이 문서에 설명되어 있습니다.

다음 표에서는 구성 요소의 지원되는 모든 버전, 구성 요소의 버전이 호환되는 AEM 버전 및 이전 버전에 대한 설명서 링크에 대해 자세히 설명합니다.

구성 요소 버전 AEM 6.4 AEM 6.5 AEM as a Cloud Service
v2 호환 가능 호환 가능 호환 가능
v1 호환 가능 호환 가능 -

핵심 구성 요소 버전 및 릴리스에 대한 자세한 내용은 핵심 구성 요소 버전 문서를 참조하십시오.

샘플 구성 요소 출력

양식 텍스트 구성 요소 와 구성 옵션의 예 및 HTML 및 JSON 출력을 보려면 구성 요소 라이브러리를 방문하십시오.

기술 세부 정보

양식 텍스트 구성 요소 에 대한 최신 기술 설명서는 GitHub에 있습니다.

코어 구성 요소 개발에 대한 자세한 내용은 코어 구성 요소 개발자 설명서에서 확인할 수 있습니다.

구성 대화 상자

구성 대화 상자에서는 컨텐츠 작성자가 입력할 텍스트 유형과 기본값 및 레이블을 정의할 수 있습니다.

속성 탭

속성 탭

  • 제한 - 입력할 텍스트 유형 및 유효성을 검사합니다
    • 텍스트
    • 텍스트 영역
    • 이메일
    • 전화
    • 날짜
    • 번호
    • 암호
  • 텍스트 행 - 텍스트 영역에 표시할 줄 수(제한 사항이 ​텍스트 영역으로 설정된 경우에만 표시됨)
  • 레이블 - 필드에 표시될 레이블입니다
  • 레이블이 표시되지 않도록 숨기기 - 액세서빌러티 목적으로만 레이블이 필요하고 필드에 대한 추가 시각적 정보는 영향을 받지 않는 경우에 필요합니다.
  • 요소 이름 - 양식 데이터와 함께 제출된 필드의 이름입니다
  • - 필드에 미리 채워지는 기본값입니다
  • ID - 이 옵션을 사용하면 HTML과 데이터 레이어에서 구성 요소의 고유 식별자를 제어할 수 있습니다.
    • 비워 두면 고유 ID가 자동으로 생성되며 결과 페이지를 검사하여 찾을 수 있습니다.
    • ID가 지정된 경우 ID가 고유한지 확인하는 것은 작성자의 책임입니다.
    • ID를 변경하면 CSS, JS 및 데이터 레이어 추적에 영향을 줄 수 있습니다.

탭 정보

정보 탭

  • 도움말 메시지 - 필드에 입력할 수 있는 항목의 힌트입니다
  • 도움말 메시지를 자리 표시자로 표시 - 양식 입력이 비어 있고 초점이 맞지 않을 때 양식 입력 내에 도움말 메시지를 표시합니다

제한 탭

제한 탭

  • 제한 메시지
    • 값이 선택된 유형에 대한 유효성을 검사하지 못할 경우 양식을 제출할 때 도구 설명으로 표시되는 메시지
    • 텍스트텍스트 영역 제약 조건 유형에 대해 표시되지 않습니다.
  • 필수 - 선택한 경우 양식을 제출하기 전에 사용자가 값을 입력해야 합니다
    • 필수 메시지 - 필드가 비어 있는 경우 도구 설명으로 표시되는 메시지
  • 읽기 전용 만들기 - 선택한 경우 사용자가 필드의 값을 수정할 수 없습니다

디자인 대화 상자

스타일 탭

양식 텍스트 구성 요소는 AEM 스타일 시스템을 지원합니다.

이 페이지에서는