Show Menu
화제×

적응형 양식 필드에 대한 사용자 정의 모양 만들기

소개

적응형 양식은 모양 프레임워크를 활용하여 적응형 양식 필드에 대한 사용자 정의 모양을 만들고 다른 사용자 경험을 제공할 수 있습니다. 예를 들어 라디오 단추 및 확인란을 전환 단추로 바꾸거나 사용자 정의 jQuery 플러그인을 사용하여 전화 번호나 이메일 ID와 같은 필드에 사용자가 입력하는 내용을 제한할 수 있습니다.
이 문서에서는 jQuery 플러그인을 사용하여 적응형 양식 필드에 대한 이러한 대체 경험을 만드는 방법에 대해 설명합니다. 또한 숫자 필드 구성 요소가 숫자 스테퍼 또는 슬라이더로 나타날 수 있도록 사용자 정의 모양을 만드는 예제가 표시됩니다.
이 문서에서 사용되는 주요 용어와 개념을 먼저 살펴보겠습니다.
모양 적응형 양식 필드의 다양한 요소의 스타일, 모양 및 느낌 및 구성을 나타냅니다. 일반적으로 입력, 도움말 아이콘, 필드에 대한 짧고 긴 설명을 제공하는 대화형 영역이 포함됩니다. 이 문서에서 설명한 모양 사용자 지정은 필드의 입력 영역 모양에 적용됩니다.
jQuery 플러그인 jQuery 위젯 프레임워크를 기반으로 하는 표준 메커니즘을 제공하여 대체 모양을 구현합니다.
ClientLib 복잡한 JavaScript 및 CSS 코드로 구동되는 AEM 클라이언트측 처리에서 클라이언트측 라이브러리 시스템입니다. 자세한 내용은 클라이언트측 라이브러리 사용을 참조하십시오.
Rantype Maven 프로젝트를 위한 원본 패턴 또는 모델로 정의된 Maven 프로젝트 템플릿 작성 툴킷입니다. 자세한 내용은 원형 소개를 참조하십시오.
사용자 컨트롤 필드의 값이 들어 있는 위젯의 기본 요소를 나타내며 사용자 정의 위젯 UI를 적응형 양식 모델로 바인딩하기 위한 모양 프레임워크에서 사용됩니다.

사용자 정의 모양 만들기 단계

높은 수준의 사용자 정의 모양을 만드는 단계는 다음과 같습니다.
  1. 프로젝트 ​만들기:AEM에 배포할 컨텐츠 패키지를 생성하는 Maven 프로젝트를 만듭니다.
  2. 기존 위젯 클래스 ​확장:기존 위젯 클래스를 확장하고 필요한 클래스를 무시합니다.
  3. 클라이언트 라이브러리 ​만들기:라이브러리를 clientLib: af.customwidget 만들고 필요한 JavaScript 및 CSS 파일을 추가합니다.
  4. 프로젝트를 ​빌드하고 설치합니다.Maven 프로젝트를 빌드하고 AEM에 생성된 콘텐츠 패키지를 설치합니다.
  5. 적응형 양식을 ​업데이트합니다.사용자 정의 모양을 사용하도록 적응형 양식 필드 속성을 업데이트합니다.

프로젝트 만들기

마비되는 원형은 사용자 정의 모양을 만드는 시작점입니다. 사용할 원형의 세부 사항은 다음과 같습니다.
  • 저장소 :https://repo.adobe.com/nexus/content/groups/public/
  • 아티팩트 ID :custom-appearance-tranype
  • 그룹 ID :com.adobe.aemforms
  • 버전 :1.0.4
다음 명령을 실행하여 원형대로 로컬 프로젝트를 만듭니다.
mvn archetype:generate -DarchetypeRepository=https://repo.adobe.com/nexus/content/groups/public/ -DarchetypeGroupId=com.adobe.aemforms -DarchetypeArtifactId=custom-appearance-archetype -DarchetypeVersion=1.0.4
이 명령은 저장소에서 Maven 플러그인 및 원형 정보를 다운로드하고 다음 정보를 기반으로 프로젝트를 생성합니다.
  • groupId :생성된 Maven 프로젝트에서 사용되는 그룹 ID
  • artifactId :생성된 Maven 프로젝트에서 사용되는 아티팩트 ID.
  • 버전 :생성된 Maven 프로젝트의 버전입니다.
  • 패키지 :파일 구조에 사용되는 패키지입니다.
  • artifactName :생성된 AEM 패키지의 아티팩트 이름입니다.
  • packageGroup :생성된 AEM 패키지의 패키지 그룹입니다.
  • widgetName :참조에 사용되는 모양 이름입니다.
