Show Menu
TOPICS×

이미지 구성 요소

핵심 구성 요소 이미지 구성 요소는 즉석 편집을 제공하는 응용 이미지 구성 요소입니다.

사용량

이미지 구성 요소는 페이지 방문자를 위한 레이지 로딩과 컨텐츠 작성자를 위한 간편한 이미지 배치 및 자르기 기능을 통해 적응형 이미지 선택 및 응답형 동작을 제공합니다.
이미지 폭, 자르기 및 추가 설정은 디자인 대화 상자에서 템플릿 작성자가 정의할 수 있습니다. 컨텐츠 편집기는 구성 대화 상자에서 자산을 업로드하거나 선택하고 편집 대화 상자에서 이미지를 자를 수 있습니다. 또한 편의를 위해 이미지를 직접 간단하게 수정할 수 있습니다.

반응형 기능

이미지 구성 요소는 즉시 사용할 수 있는 강력한 반응형 기능을 제공합니다. 페이지 템플릿 수준에서 디자인 대화 상자를 사용하여 이미지 자산의 기본 너비를 정의할 수 있습니다. 그런 다음 이미지 구성 요소는 브라우저 창의 크기에 따라 표시할 올바른 너비를 자동으로 로드합니다. 창 크기가 변경되면 이미지 구성 요소는 올바른 이미지 크기를 신속하게 로드합니다. 이미지 구성 요소가 이미 컨텐츠를 로드하도록 최적화되었으므로 구성 요소 개발자는 사용자 정의 미디어 쿼리를 정의할 필요가 없습니다.
또한 이미지 구성 요소는 실제 이미지 자산이 브라우저에 표시될 때까지 로드를 연기하여 페이지의 응답성을 높입니다.

버전 및 호환성

이미지 구성 요소의 현재 버전은 v2이며, 이 버전은 2018년 1월 핵심 구성 요소 릴리스 2.0.0에서 도입되었으며 이 문서에 설명되어 있습니다.
다음 표에서는 구성 요소의 지원되는 모든 버전, 구성 요소 버전이 호환되는 AEM 버전 및 이전 버전에 대한 설명서 링크에 대해 자세히 설명합니다.
구성 요소 버전
AEM 6.3
AEM 6.4
AEM 6.5
v2
호환 가능
호환 가능
호환 가능
호환 가능
호환 가능
호환 가능
핵심 구성 요소 버전 및 릴리스에 대한 자세한 내용은 핵심 구성 요소 버전을 참조하십시오 .

SVG 지원

SVG(Scalable Vector Graphics)는 이미지 구성 요소에서 지원합니다.
  • DAM에서 SVG 에셋을 드래그 앤 드롭하고 로컬 파일 시스템에서 SVG 파일 업로드를 업로드할 수 있습니다.
  • 응용 이미지 서블릿은 원본 SVG 파일을 스트리밍합니다(변형을 건너뜁니다).
  • SVG 이미지의 경우 "스마트 이미지" 및 "스마트 크기"가 이미지 모델의 빈 배열로 설정됩니다.

보안

보안상의 이유로 원본 SVG는 이미지 편집기에서 직접 호출되지 않습니다. 전화를
<img src=“path-to-component”>
거셨습니다 이렇게 하면 브라우저가 SVG 파일에 임베드된 스크립트를 실행하지 못합니다.
AEM 내의 새로운 이미지 편집기 기능을 지원하려면 AEM 6.4 또는 AEM 6.3 이상용 서비스 팩 2 서비스 팩 3 와 함께 SVG 지원을 통해 핵심 구성 요소 릴리스 2.1.0 이상이 필요합니다.

샘플 구성 요소 출력

이미지 구성 요소뿐만 아니라 구성 옵션의 예와 HTML 및 JSON 출력을 보려면 구성 요소 라이브러리를 참조하십시오 .

기술 정보

