양식 옵션 구성 요소

마지막 업데이트: 2024년 7월 13일

작성 대상:

  • 개발자
  • 관리자
  • 사용자

핵심 구성 요소의 양식 옵션 구성 요소를 통해 다양한 포맷으로 사전 정의된 옵션을 선택할 수 있습니다.

사용량

핵심 구성 요소의 양식 옵션 구성 요소를 사용하여 다양한 방식으로 제공되는 여러 유형의 옵션을 제출하고, 양식 컨테이너 구성 요소와 함께 이 구성 요소를 사용할 수 있습니다.

콘텐츠 편집기는 구성 대화 상자에서 옵션, 라벨 및 개별 옵션 제공을 정의할 수 있습니다.

버전 및 호환성

현재 버전의 양식 옵션 구성 요소는 2018년 1월 핵심 구성 요소 릴리스 2.0.0과 함께 도입된 v2입니다. 이 문서에서는 해당 구성 요소에 대해 설명합니다.

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

구성 요소 버전AEM 6.4AEM 6.5AEM as a Cloud Service
v2릴리스 2.17.4 및 이전 버전과 호환 가능호환 가능호환 가능
v1호환 가능호환 가능호환 가능

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

샘플 구성 요소 출력

양식 옵션 구성 요소를 경험하고 구성 옵션의 샘플뿐만 아니라 HTML 및 JSON 출력을 확인하려면 구성 요소 라이브러리를 참조하십시오.

기술 세부 사항

양식 옵션 구성 요소에 대한 최신 기술 설명서는 GitHub에서 확인할 수 있습니다.

핵심 구성 요소 개발에 대한 자세한 내용은 핵심 구성 요소 개발자 설명서를 참조하십시오.

구성 대화 상자

콘텐츠 작성자는 구성 대화 상자를 통해 제공할 옵션 유형, 라벨과 사용 가능한 옵션을 정의할 수 있습니다.

양식 옵션 구성 요소의 편집 대화 상자

  • 유형 - 옵션을 제공하는 방법

    • 확인란
    • 라디오 버튼
    • 드롭다운
    • 다중 선택 드롭다운

  • 제목 - 옵션용 라벨로 표시되는 제목

  • 이름 - 양식 데이터로 제출된 필드의 이름

  • 소스 - 옵션을 정의하는 위치

    • 로컬 - 구성 요소 내에서 정의합니다.

      • 추가 버튼을 탭하거나 클릭하여 값을 추가하고, 삭제 ​를 탭하거나 클릭하여 값을 삭제합니다.

        • 값 - 양식 제출 시 해당 옵션이 선택되면 저장되는 값
        • 텍스트 - 양식에 표시되는 옵션용 라벨
        • 활성 - 양식 로드 시 옵션이 선택된 상태로 표시됩니다.
        • 비활성 - 옵션은 선택할 수 없지만 계속 표시됩니다.

    • 목록 - AEM의 다른 곳에서 정의된 정적 목록을 옵션용으로 사용합니다.

      • 목록 - AEM 내 정적 목록의 경로
        • 검색 버튼을 사용하여 목록 리소스를 찾습니다.

    • 데이터 소스 - 데이터 소스를 옵션용으로 사용합니다.

      • 데이터 소스 - 데이터 소스의 리소스 유형

  • 도움말 메시지 - 필드에 입력할 수 있는 것에 대한 사용자용 힌트

  • ID - 이 옵션을 통해 HTML과 데이터 레이어에서 구성 요소의 고유 식별자를 제어할 수 있습니다.

    • 비워 두면 고유 ID는 자동으로 생성되고 결과 페이지 검사를 통해 발견될 수 있습니다.
    • ID가 지정된 경우 작성자는 ID가 고유한지 확인해야 합니다.
    • ID가 변경되면 CSS, JS 및 데이터 레이어 추적에 영향을 미칠 수 있습니다.

디자인 대화 상자

스타일 탭

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

Experience Manager