Pular para o conteúdo principal

get_featured_image()

Retorna a imagem destacada da postagem atual com atributos e valores padrões e personalizáveis.

Parâmetros:
$args array (opcional)

Argumentos disponíveis:
  • 'scope' string → Tamanho da imagem. Padrão: 'larger'
    Valores padrões (se não desabilitado):
    • 'wide'
    • 'larger'
    • 'minor'
    • 'thumbnail'
    • 'system'
  • Atributos HTML
    • 'alt' string → Texto alternativo
    • 'loading' string|bool 'lazy'|true → Carregamento tardio
    • 'class' string → Classe(s) CSS para a imagem
    • 'title' string → Atributo title da imagem

Retorno: string
Tag HTML <img> completa com atributos.

Exemplo de uso:

while( row_exists() ) : 
    
    show_row();

    $image_url = get_featured_image([
        'scope'   => 'minor',
        'alt'     => get_title(),
        'class'   => 'thumb',
        'loading' => 'lazy', // ou true
        'title'   => get_title()
    ]);
    
    echo $image_url;
    
endwhile;

Notas:

  • Os atributos width e height são previamente adicionados.
  • Se nenhum valor for passado para o atributo alt, ele será inserido automaticamente com o valor do título da postagem.
  • Todos os valores para atributos de imagem em argumetos são previamente escapados