이미지 구성 요소 (v2) image-component

핵심 구성 요소의 이미지 구성 요소는 바로 편집 기능이 있는 적응형 이미지 구성 요소입니다.

사용량 usage

이미지 구성 요소에는 페이지 방문자의 소극적 로드와 콘텐츠 작성자의 간단한 이미지 배치 및 자르기 옵션이 있는 적응형 이미지 선택 기능과 반응 동작이 포함됩니다.

템플릿 작성자는 디자인 대화 상자에서 이미지 폭과 자르기 및 추가 설정 옵션을 정의할 수 있습니다. 콘텐츠 편집기는 구성 대화 상자에서 에셋을 업로드하거나 선택하고, 편집 대화 상자에서 이미지를 자를 수 있습니다. 편리성을 추가하기 위해 이미지의 간단한 바로 수정 기능을 사용할 수도 있습니다.

버전 및 호환성 version-and-compatibility

이미지 구성 요소는 2018년 1월 핵심 구성 요소 릴리스 2.0.0과 함께 도입된 v2입니다. 이 문서에서는 해당 구성 요소에 대해 설명합니다.

CAUTION
이 문서에서는 이미지 구성 요소 v1에 대해 설명합니다.
현재 버전의 이미지 구성 요소에 대한 자세한 내용은 이미지 구성 요소 문서를 참조하십시오.

반응형 기능 responsive-features

이미지 구성 요소에는 즉시 사용 가능한 강력한 반응형 기능이 제공됩니다. 페이지 템플릿 수준에서 디자인 대화 상자를 사용하여 이미지 자산의 기본 폭을 정의할 수 있습니다. 브라우저 창의 크기에 따라 이미지 구성 요소는 올바른 폭을 자동으로 로드하여 표시합니다. 창의 크기가 조정되면 이미지 구성 요소는 즉시 올바른 이미지 크기를 자동으로 로드합니다. 이미지 구성 요소가 이미 콘텐츠 로드에 최적화되었기 때문에 구성 요소 개발자는 맞춤형 미디어 쿼리를 정의하는 데 걱정할 필요가 없습니다.

또한, 이미지 구성 요소는 소극적 로드를 지원하여 브라우저에 표시될 때까지 실제 이미지 자산 로드를 지연합니다. 이로써 페이지의 응답성이 향상될 수 있습니다.

TIP
이미지 구성 요소는 적응형 이미지 서블릿에 의해 제공됩니다. 작동 방식에 대한 자세한 내용은 적응형 이미지 서블릿 문서를 참조하십시오.

Dynamic Media 지원 dynamic-media

이미지 구성 요소(릴리스 2.13.0부터)는 Dynamic Media 자산을 지원합니다. 활성화되면 다른 이미지에서와 마찬가지로 이 기능의 간단한 드래그 앤 드롭이나 자산 브라우저를 통해 Dynamic Media 이미지 자산을 추가할 수 있습니다. 또한 이미지 수정자, 이미지 사전 설정 및 스마트 자르기를 지원합니다.

핵심 구성 요소가 내장된 웹 경험에는 Sensei에서 지원하는 강력한 고성능 크로스 플랫폼 Dynamic Media 이미지 기능이 포함될 수 없습니다.

SVG 지원 svg-support

이미지 구성 요소는 확장 가능한 벡터 그래픽(SVG)을 지원합니다.

  • DAM에서의 SVG 자산 드래그 앤 드롭과 로컬 파일 시스템에서의 SVG 파일 업로드를 모두 지원합니다.
  • 원본 SVG 파일이 스트리밍됩니다(변환은 건너뜀).
  • SVG 이미지의 경우 “스마트 이미지”와 “스마트 크기”를 이미지 모델에서 빈 배열로 설정합니다.

보안 security

보안상 이유로 이미지 편집기에서 바로 최초 SVG를 호출하지 않습니다. <img src=“path-to-component”>를 통해 호출됩니다. 이렇게 하면 브라우저는 SVG 파일에 임베드된 스크립트를 실행할 수 없습니다.

샘플 구성 요소 출력 sample-component-output

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

기술 세부 사항 technical-details

이미지 구성 요소에 대한 최신 기술 설명서는 GitHub에서 확인할 수 있습니다.

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

이미지 구성 요소는 schema.org microdata를 지원합니다.

구성 대화 상자 configure-dialog

