{"id":41072,"date":"2023-10-25T17:54:54","date_gmt":"2023-10-25T20:54:54","guid":{"rendered":"\/tutoriais\/?p=41072"},"modified":"2023-10-25T17:54:57","modified_gmt":"2023-10-25T20:54:57","slug":"wp_get_attachment_image","status":"publish","type":"post","link":"\/pt\/tutoriais\/wp_get_attachment_image","title":{"rendered":"Como usar a fun\u00e7\u00e3o wp_get_attachment_image no WordPress + exemplos \u00fateis"},"content":{"rendered":"

A wp_get_attachment_image<\/strong> é uma função do WordPress que permite recuperar e exibir facilmente anexos de imagem com base em seus IDs.<\/p>

Não importa se você está construindo um tema personalizado ou um plugin, essa função oferece uma maneira flexível de exibir imagens com tamanhos e atributos personalizados.<\/p>

Neste tutorial, vamos abordar a função wp_get_attachment_image()<\/strong> e explicar seus parâmetros. Nós também vamos mostrar alguns casos de uso populares que você pode testar em seu site hospedado no WordPress.<\/p>

\n\n\n\n\n\n\n\n\n<\/p>

Parâmetros da Função wp_get_attachment_image<\/h2>

A função wp_get_attachment_image()<\/a> (link em inglês) permite que os usuários recuperem um elemento HTML do tipo img<\/strong> para um anexo de imagem.<\/p>

wp_get_attachment_image( int $attachment_id, string|int[] $size = 'medium', bool $icon = false, string|array $attr = '' );<\/pre>
Por padrão, a função wp_get_attachment_image()<\/strong> requer pelo menos um parâmetro, o ID do anexo. Ele serve como um identificador único para a imagem. A função então exibe a imagem em tamanho completo sem atributos HTML adicionais ou qualquer personalização.<\/p>
Além disso, você pode incluir vários parâmetros adicionais para personalizar a saída da imagem, como o tamanho da imagem, a classe CSS, ou o texto alternativo:<\/p>
$attachment_id<\/strong><\/p>
É necessário especificar o ID da imagem anexada que será exibida. Se o parâmetro estiver vazio ou definido como falso<\/strong>, a função não retornará nenhuma imagem.<\/p>
$size<\/strong><\/p>
Um parâmetro opcional que define o tamanho da imagem que o WordPress<\/a> vai exibir. Você pode especificar qualquer rótulo de tamanho de imagem registrado, por exemplo, miniatura<\/strong>, média<\/strong>, grande<\/strong>, ou um tamanho personalizado em pixels.<\/p>
$icon<\/strong><\/p>
Outro parâmetro opcional que determina se a imagem deve ser tratada como um ícone. Se for configurado para true<\/strong> (verdadeiro), a função exibirá o ícone de anexo em vez da imagem real.<\/p>
$attr<\/strong><\/p>
Este parâmetro permite que você adicione mais atributos à tag de imagem, como uma classe ou um estilo. Você pode passar uma matriz de pares de key-value (chave-valor) para adicionar os seguintes atributos:<\/p>