이미지 구성 요소에 대한 최신 기술 문서는 GitHub에서 찾을 수 있습니다 .
핵심 구성 요소 개발에 대한 자세한 내용은 핵심 구성 요소 개발자 설명서를 참조하십시오.
핵심 구성 요소 릴리스 2.1.0부터 이미지 구성 요소는 schema.org microdata 를 지원합니다.

구성 대화 상자

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

자산 탭

  • 이미지 자산
    • 자산 브라우저에서 자산을 삭제하거나 찾아보기 옵션을 눌러 로컬 파일 시스템에서 업로드합니다.
    • 지우기를 탭하거나
      클릭하여
      현재 선택한 이미지를 선택 취소합니다.
    • 편집을 탭하거나
      클릭하여
      자산 편집기에서 자산의 표현물을관리합니다.

메타데이터 탭

  • 이미지가 장식용인지
    ​보조 기술로 이미지를 무시해야 하므로 대체 텍스트가 필요하지 않은지 확인합니다. 이는 장식 이미지에만 적용됩니다.
  • 대체 텍스트이미지
    ​의 의미나 기능에 대한 텍스트 대체 텍스트로서 시각 장애가 있는 독자를 위한 것입니다.
    • DAM에서 대체 텍스트 가져오기 - 이 옵션을 선택하면 이미지의 대체 텍스트가 DAM의
      dc:description
      메타데이터 값으로 채워집니다.
  • 캡션
    ​이미지 아래에 기본적으로 표시되는 이미지에 대한 추가 정보입니다.
    • DAM에서 캡션
      ​가져오기 옵션을 선택하면 이미지의 캡션 텍스트가 DAM의
      dc:title
      메타데이터 값으로 채워집니다.
    • 캡션을 팝업으로
      ​표시캡션을 선택하면 캡션이 이미지 아래에 표시되지 않고 마우스로 이미지를 가리키면 일부 브라우저가 팝업으로 표시합니다.
  • 링크
    • 이미지를 다른 리소스에 연결합니다.
    • 선택 대화 상자를 사용하여 다른 AEM 리소스에 연결합니다.
    • AEM 리소스에 연결되지 않은 경우 절대 URL을 입력합니다. 비솔루션 URL은 AEM을 기준으로 해석됩니다.

Edit Dialog

편집 대화 상자에서는 컨텐츠 작성자가 이미지를 자르고, 론치 맵을 수정하고, 확대/축소할 수 있습니다.
  • 자르기 시작
    이 옵션을 선택하면 사전 정의된 자르기 비율에 대한 드롭다운이 열립니다.
    • # 옵션을
      선택하여
      직접 자르기를 정의합니다.
    • # 옵션을
      선택하여
      원본 자산을 표시합니다. 자르기 옵션을 선택하면 파란색 핸들을 사용하여 이미지의 자르기 크기를 조정합니다.
  • 오른쪽으로 회전
    이미지를 오른쪽(시계 방향)으로 90° 회전하려면 이 옵션을 사용합니다.
  • 가로로 뒤집기
    이 옵션을 사용하여 이미지를 가로로 뒤집거나 이미지를 y축을 따라 180° 회전할 수 있습니다.
  • 세로로 뒤집기
    이 옵션을 사용하여 이미지를 세로로 뒤집거나 이미지를 x축을 따라 180° 회전할 수 있습니다.
  • 론치 맵
    론치 맵 기능을 사용하려면 AEM 6.4용 서비스 팩 2 또는 AEM 6.3 이상의 서비스 팩 3 (AEM 6.3 이상)과 함께 새로운 이미지 편집기 기능을 사용하려면 릴리스 2.1.0 이상이 필요합니다.
    이 옵션을 사용하여 이미지에 론치 맵을 적용합니다. 이 옵션을 선택하면 사용자가 맵의 모양을 선택할 수 있는 새 창이 열립니다.
    • 사각형 맵 추가
    • 원형 맵 추가
    • 다각형 맵 추가
      • 기본적으로 삼각형 맵을 추가합니다. 모양의 선을 두 번 클릭하여 새로운 면에 파란색 크기 조정 핸들을 추가합니다. 맵 모양을 선택하면 이미지 위에 겹쳐져 크기를 조정할 수 있습니다. 파란색 크기 조정 핸들을 드래그하여 놓아 모양을 조정합니다.
    론치 맵의 크기를 조정한 후 아이콘을 클릭하여 부동 도구 모음을 열어 링크의 경로를 정의합니다.
    • 경로
      • 경로 선택 옵션을 사용하여 AEM에서 경로 선택
      • 경로가 AEM에 없으면 절대 URL을 사용합니다. 절대 경로가 아닌 경로는 AEM을 기준으로 해석됩니다.
    • 대체 텍스트경로
      ​대상의 대체 설명
    • 타겟
      • 동일한 탭
      • 새 탭
      • 상위 프레임
      • 상위 프레임
        파란색 확인 표시를 탭하거나 클릭하여 저장하고, 취소할 검은색 x를 누르고, 빨간색 휴지통을 눌러 맵을 삭제합니다.
  • 확대/축소 재설정
    이미지가 이미 확대된 경우 이 옵션을 사용하여 확대/축소 수준을 재설정합니다.
  • 확대/축소 슬라이더 열기
    이 옵션을 사용하여 이미지의 확대/축소 레벨을 제어하는 슬라이더를 표시합니다.