표준 편집 대화 상자디자인 편집 상자 외에도 이미지 구성 요소는 설명 및 기본 속성과 함께 이미지 자체를 정의하는 구성 대화 상자를 제공합니다.

에셋 탭 asset-tab

이미지 구성 요소의 구성 대화 상자 에셋 탭

  • 이미지 에셋

    • 에셋 브라우저에서 에셋을 삭제하거나 검색 옵션을 탭하여 로컬 파일 시스템에서 로드합니다.
    • 지우기 ​를 탭하거나 클릭하여 현재 선택된 이미지 선택을 해제합니다.
    • 편집 ​을 탭하거나 클릭하여 에셋 편집기에서 에셋 렌디션을 관리합니다.

메타데이터 탭 metadata-tab

이미지 구성 요소의 구성 대화 상자 메타데이터 탭

  • 사전 설정 유형 - 이는 사용 가능한 이미지 사전 설정 유형, 이미지 사전 설정 또는 스마트 자르기 중 하나를 정의하고, Dynamic Media 기능이 활성화되는 경우에만 사용할 수 있습니다.

    • 이미지 사전 설정 - 이미지 사전 설정 ​의 사전 설정 유형 ​이 설정되면 사용 가능한 Dynamic Media 사전 설정을 선택하면서 드롭다운 이미지 사전 설정 ​을 사용할 수 있습니다. 선택한 에셋에 대한 사전 설정이 정의되는 경우에만 사용할 수 있습니다.
    • 스마트 자르기 - 스마트 자르기 ​의 사전 설정 유형 ​이 설정되면 선택한 에셋에 대해 사용 가능한 렌디션을 선택하면서 드롭다운 렌디션 ​을 사용할 수 있습니다. 선택한 에셋에 대해 렌디션이 정의되는 경우에만 사용할 수 있습니다.
    • 이미지 수정자 - 사전 설정 유형 선택에 관계없이 명령을 제공하는 추가 Dynamic Media 이미지를 &로 구분하여 정의할 수 있습니다.
  • 장식적 이미지 - 이미지가 보조 기술에서 무시되어 대체 텍스트가 필요한지 확인합니다. 이는 장식적 이미지에만 적용됩니다.

  • 대체 텍스트 - 이미지 의미 또는 기능에 대한 시각 장애인 독자용 대체 텍스트입니다.

    • DAM에서 대체 텍스트 다운로드 - 확인 표시가 되어 있으면 이미지의 대체 텍스트가 DAM의 dc:description 메타데이터 값으로 채워집니다.
  • 캡션 - 기본적으로 이미지에 대한 추가 정보가 이미지 아래에 표시됩니다.

    • DAM에서 캡션 다운로드 - 확인 표시가 되어 있으면 이미지의 캡션 텍스트가 DAM의 dc:title 메타데이터 값으로 채워집니다.
    • 팝업으로 캡션 표시 - 확인 표시가 되어 있으면 캡션은 이미지 아래에 표시되지 않고 마우스로 이미지를 가리키면 일부 브라우저에서 팝업으로 표시됩니다.
  • 링크 - 이미지를 다른 리소스에 연결합니다.

    • 선택 대화 상자를 통해 다른 AEM 리소스에 연결합니다.
    • AEM 리소스에 연결되지 않은 경우 절대 URL을 입력합니다. 절대 URL이 아닌 URL은 AEM의 상대 URL로 해석됩니다.
  • ID - 이 옵션을 통해 HTML과 데이터 레이어에서 구성 요소의 고유 식별자를 제어할 수 있습니다.

    • 비워 두면 고유 ID는 자동으로 생성되고 결과 페이지 검사를 통해 발견될 수 있습니다.
    • ID가 지정된 경우 작성자는 ID가 고유한지 확인해야 합니다.
    • ID가 변경되면 CSS, JS 및 데이터 레이어 추적에 영향을 미칠 수 있습니다.
TIP
스마트 자르기 ​와 이미지 사전 설정 ​은 함께 수행할 수 없는 옵션입니다. 작성자가 스마트 자르기 렌디션과 함께 이미지 사전 설정을 사용해야 한다면 이미지 수정자 ​를 사용해야 합니다.

편집 대화 상자 edit-dialog

콘텐츠 작성자는 편집 대화 상자를 통해 실행 맵을 자르고 수정하고, 이미지를 확대/축소할 수 있습니다.