생성된 프로젝트의 구조는 다음과 같습니다.
─<artifactId>

 └───src

     └───main

         └───content

             └───jcr_root

                 └───etc

                     └───clientlibs

                         └───custom

                             └───<widgetName>

                                 ├───common [client library - af.customwidgets which encapsulates below clientLibs]

                                 ├───integration [client library - af.customwidgets.<widgetName>_widget which contains template files for integrating a third-party plugin with Adaptive Forms]

                                 │   ├───css

                                 │   └───javascript

                                 └───jqueryplugin [client library - af.customwidgets.<widgetName>_plugin which holds the third-party plugins and related dependencies]

                                     ├───css

                                     └───javascript

기존 위젯 클래스 확장

프로젝트 템플릿이 만들어지면 필요에 따라 다음 변경 사항을 수행합니다.
  1. 프로젝트에 대한 타사 플러그인 종속성을 포함합니다.
    1. 타사 또는 사용자 지정 jQuery 플러그인을 jqueryplugin/javascript 폴더에 배치하고 관련 CSS 파일을 jqueryplugin/css 폴더에 배치합니다. 자세한 내용은 jqueryplugin/javascript and jqueryplugin/css 폴더 아래의 JS 및 CSS 파일을 참조하십시오.
    2. jQuery 플러그인의 추가 JavaScript 및 CSS 파일을 포함하도록 js.txt css.txt 파일을 수정합니다.
  2. 타사 플러그인을 프레임워크와 통합하여 사용자 정의 모양 프레임워크와 jQuery 플러그인 간의 상호 작용을 활성화합니다. 새 위젯은 다음 기능을 확장하거나 덮어쓴 후에만 작동합니다.
함수 설명
render render 함수는 위젯의 기본 HTML 요소에 대한 jQuery 객체를 반환합니다. 기본 HTML 요소는 포커스 가능한 유형이어야 합니다. 예: <a> , <input> , <li> and. 반환된 요소는 로 사용됩니다 $userControl . 에서 위의 $userControl AbstractWidget 제한을 지정하면 클래스의 함수가 예상대로 작동하며, 다른 일반적인 API(focus, click) 중 일부는 변경이 필요합니다.
getEventMap HTML 이벤트를 XFA 이벤트로 변환하는 맵을 반환합니다. 이 { blur: XFA_EXIT_EVENT, } 예에서는 blur XFA_EXIT_EVENT HTML 이벤트이며 해당 XFA 이벤트임을 보여줍니다.
getOptionsMap 옵션 변경에 대해 수행할 작업에 대한 세부 정보를 제공하는 맵을 반환합니다. 키는 위젯에 제공되는 옵션이며, 값은 옵션이 변경될 때마다 호출되는 함수입니다. 위젯은 모든 일반적인 옵션( value 및 제외)에 대한 핸들러를 제공합니다 displayValue .
getCommitValue jQuery 위젯 프레임워크는 jQuery 위젯의 값이 XFA 모델에 저장될 때마다(예: 텍스트 필드의 종료 이벤트) 함수를 로드합니다. 구현은 위젯에 저장된 값을 반환해야 합니다. 처리기에 옵션에 대한 새 값이 제공됩니다.
showValue 기본적으로 XFA에서 이벤트 시작 시 rawValue 필드의 내용이 표시됩니다. 이 함수는 사용자에게 이 함수를 표시하기 위해 rawValue 호출됩니다.
showDisplayValue 기본적으로 종료 이벤트 시 XFA에서 formattedValue 필드의 내용이 표시됩니다. 이 함수는 사용자에게 이 함수를 표시하기 위해 formattedValue 호출됩니다.
  1. 필요에 따라 integration/javascript 폴더의 JavaScript 파일을 업데이트합니다.
    • 텍스트를 실제 위젯 __widgetName__ 이름으로 바꿉니다.
    • 즉시 사용 가능한 위젯 클래스에서 위젯을 확장합니다. 대부분의 경우 대체되는 기존 위젯에 해당하는 위젯 클래스입니다. 상위 클래스 이름은 여러 위치에서 사용되므로 파일에서 문자열의 모든 인스턴스를 검색한 다음 xfaWidget.textField 사용된 실제 상위 클래스로 바꾸는 것이 좋습니다.
    • 대체 UI를 제공하도록 render 메서드를 확장합니다. UI 또는 상호 작용 비헤이비어를 업데이트하기 위해 jQuery 플러그인을 호출할 위치입니다. 이 render 메서드는 사용자 제어 요소를 반환해야 합니다.
    • 위젯의 변경으로 인해 영향을 받는 모든 옵션 설정을 무시하도록 getOptionsMap 메서드를 확장합니다. 이 함수는 옵션 변경 시 수행할 작업에 대한 세부 정보를 제공하는 매핑을 반환합니다. 키는 위젯에 제공된 옵션이며 값은 옵션이 변경될 때마다 호출되는 함수입니다.
    • getEventMap 메서드는 위젯이 트리거한 이벤트를 응용 양식 모델에 필요한 이벤트와 매핑합니다. 기본값은 기본 위젯의 표준 HTML 이벤트를 매핑하며, 대체 이벤트가 트리거되는 경우 업데이트해야 합니다.
    • 표시 showDisplayValue 및 편집 그림 절을 showValue 적용하고 재정의하여 대체 동작을 가질 수 있습니다.
    • getCommitValue 메서드는 commit 이벤트가 발생할 때 적응형 양식 프레임워크에서 호출됩니다. 일반적으로 드롭다운, 라디오 단추 및 변경 시 발생하는 확인란 요소를 제외한 종료 이벤트입니다. 자세한 내용은 적응형 양식 표현식을 참조하십시오 .
    • 템플릿 파일은 다양한 방법에 대한 샘플 구현을 제공합니다. 확장되지 않을 메서드를 제거합니다.

