AMP

amp-img

Description

Replaces the HTML5 img tag.

 
설명 HTML img 태그의 런타임 관리 대체입니다.
지원되는 레이아웃 fill, fixed, fixed-height, flex-item, intrinsic, nodisplay, responsive
AMP By Example의 amp-img 예를 참조하세요.

동작

런타임에서 표시 영역 위치, 시스템 리소스, 연결, 대역폭 또는 기타 요인을 기반으로 리소스 로드를 지연하거나 우선순위를 지정하도록 선택할 수 있습니다. amp-img 구성요소를 사용하면 런타임에서 이미지 리소스를 이와 같이 효율적으로 관리할 수 있습니다.

이미지를 가져오지 않고도 가로세로 비율을 알 수 있도록, 외부에서 가져온 모든 AMP 리소스와 같은 amp-img 구성요소에는 명시적으로 미리 크기를 지정해야 합니다(width/height 사용). 실제 레이아웃 동작은 layout 속성에 따라 결정됩니다.

AMP HTML 레이아웃 시스템 사양과 지원되는 레이아웃에서 레이아웃에 관해 자세히 알아보세요.

예: 반응형 이미지 표시

다음 예에서는 layout=responsive를 설정하여 표시 영역의 크기에 반응하는 이미지를 표시합니다. widthheight로 지정된 가로세로 비율에 따라 이미지가 확장되고 줄어듭니다.

<amp-img alt="A view of the sea"
  src="/static/inline-examples/images/sea.jpg"
  width="900"
  height="675"
  layout="responsive">
</amp-img>
이 코드 조각을 Playground에서 열기

반응형 AMP 페이지 만들기 가이드에서 반응형 AMP 페이지에 관해 알아보세요.

amp-img 구성요소에서 요청한 리소스를 로드하지 못하면, fallback 하위 요소를 제공하지 않은 경우 공간이 비게 됩니다. 대체(예: 크기 조정 + srcset를 통한) 사실이 성능에 영향을 미치지 않는 한 초기 레이아웃과 후속 src 변경에서만 대체가 실행됩니다.

예: 대체 이미지 지정

다음 예에서 브라우저가 WebP를 지원하지 않는 경우 대체 JPG 이미지가 표시됩니다.

<amp-img alt="Mountains"
  width="550"
  height="368"
  src="/static/inline-examples/images/mountains.webp">
  <amp-img alt="Mountains"
    fallback
    width="550"
    height="368"
    src="/static/inline-examples/images/mountains.jpg"></amp-img>
</amp-img>
이 코드 조각을 Playground에서 열기

자리표시자 배경색 또는 기타 시각적 요소 자체에서 CSS 선택기와 스타일을 사용하여 설정할 수 있습니다.

자막과 같은 추가 이미지 기능은 표준 HTML(예: figurefigcaption)을 사용하여 구현할 수 있습니다.

다음 리소스에서 amp-img 사용에 관해 자세히 알아보세요.

속성

src

이 속성은 img 태그의 src 속성과 비슷합니다. 이 값은 공개적으로 캐시 가능한 이미지 파일을 가리키는 URL이어야 합니다. 이미지의 캐싱된 버전을 가리키도록 AMP 파일을 처리할 때 캐시 공급자가 이 URL을 다시 쓸 수 있습니다.

srcset

img 태그의 srcset 속성과 같습니다. srcset을 지원하지 않는 브라우저의 경우 <amp-img>가 기본적으로 src를 사용합니다. srcset만 제공되고 src는 제공되지 않는 경우 srcset의 첫 번째 url만 선택합니다.

sizes

img 태그의 sizes 속성과 같습니다.

sizessrcset 사용은 srcset, sizes 및 heights를 사용하는 반응형 이미지를 참조하세요.

alt

imgalt 속성과 비슷한 대체 텍스트 문자열입니다.

attribution

이미지의 기여 분석을 나타내는 문자열입니다. 예를 들어 attribution="CC courtesy of Cats on Flicker"입니다.

heightwidth

이미지를 가져오지 않고 가로세로 비율을 판별하기 위해 AMP 런타임에서 사용하는 이미지의 명시적 크기입니다.

공통 속성

이 요소에는 AMP 구성요소로 확장된 공통 속성이 포함됩니다.

스타일 지정

amp-img는 CSS 속성을 통해 직접 스타일을 지정할 수 있습니다. 예를 들어 다음을 통해 회색의 백그라운드 자리표시자를 사용할 수 있습니다.

amp-img {
  background-color: grey;
  }

도움말 및 유용한 정보

이미지를 최대 너비까지 확장

