사용자 지정 적응형 양식 테마 만들기

전제 조건

• LESS(Leaner CSS) 프레임워크에 대한 지식
• Adobe Experience Manager에서 클라이언트 라이브러리를 만드는 방법
• 만든 테마를 사용하기 위한 적응형 양식 템플릿 만들기

적응형 양식 테마

적응형 양식 테마​는 적응형 양식의 스타일(모양 및 느낌)을 정의하는 데 사용하는 AEM 클라이언트 라이브러리입니다.

적응형 템플릿​을 만들고 테마를 템플릿에 적용합니다. 그런 다음 이 사용자 지정 템플릿을 사용하여 적응형 양식​을 만듭니다.

적응형 양식 테마를 만들려면

스냅샷 그림: 포리스트 테마 샘플

1. /apps노드 아래에 cq:ClientLibraryFolder 유형의 노드를 만듭니다.

   예를 들어 다음 노드를 만듭니다.

   /apps/myAfThemes/forestTheme

2. 여러 값을 갖는 문자열 속성 categories을 노드에 추가하고 해당 값을 적절하게 설정합니다.

   예를 들어 속성을 다음과 같이 설정합니다.af.theme.forest

   

3. 1단계에서 만든 노드에 less 및 css 폴더와 css.txt 파일을 추가합니다.

   • less 폴더:변수를 less 정의하고 .css 스타일을 관리하는 less 데 less mixins 사용되는 변수 파일을 포함합니다.

     이 폴더는 less 변수 파일, less mixin 파일, less mixin 및 변수를 사용하여 스타일을 정의하는 파일로 구성됩니다. 그리고 이러한 적은 파일은 모두 style.less로 가져옵니다.

   • css폴더:테마에 사용할 정적 스타일을 정의하는 .css 파일을 포함합니다.

   적은 변수 파일:CSS 스타일을 정의하는 데 사용되는 변수를 정의하거나 재정의하는 파일입니다.

   적응형 양식은 다음 .less 파일에 정의된 OOTB 변수를 제공합니다.

   • /apps/clientlibs/fd/af/guidetheme/common/less/globalvariables.less
   • /apps/clientlibs/fd/af/guidetheme/common/less/layoutvariables.less

   적응형 양식은 다음에 정의된 타사 변수를 제공합니다.

   /apps/clientlibs/fd/af/third-party/less/variables.less

   적응형 양식에 제공된 변수를 적게 사용하거나, 이러한 변수를 재정의하거나, 새로운 변수를 덜 만들 수 있습니다.

   노트

   덜 적은 사전 프로세서의 파일을 가져오는 동안 가져오기 문에서 파일의 상대 경로를 지정합니다.

   변수 대체 샘플:

   @button-background-color: rgb(19, 102, 44);
   @button-border-color: rgb(19, 102, 44);
   @button-border-size: 0px;
   @button-padding: 10px 15px;
   @button-font-color: #ffffff;
   

   less변수를 재정의하려면

   1. 기본 적응형 양식 변수 가져오기:

      /apps/clientlibs/fd/af/guidetheme/common/less/globalvariables.less/apps/clientlibs/fd/af/guidetheme/common/less/layoutvariables.less

   2. 그런 다음 재정의된 변수를 포함하는 파일을 적게 가져옵니다.

   샘플 새 변수 정의:

   @button-focus-bg-color: rgb(40, 208, 90);
   @button-hover-bg-color: rgb(30, 156, 67);
   

   작은 혼합 파일: 변수를 인수로 허용하는 함수를 정의할 수 있습니다. 이러한 함수의 결과는 결과 스타일입니다. CSS 스타일을 반복하지 않으려면 다른 스타일 내에서 이러한 mixin을 사용하십시오.

   적응형 양식은 에 정의된 OOTB 믹싱을 제공합니다.

   • /apps/clientlibs/fd/af/guidetheme/common/less/adaptiveforms-mixins.less

   적응형 양식은 다음에 정의된 타사 Mixin도 제공합니다.

   • /apps/clientlibs/fd/af/third-party/less/mixins.less

   샘플 혼합 정의:

   .rounded-corners (@radius) {
     -webkit-border-radius: @radius;
     -moz-border-radius: @radius;
     -ms-border-radius: @radius;
     -o-border-radius: @radius;
     border-radius: @radius;
   }
   
   .border(@color, @type, @size) {
      border: @color @size @type;
   }
   

   Style.less 파일: 이 파일을 사용하여 클라이언트 라이브러리에서 사용해야 하는 모든 파일(변수, mixin, 스타일)을 포함합니다.

   다음 샘플 styles.less 파일에서 import 문을 임의의 순서로 배치할 수 있습니다.

   다음 .less 파일을 가져올 문은 필수입니다.

   • globalvariables.less
   • layoutvariables.less
   • components.less
   • layouts.less

   @import "../../../clientlibs/fd/af/guidetheme/common/less/globalvariables.less";
   @import "../../../clientlibs/fd/af/guidetheme/common/less/layoutvariables.less";
   @import "forestTheme-variables";
   @import "../../../clientlibs/fd/af/guidetheme/common/less/components.less";
   @import "../../../clientlibs/fd/af/guidetheme/common/less/layouts.less";
   
   /* custom styles */
   
   .guidetoolbar {
     input[type="button"], button, .button {
       .rounded-corners (@button-radius);
       &:hover {
         background-color: @button-hover-bg-color;
       }
       &:focus {
         background-color: @button-focus-bg-color;
       }
     }
   }
   
   form {
       background-image: url(../images/forest.png);
    background-repeat: no-repeat;
    background-size: 100%;
   }
   

   css.txt에는 라이브러리에 대해 다운로드할 .css 파일의 경로가 포함되어 있습니다.

   예:

   #base=/apps/clientlibs/fd/af/third-party/css
   bootstrap.css
   
   #base=less
   styles.less
   
   #base=/apps/clientlibs/fd/xfaforms/xfalib/css
   datepicker.css
   listboxwidget.css
   scribble.css
   dialog.css
   

   노트

   style.less 파일은 필수가 아닙니다. 즉, 사용자 지정 스타일, 변수 또는 mixin을 정의하지 않은 경우에는 이 파일을 만들 필요가 없습니다.

   그러나 style.less 파일을 만들지 않는 경우 css.txt 파일에서 다음 줄의 주석을 해제해야 합니다.

   #base=less

   그리고 다음 줄에 주석을 답니다.

   styles.less