즉석 편집기를 사용하여 이미지를 수정할 수도 있습니다. 공간 제한으로 인해 온라인에서는 기본 옵션만 사용할 수 있습니다. 전체 편집 옵션의 경우 전체 화면 모드를 사용합니다.
이미지 편집 작업(자르기, 뒤집기, 회전)은 GIF 이미지에 대해 지원되지 않습니다. 편집 모드에서 GIF로의 이러한 변경 사항은 지속되지 않습니다.

디자인 대화 상자

템플릿 작성자는 디자인 대화 상자를 사용하여 내용 작성자가 이 구성 요소를 사용할 때 가지고 있는 자르기, 업로드 및 회전을 정의하고 업로드 옵션을 지정할 수 있습니다.

기본 탭

기본
탭에서
이미지의 너비 목록을 픽셀 단위로 정의할 수 있으며 구성 요소는 브라우저 크기를 기준으로 가장 적절한 너비를 자동으로 로드합니다. 이미지 구성 요소의 응답형 기능의 중요한 부분입니다.
또한 작성자가 페이지에 구성 요소를 추가할 때 자동으로 또는 비활성화되는 일반 구성 요소 옵션을 정의할 수 있습니다.
  • 레이지 로딩
    ​활성화페이지에 이미지 구성 요소를 추가할 때 레이지 로딩 옵션이 자동으로 활성화되면 정의합니다.
  • 이미지가 장식용임
    ​이미지 구성 요소를 페이지에 추가할 때 장식 이미지 옵션이 자동으로 활성화되는지 정의합니다.
  • DAM에서 대체 텍스트
    ​가져오기페이지에 이미지 구성 요소를 추가할 때 DAM에서 대체 텍스트를 가져오는 옵션이 자동으로 활성화되는지 정의합니다.
  • DAM에서 캡션
    ​가져오기DAM에서 캡션을 가져오는 옵션이 페이지에 이미지 구성 요소를 추가할 때 자동으로 활성화되는지 여부를 정의합니다.
  • 캡션을 팝업으로
    ​표시이미지 구성 요소를 페이지에 추가할 때 이미지 캡션을 팝업으로 표시하는 옵션이 자동으로 활성화되는지 여부를 정의합니다.
  • UUID 추적
    ​비활성화 이미지 자산의 UUID에 대한 추적을 비활성화하려면 확인을 클릭합니다.
  • 너비
    ​이미지의 너비 목록을 픽셀 단위로 정의하며 구성 요소는 브라우저 크기를 기준으로 가장 적절한 너비를 자동으로 로드합니다.
    • 추가 단추를 누르거나 클릭하여
      다른
      크기를 추가합니다.
      • 그랩 핸들을 사용하여 크기 순서를 다시 정렬합니다.
      • 삭제
        아이콘을 사용하여
        너비를 제거합니다.
    • 기본적으로 이미지 로딩은 표시될 때까지 렌더링됩니다.
      • 페이지 로드
        시 이미지를 로드하려면 레이지 로드
        비활성화 옵션을 선택합니다.
  • JPEG 품질
    ​변형된(예: 크기 조절 또는 잘림) JPEG 이미지의 품질 요소(0 및 100의 백분율)입니다.
