적응형 양식 필드에 대한 사용자 정의 표시 만들기 create-custom-appearances-for-adaptive-form-fields

프로젝트 만들기: AEM에 배포할 콘텐츠 패키지를 생성하는 Maven 프로젝트를 만듭니다.

기존 위젯 클래스 확장: 기존 위젯 클래스를 확장하고 필요한 클래스를 재정의합니다.

클라이언트 라이브러리 만들기: clientLib: af.customwidget 라이브러리를 만들고 필요한 JavaScript 및 CSS 파일을 추가합니다.

프로젝트 빌드 및 설치: Maven 프로젝트를 빌드하고 AEM에 생성된 콘텐츠 패키지를 설치합니다.

적응형 양식을 업데이트하십시오: 사용자 지정 모양을 사용하려면 적응형 양식 필드 속성을 업데이트하십시오.

프로젝트에 서드파티 플러그인 종속성을 포함합니다.

1. 타사 또는 사용자 지정 jQuery 플러그인을 jqueryplugin/javascript 폴더에 배치하고 관련 CSS 파일을 jqueryplugin/css 폴더에 배치합니다. 자세한 내용은 jqueryplugin/javascript and jqueryplugin/css 폴더 아래의 JS 및 CSS 파일을 참조하십시오.

2. jQuery 플러그인의 추가 JavaScript 및 CSS 파일을 포함하도록 js.txt 및 css.txt 파일을 수정하십시오.

서드파티 플러그인을 프레임워크와 통합하여 사용자 지정 모양 프레임워크와 jQuery 플러그인 간의 상호 작용을 가능하게 합니다. 새 위젯은 다음 기능을 확장하거나 재정의한 후에만 작동합니다.

필요에 따라 integration/javascript 폴더에서 JavaScript 파일을 업데이트합니다.

• __widgetName__ 텍스트를 실제 위젯 이름으로 바꾸십시오.

• 적절한 기본 위젯 클래스에서 위젯을 확장합니다. 대개의 경우 기존 위젯이 대체되는 것에 해당하는 위젯 클래스이다. 부모 클래스 이름이 여러 위치에서 사용되므로 파일에서 문자열 xfaWidget.textField의 모든 인스턴스를 검색하고 사용된 실제 부모 클래스로 바꾸는 것이 좋습니다.

• render 메서드를 확장하여 대체 UI를 제공하십시오. UI 또는 상호 작용 동작을 업데이트하기 위해 jQuery 플러그인을 호출하는 위치입니다. render 메서드는 사용자 제어 요소를 반환해야 합니다.

• getOptionsMap 메서드를 확장하여 위젯의 변경으로 인해 영향을 받는 모든 옵션 설정을 재정의합니다. 함수는 옵션 변경 시 수행할 작업에 대한 세부 정보를 제공하는 매핑을 반환합니다. 키는 위젯에 제공되는 옵션이며 값은 옵션의 변경이 감지될 때마다 호출되는 함수입니다.

• getEventMap 메서드는 위젯에 의해 트리거된 이벤트를 적응형 양식 모델에 필요한 이벤트와 매핑합니다. 기본값은 기본 위젯에 대한 표준 HTML 이벤트를 매핑하며 대체 이벤트가 트리거되는 경우 업데이트해야 합니다.

• showDisplayValue 및 showValue은(는) 표시 및 편집 그림 절을 적용하고 대체 동작을 갖도록 재정의할 수 있습니다.

• commit 이벤트가 발생할 때 적응형 양식 프레임워크에서 getCommitValue 메서드를 호출합니다. 일반적으로 종료 이벤트입니다. 단, 드롭다운, 라디오 단추 및 변경 시 발생하는 확인란 요소는 예외입니다. 자세한 내용은 적응형 Forms 표현식을 참조하십시오.

• 템플릿 파일은 다양한 방법에 대한 샘플 구현을 제공합니다. 확장하지 않을 메서드를 제거합니다.

다음 명령을 실행하여 Maven Archetype을 기반으로 로컬 프로젝트를 생성합니다.

mvn archetype:generate -DarchetypeRepository=https://repo1.maven.org/maven2/com/adobe/ -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

customWidgets(artifactID 속성에 대해 지정된 값) 디렉터리로 이동하고 다음 명령을 실행하여 Eclipse 프로젝트를 생성합니다.

mvn eclipse:eclipse

Eclipse 도구를 열고 다음을 수행하여 Eclipse 프로젝트를 가져옵니다.

1. 파일 > 가져오기 > Workspace으로 기존 프로젝트 ​를 선택합니다.

2. archetype:generate 명령을 실행한 폴더를 찾아 선택합니다.

3. 마침 ​을 클릭합니다.

   

사용자 정의 모양새에 사용할 위젯을 선택합니다. 이 샘플은 다음 숫자 스텝퍼 위젯을 사용합니다.

https://www.jqueryscript.net/form/User-Friendly-Number-Input-Spinner-with-jQuery-Bootstrap.html

Eclipse 프로젝트에서 plugin.js 파일의 플러그인 코드를 검토하여 모양 요구 사항과 일치하는지 확인하십시오. 이 샘플에서는 모양이 다음 요구 사항을 충족합니다.

• 숫자 스텝퍼는 - $.xfaWidget.numericInput부터 확장되어야 합니다.

• 위젯의 set value 메서드는 필드에 포커스가 있는 후에 값을 설정합니다. 적응형 양식 위젯에 대한 필수 요구 사항입니다.

• bootstrapNumber 메서드를 호출하려면 render 메서드를 재정의해야 합니다.

• 플러그인의 기본 소스 코드 외에는 플러그인에 대한 추가 종속성이 없습니다.

• 샘플은 스테퍼에서 스타일링을 수행하지 않으므로 추가 CSS가 필요하지 않습니다.

• $userControl 개체는 render 메서드에서 사용할 수 있어야 합니다. 플러그 인 코드로 복제된 text 형식의 필드입니다.

• 필드가 비활성화되어 있으면 + 및 - 단추를 비활성화해야 합니다.

bootstrap-number-input.js(jQuery 플러그인)의 내용을 numericStepper-plugin.js 파일의 내용으로 바꿉니다.

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;
}

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;
 }

변경 내용을 저장하고 pom.xml 파일이 포함된 폴더로 이동한 다음, 다음 Maven 명령을 실행하여 프로젝트를 빌드합니다.

mvn clean install

AEM 패키지 관리자를 사용하여 패키지를 설치합니다.

사용자 정의 모양을 적용할 편집 모드로 적응형 양식을 열고 다음을 수행합니다.

1. 모양을 적용할 필드를 마우스 오른쪽 단추로 클릭하고 편집 ​을 클릭하여 구성 요소 편집 대화 상자를 엽니다.

2. 스타일 탭에서 CSS 클래스 속성을 업데이트하여 widget_numericStepper을(를) 추가합니다.