NOTE
자르기, 회전 및 확대/축소 기능은 Dynamic Media 에셋에 적용되지 않습니다. Dynamic Media 기능이 활성화되면 구성 편집 상자를 통해 Dynamic Media 에셋을 편집해야 합니다.

이미지 구성 요소의 편집 대화 상자

  • 자르기 시작

    자르기 시작 아이콘

    이 옵션을 선택하면 자르기 비율을 사전 정의하는 드롭다운이 열립니다.

    • 프리 핸드 옵션을 선택하여 자체 자르기를 정의합니다.
    • 자르기 제거 옵션을 선택하면 원본 에셋이 표시됩니다.

    자르기 옵션이 선택되면 파란색 핸들이 사용하여 이미지에서 자르기 크기를 조정합니다.

    자르기 옵션

  • 오른쪽 회전

    오른쪽 회전 아이콘

    이 옵션을 사용하여 오른쪽으로(시계 방향으로) 이미지를 90° 회전합니다.

  • 가로 뒤집기

    가로 뒤집기 아이콘

    이 옵션을 사용하여 이미지를 가로로 뒤집거나 y축을 따라 이미지를 180° 피벗합니다.

  • 세로 뒤집기

    세로 뒤집기 아이콘

    이 옵션을 사용하여 이미지를 세로로 뒤집거나 y축을 따라 이미지를 180° 피벗합니다.

  • 확대/축소 재설정

    확대/축소 재설정 아이콘

    이미지가 이미 확대/축소되었다면 이 옵션을 사용하여 확대/축소 레벨을 재설정합니다.

  • 확대/축소 슬라이더 열기

    확대/축소 슬라이더 아이콘

    이 옵션을 사용하여 이미지의 확대/축소 레벨을 제어하는 슬라이더를 표시합니다.

    확대/축소 슬라이더 컨트롤

바로 편집 기능을 가진 편집기를 사용하여 이미지를 수정합니다. 공간 제약으로 인라인에서는 기본 옵션만 제공됩니다. 전체 편집 옵션의 경우 전체 화면 모드를 사용합니다.

이미지 바로 편집 기능 옵션

NOTE
GIF 이미지의 경우 이미지 편집 작업(자르기, 뒤집기, 회전)이 지원되지 않습니다. 편집 모드에 변경 사항이 발생하면 지속되지 않습니다.

디자인 대화 상자 design-dialog

템플릿 작성자는 디자인 대화 상자를 통해 구성 요소 사용 시 필요한 자르기 업로드 및 회전과 업로드 옵션을 정의할 수 있습니다.

메인 탭 main-tab

메인 탭에서 이미지에 대해 허용된 폭 목록을 픽셀 단위로 정의하면 구성 요소는 브라우저 크기에 따라 가장 적절한 폭을 자동으로 로드합니다. 이는 이미지 구성 요소 반응형 기능의 주요 부분입니다.

또한, 작성자가 페이지에 구성 요소를 추가할 때 자동으로 비활성화되는 일반 구성 요소 옵션을 정의할 수 있습니다.

