양식 텍스트 구성 요소(v1)

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

사용량

양식 텍스트 구성 요소를 사용하면 다양한 유형의 텍스트를 제출할 수 있으며, 양식 컨테이너 구성 요소와 함께 사용하기 위한 것입니다.

텍스트 유효성 검사, 레이블 및 도움말 메시지의 유형은 구성 대화 상자에서 콘텐츠 편집기에서 정의할 수 있습니다.

버전 및 호환성

이 문서에서는 원래 AEM 6.3과 함께 코어 구성 요소 릴리스 1.0.0에 소개된 양식 텍스트 구성 요소의 v1에 대해 설명합니다.

다음 표에는 양식 텍스트 구성 요소 v1의 호환성이 나와 있습니다.

AEM 버전 양식 텍스트 구성 요소 v1
6.3 호환 가능
6.4 호환 가능
주의

이 문서에서는 양식 텍스트 구성 요소의 v1에 대해 설명합니다.

양식 텍스트 구성 요소의 현재 버전에 대한 자세한 내용은 양식 텍스트 구성 요소 문서를 참조하십시오.

샘플 구성 요소 출력

다음은 We.Retail에서 가져온 샘플입니다.

스크린샷

HTML

<div class="cmp cmp-form aem-GridColumn aem-GridColumn--default--12">
 <form method="POST" action="/content/we-retail/us/en/experience.html" id="new_form" name="new_form" enctype="multipart/form-data" class="aem-Grid aem-Grid--12 aem-Grid--default--12 ">
     <input type="hidden" name=":formstart" value="/content/we-retail/us/en/experience/jcr:content/root/responsivegrid/container">
     <div class="cmp cmp-form-field aem-GridColumn aem-GridColumn--default--12">
   <div class="form-group">
       <label for="form-text-978484744">How many pieces of toast would you like?</label>
          <input type="number" id="form-text-978484744" name="pieces">
   </div>
  </div>
 </form>
</div>

JSON

"container": {
              "columnClassNames": "aem-GridColumn aem-GridColumn--default--12",
              "columnCount": 12,
              "gridClassNames": "aem-Grid aem-Grid--12 aem-Grid--default--12",
              ":items": {
                "text": {
                  "columnClassNames": "aem-GridColumn aem-GridColumn--default--12",
                  ":type": "weretail/components/form/text",
                  "name": "piecesOfToast",
                  "jcr:title": "How many pieces of toast would you like?",
                  "type": "number",
                  "rows": "2"
                }
              },
              ":itemsOrder": [
                "text"
              ],
              ":type": "weretail/components/form/container"
            }
노트

코어 구성 요소에서 JSON 내보내기를 사용하려면 핵심 구성 요소 릴리스 1.1.0이 필요합니다. 자세한 내용은 코어 구성 요소 v1🔗에 대한 호환성 정보를 참조하십시오.

구성 대화 상자

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

기본

  • 제한 - 입력할 텍스트 유형 및 유효성을 검사합니다

    • 텍스트
    • 텍스트 영역
    • 이메일
    • 전화
    • 날짜
    • 번호
    • 암호
  • 텍스트 행 - 텍스트 영역에 표시할 줄 수(제한 사항이 ​텍스트 영역으로 설정된 경우에만 표시됨)

  • 레이블 - 필드에 표시될 레이블입니다

  • 레이블이 표시되지 않도록 숨기기 - 액세서빌러티 목적으로만 레이블이 필요하고 필드에 대한 추가 시각적 정보는 영향을 받지 않는 경우에 필요합니다.

  • 요소 이름 - 양식 데이터와 함께 제출된 필드의 이름입니다

  • - 필드에서 미리 채워지는 기본값

정보

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

제한

  • 제한 메시지

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

  • 읽기 전용 만들기 - 선택한 경우 사용자가 필드의 값을 수정할 수 없습니다

디자인 대화 상자

양식 텍스트 구성 요소에 대한 디자인 대화 상자가 없습니다.

기술 세부 정보

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

전체 코어 구성 요소 프로젝트는 GitHub에서 다운로드할 수 있습니다.

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

이 페이지에서는