스타일 시스템에 대한 코드 작성 방법 이해 understanding-how-to-code-for-the-aem-style-system

이 비디오에서는 CSS의 구조를 살펴봅니다(또는 LESS) 및 JavaScript를 사용하여 스타일 시스템을 사용하여 Experience Manage의 핵심 제목 구성 요소의 스타일을 지정하고 이러한 스타일을 HTML 및 DOM에 적용하는 방법을 지정할 수 있습니다.

스타일 시스템에 대한 코드 작성 방법 이해 understanding-how-to-code-for-the-style-system

제공된 AEM 패키지(technical-review.sites.style-system-1.0.0.zip)는 예제 제목 스타일, We.Retail 레이아웃 컨테이너 및 제목 구성 요소에 대한 샘플 정책, 샘플 페이지를 설치합니다.

technical-review.sites.style-system-1.0.0.zip

CSS the-css

다음은 LESS 다음 위치에 있는 예제 스타일에 대한 정의:

  • /apps/demo/sites/style-system/clientlib-example/components/titles/styles/example.less

CSS를 선호하는 사용자의 경우 이 코드 조각 아래에 있는 CSS는 다음과 같습니다 LESS 으로 컴파일합니다.

/* LESS */
.cmp-title--example {
 .cmp-title {
  text-align: center;

  .cmp-title__text {
   color: #EB212E;
   font-weight: 600;
   font-size: 5rem;
   border-bottom: solid 1px #ddd;
   padding-bottom: 0;
   margin-bottom: .25rem
  }

  // Last Modified At element injected via JS
  .cmp-title__last-modified-at {
   color: #999;
   font-size: 1.5rem;
   font-style: italic;
   font-weight: 200;
  }
 }
}

위 LESS 는 기본적으로 다음 CSS에 대한 Experience Manager을 통해 컴파일됩니다.

/* CSS */
.cmp-title--example .cmp-title {
 text-align: center;
}

.cmp-title--example .cmp-title .cmp-title__text {
 color: #EB212E;
 font-weight: 600;
 font-size: 5rem;
 border-bottom: solid 1px #ddd;
 padding-bottom: 0;
 margin-bottom: 0.25rem;
}

.cmp-title--example .cmp-title .cmp-title__last-modified-at {
 color: #999;
 font-size: 1.5rem;
 font-style: italic;
 font-weight: 200;
}

JavaScript example-javascript

다음 JavaScript는 예제 스타일이 제목 구성 요소에 적용되면 현재 페이지의 마지막 수정 날짜 및 시간을 수집하여 제목 텍스트 아래에 주입합니다.

jQuery는 사용되는 이름 지정 규칙뿐만 아니라 선택적 사용입니다.

다음은 LESS 다음 위치에 있는 예제 스타일에 대한 정의:

  • /apps/demo/sites/style-system/clientlib-example/components/titles/styles/js/title.js
/**
 * JavaScript supporting Styles may be re-used across multi Component Styles.
 *
 * For example:
 * Many styles may require the Components Image (provided via an <img> element) to be set as the background-image.
 * A single JavaScript function may be used to adjust the DOM for all styles that required this effect.
 *
 * JavaScript must react to the DOMNodeInserted event to handle style-switching in the Page Editor Authoring experience.
 * JavaScript must also run on DOM ready to handle the initial page load rendering (AEM Publish).
 * JavaScript must mark and check for elements as processed to avoid cyclic processing (ie. if the JavaScript inserts a DOM node of its own).
 */
jQuery(function ($) {
    "use strict;"

    moment.locale("en");

    /**
     * Method that injects p element, containing the current pages last modified date/time, under the title text.
     *
     * Similar to the CSS Style application, component HTML elements should be targeted via the BEM class names (as they define the stable API)
     * and targeting "raw" elements (ex. "li", "a") should be avoided.
     */
    function applyComponentStyles() {

        $(".cmp-title--example").not("[data-styles-title-last-modified-processed]").each(function () {
            var title = $(this).attr("data-styles-title-last-modified-processed", true),
                url = Granite.HTTP.getPath() + ".model.json";

            $.getJSON(url, function(data) {
                var dateObject = moment(data['lastModifiedDate']),
                    titleText = title.find('.cmp-title__text');

                titleText.after($("<p>").addClass("cmp-title__last-modified-at").text("Last modified " + dateObject.fromNow()));
            });
        });
    }

    // Handle DOM Ready event
    applyComponentStyles();

    // Apply Styles when a component is inserted into the DOM (ie. during Authoring)
    $(".responsivegrid").bind("DOMNodeInserted", applyComponentStyles);
});