JPEG 품질 옵션은 핵심 구성 요소의 릴리스 2.2.0부터 사용할 수 있습니다.
핵심 구성 요소 릴리스 2.2.0부터 이미지 구성 요소는 고유한 UUID 속성을 이미지 자산에 추가하여 개별 자산이 받는 보기 수를 추적하고 분석할 수
data-asset-id
있습니다.

기능 탭

기능
탭에서
업로드 옵션, 방향 및 자르기 옵션을 비롯한 구성 요소를 사용할 때 컨텐츠 작성자가 사용할 수 있는 옵션을 정의할 수 있습니다.
  • 소스
    컨텐츠 작성자가
    로컬 컴퓨터에서 이미지를 업로드할 수 있도록 하려면 파일 시스템에서
    자산 업로드 허용 옵션을 선택합니다. 컨텐츠 작성자가 AEM에서 자산만 선택하도록 하려면 이 옵션을 선택 취소합니다.
  • 방향
  • 회전
    ​이 옵션을 사용하여 컨텐츠 작성자가 오른쪽으로 회전
    옵션을 사용할 수
    있습니다.
  • 뒤집기
    ​이 옵션을 사용하여 컨텐츠 작성자가 ##
    옵션을 사용할 수
    있습니다.
    대칭
    이동
    옵션은 기본적으로 비활성화됩니다. 이 옵션을 활성화하면
    이미지 구성 요소의
    편집 대화 상자에 세로로 뒤집기 및
    가로로 뒤집기
    단추가 표시되지만 현재 AEM에서 이 기능이 지원되지 않으며 이러한 옵션을 사용하여 변경한 내용은 지속되지 않습니다.
  • 자르기
    컨텐츠 작성자가 편집
    대화 상자의 구성 요소에서 이미지를 자를
    수 있도록 하려면 # 옵션을 선택합니다.
    • 추가를
      클릭하여
      사전 정의된 자르기 종횡비를 추가합니다.
    • # 드롭다운에 표시되는 설명 이름을
      입력합니다
      .
    • 종횡비를 입력합니다.
    • 드래그 핸들을 사용하여 종횡비의 순서를 다시 정렬합니다.
    • 종횡비를 삭제하려면 휴지통 아이콘을 사용합니다.
    Note that in AEM, crop aspect ratios are defined as
    height/width
    . 이는 폭/높이의 기존 정의와 다르며 이전 호환성 이유로 수행됩니다. 비율 자체가 아니라 UI에 이름이 표시되므로 비율의 명확한 이름을 제공하는 한 컨텐츠 작성자는 어떠한 차이도 알지 못합니다.

스타일 탭

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

응용 이미지 서블릿

이미지 구성 요소는 핵심 구성 요소의 응용 이미지 서블릿을 사용합니다. 응용 이미지 서블릿은 이미지 처리 및 스트리밍을 담당하고 개발자가 핵심 구성 요소의 사용자 정의에 활용할 수 있습니다 .
헤더를 통한 조건부
Last-Modified
요청은 응용 이미지 서블릿에서 지원되지만
Last-Modified
헤더의 캐싱은 디스패처에서 활성화해야 합니다 .
AEM Project Tranype의 샘플 발송자 구성에는 이미 이 구성이 포함되어 있습니다.