적응형 양식에서 테마를 사용하려면

적응형 양식 테마를 만든 후 다음 단계를 수행하여 이 테마를 적응형 양식으로 사용합니다.

1. 에서 만든 테마를 포함하여 적응형 양식 테마 섹션을 만들려면 cq:Component 유형의 사용자 지정 페이지를 만드십시오.

   예, /apps/myAfCustomizations/myAfPages/forestPage

   1. sling:resourceSuperType 속성을 추가하고 해당 값을 fd/af/components/page/base 로 설정합니다.

      

   2. 페이지에서 테마를 사용하려면 override file library.jsp를 노드에 추가해야 합니다.

      그런 다음 이 문서의 적응형 양식 테마 섹션을 만들려면

      다음 샘플 코드 조각은 af.theme.forest 테마를 가져옵니다.

      <%@include file="/libs/fd/af/components/guidesglobal.jsp"%>
      <cq:includeClientLib categories="af.theme.forest"/>
      

   3. 선택 사항:사용자 지정 페이지에서 필요에 따라 header.jsp, footer.jsp 및 body.jsp를 재정의합니다.

2. 사용자 지정 템플릿을 만듭니다(예:jcr:content가 이전 단계에서 만든 사용자 지정 페이지를 가리키는 /apps/myAfCustomizations/myAfTemplates/forestTemplate)(예:myAfCustomizations/myAfPages/forestPage).

   

3. 이전 단계에서 만든 템플릿을 사용하여 적응형 양식을 만듭니다. 적응형 양식의 모양과 느낌은 이 문서의 적응형 양식 테마 섹션을 만들려면