개발 우수 사례 development-best-practices

HTML 우수 사례 html-best-practices

  • HTML(HTL을 통해 생성됨)는 가능한 한 구조적으로 의미 있는 것이어야 합니다. 요소의 불필요한 그룹화/중첩을 피하십시오.
  • HTML 요소는 BEM 스타일 CSS 클래스를 통해 주소 지정할 수 있어야 합니다.

양호 - 구성 요소의 모든 요소는 BEM 표기법을 통해 주소 지정할 수 있습니다.

<!-- Good practice -->
<div class="cmp-list">
    <ul class="cmp-list__item-group">
        <li class="cmp-list__item">...</li>
    </ul>
</div>

나쁨 - 목록 및 목록 요소는 요소 이름으로만 대응 가능합니다.

<!-- Bad practice -->
<div class="cmp-list">
    <ul>
        <li>...</li>
    </ul>
</div>
  • 나중에 백엔드를 개발하여 노출해야 하는 데이터가 너무 적으면 더 많은 데이터를 노출하고 숨기는 것이 좋습니다.

    • 작성자 가능 콘텐츠 전환을 구현하면 이 HTML을 기울이지 않게 하는 데 도움이 될 수 있으며, 이를 통해 작성자는 HTML에 작성되는 콘텐츠 요소를 선택할 수 있습니다. 는 모든 스타일에 사용할 수 없는 HTML에 이미지를 작성할 때 특히 중요할 수 있습니다.

    • CSS에 의해 숨겨진 이벤트 이미지를 불필요하게 가져올 때 값비싼 리소스(예: 이미지)가 기본적으로 노출되는 경우는 이 규칙에서 예외입니다.

      • 최신 이미지 구성 요소는 종종 JavaScript를 사용하여 사용 사례(뷰포트)에 가장 적합한 이미지를 선택하고 로드합니다.

CSS 모범 사례 css-best-practices

NOTE
스타일 시스템은 다음과 같은 기술적인 차이를 만듭니다. BEM, 따라서 BLOCKBLOCK--MODIFIER 은 로 지정된 대로 동일한 요소에 적용되지 않습니다. BEM.
대신 제품 제한으로 인해 BLOCK--MODIFIER 의 부모에 적용됩니다. BLOCK 요소를 생성하지 않습니다.
의 다른 모든 테넌트 BEM 을 정렬해야 합니다.
  • 다음과 같은 전처리기 사용 간단히 (기본적으로 AEM에서 지원) 또는 SCSS (사용자 지정 빌드 시스템 필요) - CSS 정의를 지우고 다시 사용할 수 있도록 허용합니다.

  • 선택기 가중치/특이성을 균일하게 유지합니다. 따라서 식별하기 어려운 CSS 캐스케이드 충돌을 피하고 해결하는 데 도움이 됩니다.

  • 각 스타일을 개별 파일로 구성합니다.

    • 이러한 파일은 LESS/SCSS를 사용하여 결합할 수 있습니다 @imports 또는 HTML 클라이언트 라이브러리 파일 포함 또는 사용자 지정 프론트엔드 에셋 빌드 시스템을 통해 원시 CSS가 필요한 경우.
  • 여러 가지 복잡한 스타일을 혼합하지 마십시오.

    • 한 번에 구성 요소에 적용할 수 있는 스타일이 많을수록 순열의 다양성이 증가합니다. 브랜드 정렬을 유지/QA/보장하기 어려울 수 있습니다.
  • 항상 CSS 클래스(BEM 표기법 준수)를 사용하여 CSS 규칙을 정의합니다.

    • CSS 클래스가 없는 요소(즉, 기본 요소)를 선택해야 하는 경우 CSS 정의에서 해당 요소를 높게 이동하여 선택 가능한 CSS 클래스가 있는 해당 유형의 요소와 충돌하는 것보다 특이도가 낮다는 것을 분명히 하십시오.
  • 스타일을 지정하지 마십시오. BLOCK--MODIFIER 응답형 격자에 첨부된 대로 직접 연결됩니다. 이 요소의 표시를 변경하면 응답형 격자의 렌더링 및 기능에 영향을 줄 수 있으므로 응답형 격자의 동작을 변경하려는 경우 이 수준에서 스타일링만 가능합니다.

  • 다음을 사용하여 스타일 범위 적용 BLOCK--MODIFIER. 다음 BLOCK__ELEMENT--MODIFIERS 구성 요소에서 사용할 수 있지만 그 이유는 BLOCK 는 구성 요소를 나타내며 구성 요소는 스타일이고, 스타일은 "정의"되고, 범위는 BLOCK--MODIFIER.