클라이언트 라이브러리 만들기

Maven 원형에서 생성된 샘플 프로젝트는 필요한 클라이언트 라이브러리를 자동으로 생성하여 범주가 있는 클라이언트 라이브러리로 래핑합니다 af.customwidgets . 에서 사용할 수 있는 JavaScript 및 CSS 파일은 런타임에 자동으로 af.customwidgets 포함됩니다.

빌드 및 설치

프로젝트를 빌드하려면 셸에서 다음 명령을 실행하여 AEM 서버에 설치해야 하는 CRX 패키지를 생성합니다.
mvn clean install
maven 프로젝트가 POM 파일 내의 원격 저장소를 참조합니다. 이것은 참조용으로만 사용되며 Maven 표준에 따라 저장소 정보가 settings.xml 파일에 캡처됩니다.

적응형 양식 업데이트

적응형 양식 필드에 사용자 정의 모양을 적용하려면:
  1. 편집 모드에서 응용 양식을 엽니다.
  2. 사용자 지정 모양을 적용할 필드의 속성 대화 상자를 엽니다.
  3. 스타일 지정 탭에서 CSS class 속성을 업데이트하여 widget_<widgetName> 형식으로 모양 이름을 추가합니다. 예: widget_numericstepper

샘플:사용자 정의 모양 만들기

