AMP

amp-img

Description

Substitui a tag img de HTML5.

 
Descrição Uma substituição gerenciada pelo ambiente de execução para a tag img de HTML.
Layouts compatíveis fill, fixed, fixed-height, flex-item, intrinsic, nodisplay, responsive
Exemplos Veja um exemplo de amp-img no site AMP By Example.

Comportamento

O ambiente de execução pode optar por atrasar ou priorizar o carregamento de recursos com base na posição da janela de visualização, nos recursos do sistema, na largura de banda da conexão ou em outros fatores. Assim, os componentes de amp-img permitem que o ambiente de execução gerencie recursos de imagem com eficácia.

Os componentes de amp-img, assim como todos os recursos de AMP buscados externamente, precisam receber um tamanho explícito (como em width/height) com antecedência para que a proporção seja conhecida sem buscar a imagem. O comportamento real do layout é determinado pelo atributo layout.

saiba mais sobre os layouts na especificação Sistema de layout do HTML para AMP (link em inglês) e em Layouts compatíveis.

Exemplo: como exibir uma imagem responsiva

No exemplo a seguir, mostramos uma imagem que responde ao tamanho da janela de visualização configurando layout=responsive. A imagem se estica e encolhe de acordo com a proporção especificada por width e height.

<amp-img alt="A view of the sea"
  src="/static/inline-examples/images/sea.jpg"
  width="900"
  height="675"
  layout="responsive">
</amp-img>
Abrir este trecho no playground

saiba mais sobre páginas AMP responsivas no guia Criar páginas AMP responsivas.

Se o recurso solicitado pelo componente amp-img não for carregado, o espaço ficará em branco, a menos que um fallback filho seja fornecido. Um substituto (fallback) é executado somente no layout inicial. As alterações src subsequentes após o fato (por meio de resize + srcset, por exemplo) não terão um substituto para implicações de desempenho.

Exemplo: especificar uma imagem substituta

No exemplo a seguir, se o navegador não for compatível com WebP, a imagem JPG substituta será exibida:

<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>
Abrir este trecho no playground

Uma cor de segundo plano de marcador ou outro recurso visual pode ser definido usando o seletor e o estilo CSS no próprio elemento.

Outros recursos de imagem, como legendas, podem ser implementados com HTML padrão (por exemplo, figure e figcaption).

saiba mais sobre como utilizar o amp-img:

Atributos

src

Esse atributo é semelhante ao src da tag img. O valor precisa ser um URL que aponte para um arquivo de imagem armazenável em cache publicamente. Provedores de cache podem reescrever esses URLs ao ingerir arquivos AMP para que apontem para uma versão em cache da imagem.

srcset

Igual ao atributo srcset na tag img. Para navegadores não compatíveis com o srcset, o <amp-img> assumirá como padrão o src. Se apenas srcset e src forem fornecidos, o primeiro URL em srcset será selecionado.

sizes

Igual ao atributo sizes da tag img.

consulte Imagens responsivas com os atributos "srcset", "sizes" e "heights" para ver o uso de sizes e srcset.

alt

Uma string de texto alternativo, semelhante ao atributo alt da img.

attribution

Uma string que indica a atribuição da imagem. Por exemplo, attribution="CC courtesy of Cats on Flicker"

height e width

Um tamanho explícito da imagem, que é usado pelo ambiente de tempo de execução de AMP para determinar a proporção sem buscar a imagem.

common attributes

Esse elemento inclui atributos comuns estendidos a componentes de AMP.

Estilo

amp-img pode ser estilizado diretamente por meio das propriedades de CSS. A definição de um marcador de segundo plano cinza, por exemplo, pode ser conseguida com o seguinte código:

amp-img {
  background-color: grey;
  }

Dicas e truques

Dimensionar uma imagem até uma largura máxima

Se você quiser que sua imagem seja dimensionada à medida que a janela for redimensionada, mas até uma largura máxima (para que a imagem não se estenda além da própria largura):

  1. Defina layout=responsive para <amp-img>.
  2. No contêiner da imagem, especifique o atributo CSS max-width:<max width to display image>. Por que no contêiner? Um elemento amp-img com layout=responsive é um elemento de nível de bloco, enquanto <img> é in-line. Outra alternativa é definir display: inline-block no seu CSS para o elemento amp-img.

Diferença entre o layout responsive e o intrinsic

Os layouts responsive e intrinsic criam uma imagem que será dimensionada automaticamente. A principal diferença é que o layout intrinsic usa uma imagem SVG no elemento de dimensionamento. Isso faz com que ele se comporte da mesma forma que uma imagem HTML padrão, mantendo o benefício de o navegador saber o tamanho da imagem no layout inicial. O layout intrinsic terá um tamanho intrínseco e aumentará um div flutuante até que ele chegue ao tamanho natural da imagem ou a uma restrição de CSS, como max-width. O layout responsive renderizará 0x0 em um div flutuante, porque tem o tamanho do pai, que não tem tamanho natural quando flutuante.

Definir uma imagem de tamanho fixo

Se você quiser que sua imagem seja exibida em um tamanho fixo:

  1. Defina layout=fixed para <amp-img>.
  2. Especifique width e height.

saiba mais sobre o layout inferido caso você não especifique o atributo layout.

Definir a proporção

Para imagens responsivas, width e height não precisam corresponder à largura e altura exatas do amp-img. Esses valores só precisam resultar na mesma proporção.

Por exemplo, em vez de especificar width="900" e height="675", você pode simplesmente especificar width="1.33" e 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>
Abrir este trecho no playground

Configurar vários arquivos de origem para diferentes resoluções de tela

O atributo srcset precisa ser usado para fornecer resoluções diferentes da mesma imagem, todas com a mesma proporção. O navegador escolherá automaticamente o arquivo mais apropriado de srcset com base na resolução da tela e na largura do dispositivo do usuário.

Por outro lado, o atributo media mostra ou oculta componentes de AMP e precisa ser usado ao projetar layouts responsivos. A maneira apropriada de exibir imagens com proporções diferentes é usar vários componentes <amp-img>, cada um com um atributo media que corresponda às larguras de tela em que cada instância será mostrada.

Consulte o guia sobre como criar páginas AMP responsivas para ver mais detalhes.

Manter a proporção para imagens com dimensões desconhecidas

O sistema de layout AMP requer a proporção de uma imagem antes de buscar essa imagem. No entanto, em alguns casos, você pode não saber as dimensões dela. Para exibir imagens com dimensões desconhecidas e manter as proporções, combine o layout fill de AMP com a propriedade CSS object-fit. Para ver mais informações, consulte Como oferecer compatibilidade com imagens de dimensões desconhecidas (link em inglês) no site AMP By Example.

Validação

Consulte as regras do amp-img na especificação do validador de AMP.

Precisa de mais ajuda?

Você já leu este documento várias vezes, mas ainda ficou com dúvidas sem respostas? Talvez outras pessoas pensem da mesma forma. Procure entrar em contato com elas no Stack Overflow.

Ir para o Stack Overflow
Encontrou um bug ou sente falta de um recurso?

O projeto AMP incentiva fortemente sua participação e contribuições! Esperamos que você se torne um participante assíduo de nossa comunidade de código aberto, mas também agradecemos contribuições pontuais para problemas que você tenha particular interesse.

Ir para o GitHub