예제 CSS 선택기 구조는 다음과 같아야 합니다.

첫 번째 수준 선택기

블록 - 수정자

두 번째 수준 선택기

차단

세 번째 수준 선택기

블록__요소

유효 CSS 선택기
.cmp-list - 어둡게
.cmp-list
.cmp-list__item

.cmp-list - 어둡게

.cmp-list

.cmp-list__item {

색상: 파랑;

}

.cmp-image—hero
.cmp-image
.cmp-image__caption

.cmp-image—hero

.cmp-image

.cmp-image__caption {

색상: 빨간색;

}

중첩된 구성 요소의 경우 이러한 중첩된 구성 요소 요소에 대한 CSS 선택기 깊이가 3번째 수준 선택기를 초과합니다. 중첩된 구성 요소에 대해 동일한 패턴을 반복하지만 상위 구성 요소의 범위에 의해 수행됩니다. BLOCK. 즉, 중첩된 구성 요소의 BLOCK 세 번째 수준에서 및 중첩된 구성 요소의 ELEMENT 은 4번째 선택기 수준에 있습니다.

JavaScript 우수 사례 javascript-best-practices

이 섹션에 정의된 우수 사례는 "style-JavaScript" 또는 기능 목적이 아닌 스타일 목적으로 구성 요소를 조작하기 위한 JavaScript와 관련이 있습니다.

  • Style-JavaScript는 신중하게 사용해야 하며 이는 소수의 사용 사례입니다.
  • Style-JavaScript는 주로 CSS의 스타일링을 지원하도록 구성 요소의 DOM을 조작하는 데 사용해야 합니다.
  • 구성 요소가 페이지에 여러 번 표시되는 경우 Javascript 사용을 재평가하고 계산/계산 및 다시 그리기 비용을 이해합니다.
  • 구성 요소가 페이지에 여러 번 나타날 수 있는 경우 비동기적으로(AJAX을 통해) 새 데이터/콘텐츠를 가져오는 경우 Javascript 사용을 다시 평가합니다.
  • 게시 및 작성 경험을 모두 처리합니다.
  • 가능하면 style-Javascript를 다시 사용하십시오.
    • 예를 들어, 구성 요소의 여러 스타일을 사용하여 이미지를 배경 이미지로 옮겨야 하는 경우 style-JavaScript를 한 번 구현하여 여러 스타일에 첨부할 수 있습니다 BLOCK--MODIFIERs.
  • 가능하면 스타일-JavaScript를 기능 JavaScript와 구분합니다.
  • HTL을 통해 HTML에서 이러한 DOM 변경 사항을 직접 표시하는 것과 비교하여 JavaScript의 비용을 평가합니다.
    • style-JavaScript를 사용하는 구성 요소에 서버측 수정이 필요한 경우, JavaScript 조작을 지금 사용할 수 있는지 여부와 구성 요소의 성능 및 지원 가능성에 대한 효과/결과를 평가하십시오.

성능 고려 사항 performance-considerations

  • Style-JavaScript는 가볍고 날씬하게 유지되어야 합니다.
  • 깜박거리고 불필요한 다시 그리기를 방지하기 위해 처음에는 를 통해 구성 요소를 숨깁니다. BLOCK--MODIFIER BLOCK를 클릭하고 JavaScript의 모든 DOM 조작이 완료되면 표시합니다.
  • 스타일 JavaScript 조작의 성능은 DOMReady의 요소에 연결하고 수정하는 기본 jQuery 플러그인과 유사합니다.
  • 요청이 압축되고 CSS 및 JavaScript가 축소되었는지 확인합니다.

추가 리소스 additional-resources

recommendation-more-help
bb44cebf-d964-4e3c-b64e-ce882243fe4d