이제 예를 들어 숫자 필드가 숫자 스테퍼나 슬라이더로 나타날 수 있도록 사용자 정의 모양을 만들어 보겠습니다. 다음 단계를 수행합니다.
  1. 다음 명령을 실행하여 Maven 원형형을 기반으로 로컬 프로젝트를 만듭니다.
    mvn archetype:generate -DarchetypeRepository=https://repo.adobe.com/nexus/content/groups/public/ -DarchetypeGroupId=com.adobe.aemforms -DarchetypeArtifactId=custom-appearance-archetype -DarchetypeVersion=1.0.4
    다음 매개 변수의 값을 지정하라는 메시지가 표시됩니다.
    이 샘플에 사용된 값은 굵게 ​강조 표시됩니다.
    Define value for property 'groupId': com.adobe.afwidgets
    Define value for property 'artifactId': customWidgets
    Define value for property 'version': 1.0.1-SNAPSHOT
    Define value for property 'package': com.adobe.afwidgets
    Define value for property 'artifactName': customWidgets
    Define value for property 'packageGroup': adobe/customWidgets
    Define value for property 'widgetName': numericStepper
  2. (속성에 대해 customWidgets artifactID 지정된 값) 디렉토리로 이동하여 다음 명령을 실행하여 Eclipse 프로젝트를 생성합니다.
    mvn eclipse:eclipse
  3. Eclipse 도구를 열고 다음을 수행하여 Eclipse 프로젝트를 가져옵니다.
    1. 파일 > 가져오기 > 기존 프로젝트를 작업 공간으로 선택합니다 .
    2. 명령을 실행한 폴더를 찾아 선택합니다. archetype:generate
    3. 마침을 클릭합니다 .
  4. 사용자 정의 모양에 사용할 위젯을 선택합니다. 이 샘플에서는 다음 숫자 스테퍼 위젯을 사용합니다.
    Eclipse 프로젝트에서 파일의 플러그인 코드를 검토하여 plugin.js 파일의 모양에 대한 요구 사항과 일치하는지 확인합니다. 이 샘플에서 모양은 다음 요구 사항을 충족합니다.
    • 숫자 스테퍼는 확장해야 합니다 - $.xfaWidget.numericInput .
    • 위젯의 set value 메서드는 포커스가 필드에 있는 후에 값을 설정합니다. 적응형 양식 위젯은 필수 요구 사항입니다.
    • 메서드를 호출하려면 render 메서드를 재정의해야 bootstrapNumber 합니다.
    • 플러그인의 기본 소스 코드 외에 플러그인에 대한 추가 종속성은 없습니다.
    • 샘플에서는 스테퍼에 대해 스타일이 수행되지 않으므로 추가 CSS가 필요하지 않습니다.
    • $userControl 개체는 render 메서드에 사용할 수 있어야 합니다. 플러그인 코드로 복제되는 text 유형의 필드입니다.
    • 필드를 사용할 수 없을 때 + ​단추를 사용할 수 없도록 설정해야 합니다.
  5. (jQuery 플러그인)의 컨텐츠를 bootstrap-number-input.js 파일의 내용으로 바꿉니다 numericStepper-plugin.js .
  6. 파일에서 다음 코드를 추가하여 렌더링 메서드를 재정의하여 플러그인을 호출하고 numericStepper-widget.js $userControl 개체를 반환합니다.
    render : function() {
         var control = $.xfaWidget.numericInput.prototype.render.apply(this, arguments);
         var $control = $(control);
         var controlObject;
         try{
             if($control){
             $control.bootstrapNumber();
             var id = $control.attr("id");
             controlObject = $("#"+id);
             }
         }catch (exc){
              console.log(exc);
         }
         return controlObject;
    }
    
    
  7. 파일에서 속성을 재정의하여 액세스 옵션을 재정의하고, 비활성화된 모드에서 + 및 - 단추를 숨깁니다. numericStepper-widget.js getOptionsMap
    getOptionsMap: function(){
        var parentOptionsMap = $.xfaWidget.numericInput.prototype.getOptionsMap.apply(this,arguments),
    
        newMap = $.extend({},parentOptionsMap,
    
         {
    
               "access": function(val) {
               switch(val) {
                  case "open" :
                    this.$userControl.removeAttr("readOnly");
                    this.$userControl.removeAttr("aria-readonly");
                    this.$userControl.removeAttr("disabled");
                    this.$userControl.removeAttr("aria-disabled");
                    this.$userControl.parent().find(".input-group-btn button").prop('disabled',false);
                    break;
                  case "nonInteractive" :
                  case "protected" :
                    this.$userControl.attr("disabled", "disabled");
                    this.$userControl.attr("aria-disabled", "true");
                    this.$userControl.parent().find(".input-group-btn button").prop('disabled',true);
                    break;
                 case "readOnly" :
                    this.$userControl.attr("readOnly", "readOnly");
                    this.$userControl.attr("aria-readonly", "true");
                    this.$userControl.parent().find(".input-group-btn button").prop('disabled',true);
                    break;
                default :
                    this.$userControl.removeAttr("disabled");
                    this.$userControl.removeAttr("aria-disabled");
                    this.$userControl.parent().find(".input-group-btn button").prop('disabled',false);
                    break;
              }
           },
       });
       return newMap;
     }
    
    
  8. 변경 내용을 저장하고 파일이 들어 있는 폴더로 이동한 다음 다음 Maven 명령을 실행하여 프로젝트를 빌드합니다. pom.xml
    mvn clean install
  9. AEM Package Manager를 사용하여 패키지를 설치합니다.
  10. 사용자 정의 모양을 적용할 편집 모드에서 응용 양식을 열고 다음을 수행합니다.
    1. 모양을 적용할 필드를 마우스 오른쪽 단추로 클릭하고 편집을 클릭하여 구성 요소 편집 대화 상자를 엽니다.
    2. 스타일 탭에서 CSS 클래스 속성을 업데이트하여 widget_numericStepper 추가합니다.
방금 만든 새 모양을 이제 사용할 수 있습니다.