Pular para o conteúdo principal

featured_image()

Exibe a imagem destacada para o registro de post que está sendo iterado.

Essa apenas imprime a função get_featured_image().

Parâmetros:
$args array (opcional)

Argumentos disponíveis:
  • 'scope' stringTamanho da imagem. Padrão: 'larger'
    Valores padrões (se não desabilitado):

    'wide', 'larger', 'minor', 'thumbnail', 'system'

  • Atributos HTML
    • 'alt' string Texto alternativo. Padrão: O título da postagem
    • 'loading' string|bool 'lazy'|trueCarregamento tardio
    • 'class' string Classe(s) CSS para a imagem
    • 'title' string Atributo title da imagem

Retorno: void
Imprime a tag <img> completa com atributos.

Exemplo de uso:

while( row_exists() ) : show_row();
    // Uso básico: Exibe a imagem destacada no tamanho 'larger'
    featured_image();
    
    // Com argumentos
    featured_image([
        'scope'   => 'wide',
        'alt'     => 'Natureza: ' . get_title(),
        'class'   => 'image-wide nature',
        'loading' => 'lazy', // ou true
        'title'   => get_title()
    ]);
endwhile;

// Saída
<img 
    src="https://site.ext/uploads/2025/05/post-29-wide.jpg" 
    alt="Natureza: O canto das aves" 
    width="900" height="400" 
    class="image-wide nature" 
    loading="lazy" 
    title="O canto das aves"
/>