Show Menu
TOPICS×

양식 텍스트 구성 요소

핵심 구성 요소 양식 텍스트 구성 요소를 사용하면 양식 텍스트를 입력하여 제출할 수 있습니다.

사용량

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

버전 및 호환성

양식 텍스트 구성 요소의 현재 버전은 v2입니다. v2는 2018년 1월에 핵심 구성 요소 릴리스 2.0.0과 함께 도입되었으며 이 문서에 설명되어 있습니다.
다음 표에서는 구성 요소의 지원되는 모든 버전, 구성 요소의 버전이 호환되는 AEM 버전 및 이전 버전에 대한 설명서 링크에 대해 자세히 설명합니다.
구성 요소 버전
AEM 6.3
AEM 6.4
AEM 6.5
클라우드 서비스로서의 AEM
v2
-
호환 가능
호환 가능
호환 가능
호환 가능
호환 가능
호환 가능
-
핵심 구성 요소 버전 및 릴리스에 대한 자세한 내용은 핵심 구성 요소 버전을 참조하십시오 .

샘플 구성 요소 출력

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

기술 세부 정보

양식 텍스트 구성 요소에 대한 최신 기술 문서는 GitHub에서 찾을 수 있습니다 .
핵심 구성 요소 개발에 대한 자세한 내용은 핵심 구성 요소 개발자 설명서를 참조하십시오 .

구성 대화 상자

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

속성 탭

  • 제한
    - 입력할 텍스트 유형으로,
    • 텍스트
    • 텍스트 영역
    • 이메일
    • 전화
    • 날짜
    • 번호
    • 암호
  • 텍스트 라인
    - 텍스트 영역에 표시할 줄 수(제한
    을 텍스트 영역
    으로 설정한 경우에만
    표시됨
    )
  • 레이블
    - 필드에 표시할 레이블입니다.
  • 레이블 표시
    안 함 - 액세스 가능성 목적으로만 레이블이 필요하고 필드에 대한 추가 시각적 정보를 포함하지 않는 경우에 필요합니다.
  • 요소 이름
    - 양식 데이터와 함께 전송된 필드의 이름입니다.
  • - 필드에 미리 채워진 기본값
    • 비워 두면 자동으로 고유 ID가 생성되어 결과 페이지를 검사하여 찾을 수 있습니다.
    • ID가 지정된 경우 작성자는 ID가 고유한지 확인해야 합니다.
    • ID를 변경하면 CSS, JS 및 데이터 레이어 추적에 영향을 줄 수 있습니다.

정보 탭

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

제한 탭

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

디자인 대화 상자

스타일 탭

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