창의 크기가 조정됨에 따라 이미지의 크기를 조정하지만 이미지가 자체 너비 이상으로 확장되지 않도록 최대 너비까지만 조정하려는 경우 다음을 시행합니다.

  1. <amp-img>layout=responsive를 설정합니다.
  2. 이미지의 컨테이너에서 max-width:<max width to display image> CSS 속성을 지정합니다. 왜 컨테이너에서 지정해야 할까요? layout=responsive가 있는 amp-img 요소는 블록 수준 요소입니다. 여기서 <img>인라인입니다*. 또는 CSS에서 amp-img 요소의 display: inline-block을 설정할 수 있습니다.

반응형 레이아웃과 내장형 레이아웃 사이의 차이점

responsiveintrinsic 레이아웃에서는 자동으로 크기가 조정되는 이미지를 만듭니다. intrinsic 레이아웃에서는 SVG 이미지를 크기 조정 요소로 사용한다는 주된 차이점이 있습니다. 따라서 표준 HTML 이미지와 동일한 방식으로 작동하며 브라우저에서 초기 레이아웃의 이미지 크기를 알 수 있다는 이점이 유지됩니다. intrinsic 레이아웃에는 고유 크기가 있으며 기본 이미지 크기 또는 max-width와 같은 CSS 제한조건에 도달할 때까지 플로팅 div로 확장됩니다. responsive 레이아웃은 플로팅될 때 기본 크기가 지정되지 않는 상위 요소로부터 크기를 가져오므로 플로팅된 div에서 0 x 0으로 렌더링됩니다.

고정 크기 이미지 설정

이미지를 고정 크기로 표시하려는 경우 다음을 시행하세요.

  1. <amp-img>layout=fixed를 설정합니다.
  2. widthheight를 지정합니다.

layout 속성을 지정하지 않는 경우 유추된 레이아웃에 관해 알아보세요.

가로세로 비율 설정

반응형 이미지의 경우 widthheightamp-img의 너비 및 높이와 정확히 일치하지 않아도 됩니다. 해당 값의 가로세로 비율이 같기만 하면 됩니다.

예를 들어 width="900"height="675"를 지정하지 않고 width="1.33"height="1"을 지정할 수 있습니다.

<amp-img alt="A view of the sea"
  src="/static/inline-examples/images/sea.jpg"
  width="1.33"
  height="1"
  layout="responsive">
</amp-img>
이 코드 조각을 Playground에서 열기

여러 다른 화면 해상도에 맞게 여러 소스 파일 설정

같은 이미지에 대해 가로세로 비율이 모두 동일한 여러 다른 해상도를 제공하기 위해 srcset 속성을 사용해야 합니다. 브라우저에서 사용자 기기의 화면 해상도와 너비를 기반으로 srcset에서 가장 적합한 파일을 자동으로 선택합니다.

대조적으로 media 속성에서는 AMP 구성요소를 표시하거나 숨기므로 반응형 레이아웃을 디자인할 때 사용해야 합니다. 가로세로 비율이 서로 다른 이미지를 표시하려면 여러 <amp-img> 구성요소를 사용하는 것이 적합합니다. 이때 각 구성요소에서는 각 인스턴스를 표시할 화면 너비에 맞는 media 속성을 사용합니다.

자세한 내용은 반응형 AMP 페이지 만들기의 가이드를 참조하세요.

크기를 알 수 없는 이미지의 가로세로 비율 유지

AMP 레이아웃 시스템에서 이미지를 가져오기 전에 이미지의 가로세로 비율을 미리 알고 있어야 합니다. 그러나 경우에 따라 이미지의 크기를 알지 못할 수 있습니다. 크기를 알 수 없는 이미지를 표시하고 가로세로 비율을 유지하려면 AMP의 fill 레이아웃을 object-fit CSS 속성과 결합합니다. 자세한 정보는 AMP By Example의 크기를 알 수 없는 이미지 지원 방법을 참조하세요.

유효성 검사

AMP 유효성 검사기 사양에서 amp-img rules를 참조하세요.

도움이 더 필요하신가요?

이 문서를 수십 번 읽었음에도 여전히 궁금한 점이 남아 있나요? 다른 개발자들도 같은 심정일지 모릅니다. Stack Overflow에서 소통해 보세요.

Stack Overflow로 이동
버그나 누락된 기능을 발견하셨나요?

AMP 프로젝트는 여러분의 참여와 기여를 적극 환영합니다! 오픈 소스 커뮤니티를 통해 지속적으로 활동해 주셔도 좋지만 관심 있는 주제에 한 번만 기여하셔도 큰 도움이 됩니다.

GitHub로 이동하기