이미지 구성 요소의 디자인 대화 상자 메인 탭

  • DM 기능 활성화 - 확인 표시가 되어 있으면 Dynamic Media 기능이 제공됩니다.

  • 웹 최적화 이미지 활성화 - 선택하면 웹에 최적화된 이미지 게재 서비스는 WebP 형식으로 이미지를 전달하여 이미지 크기를 평균 25% 줄일 수 있습니다.

    • 이 옵션은 AEMaaCS에서만 사용할 수 있습니다.
    • 선택하지 않거나 웹 최적화된 이미지 게재 서비스를 사용할 수 없는 경우 적응형 이미지 서블릿이 사용됩니다.
  • 소극적 로드 활성화 - 페이지에 이미지 구성 요소를 추가할 때 소극적 로드 옵션이 자동으로 활성화되면 정의합니다.

  • 장식적 이미지 - 페이지에 이미지 구성 요소를 추가할 때 장식적 이미지 옵션이 자동으로 활성화되면 정의합니다.

  • DAM에서 그림 설명 다운로드 - 페이지에 이미지 구성 요소를 추가할 때 DAM에서 그림 설명을 검색하는 옵션이 자동으로 활성화되면 정의합니다.

  • DAM에서 캡션 다운로드 - 페이지에 이미지 구성 요소를 추가할 때 DAM에서 캡션을 검색하는 옵션이 자동으로 활성화되면 정의합니다.

  • 팝업으로 캡션 표 - 페이지에 이미지 구성 요소를 추가할 때 팝업으로 이미지 캡션을 표시하는 옵션이 자동으로 활성화되면 정의합니다.

  • UUID 추적 비활성화 - 이미지 에셋의 UUID 추적 비활성화를 확인합니다.

  • 이미지에 대해 폭 목록을 픽셀 단위로 정의하면 구성 요소는 브라우저 크기에 따라 가장 적절한 폭을 자동으로 로드합니다.

    • 추가 버튼을 탭하거나 클릭하여 다른 크기를 추가합니다.

      • 그랩 핸들을 사용하여 크기의 순서를 재배열합니다.
      • 삭제 아이콘을 사용하여 폭을 삭제합니다.
    • 기본적으로 이미지가 표시될 때까지 이미지 로드를 연기합니다.

      • 소극적 로드 활성화 옵션을 사용하여 페이지 로드에서 이미지를 로드합니다.
  • JPEG 품질 - 변환된(예: 크기 조정된 또는 잘린) JPEG 이미지의 품질 인수(0~100 사이의 백분율)입니다

TIP
폭을 정의함으로써 렌디션 선택을 최적화하기 위한 팁과 관련된 자세한 내용은 적응형 이미지 서블릿 섹션을 참조하십시오.

기능 탭 features-tab

기능 탭에서 업로드 옵션, 방향 및 자르기 옵션을 사용할 때 콘텐츠 작성자가 사용할 수 있는 옵션을 정의할 수 있습니다.

  • 소스

    이미지 구성 요소의 디자인 대화 상자 기능 탭

    파일 시스템에서 에셋 업로드 허용 옵션을 선택하여 콘텐츠 작성자는 자신의 컴퓨터에서 이미지를 업로드할 수 있습니다. 콘텐츠 작성자가 AEM에서 에셋만 강제 선택하려면 이 옵션 선택을 해제합니다.

  • 방향

    이미지 구성 요소의 디자인 대화 상자 기능 탭

  • 회전
    이 옵션을 사용하여 콘텐츠 작성자는 오른쪽 회전 옵션을 사용할 수 있습니다.

  • 뒤집기
    이 옵션을 사용하여 콘텐츠 작성자는 가로 뒤집기세로 뒤집기 옵션을 사용할 수 있습니다.

    note caution
    CAUTION
    뒤집기 옵션은 기본적으로 비활성화되어 있습니다. 옵션이 활성화되면 이미지 구성 요소의 편집 대화 상자에 가로 뒤집기 ​와 세로 뒤집기 버튼이 표시됩니다. 하지만 AEM에서는 현재 기능을 지원하지 않으며 이 옵션 사용으로 변경 사항이 발생하면 지속되지 않습니다.
  • 자르기

    이미지 구성 요소의 디자인 대화 상자 기능 탭

    자르기 허용 옵션을 선택하여 콘텐츠 작성자는 편집 대화 상자의 구성 요소에 있는 이미지를 자를 수 있습니다.

    • 추가 ​를 클릭하여 사전 정의된 자르기 종횡비를 추가합니다.
    • 자르기 시작 드롭다운에 표시된 설명하는 이름을 입력합니다.
    • 숫자로 된 종횡비를 입력합니다.
    • 드래그 핸들을 사용하여 종횡비의 순서를 재배열합니다.
    • 휴지통을 사용하여 종횡비를 삭제합니다.
    note caution
    CAUTION
    AEM에서 자르기 종횡비는 높이/폭 ​으로 정의됩니다. 이는 종래의 폭/높이 정의와 다르며, 레거시 호환성을 위해 수행됩니다. 종횡비 이름이 UI에 명확하게 표시되고 종횡비 자체가 아니기 때문에 이름이 제공되어도 콘텐츠 작성자는 차이를 알 수 없습니다.

스타일 탭 styles-tab-1

이미지 구성 요소는 AEM 스타일 시스템을 지원합니다.

Adobe 클라이언트 데이터 레이어 data-layer

이미지 구성 요소는 Adobe 클라이언트 데이터 레이어를 지원합니다.

recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c