Pular para o conteúdo principal

featured_image()

featured_image( $size = '', $args = [] )

Exibe a imagem destacada da postagem dentro do loop.

Essa função imprime get_featured_image().

Parâmetros:
$size string (opcional)
Tamanho desejado. Opções: 'large' | 'medium' | 'small'. Padrão: 'medium'

$args array (opcional)
Atributos HTML do elemento <img>

Chaves do array
  • 'alt' → Texto alternativo da imagem
  • 'loading' → 'lazy'|true (para carregamento tardio)
  • 'class' → classe(s) CSS para a imagem
  • 'title' → Atributo title da imagem

Exemplo de uso:

// Uso básico
featured_image(); // Exibe a imagem destacada no tamanho 'medium'

// Com parâmetro $size e argumentos
featured_image( 'large', array(
    'class'   => 'image-featured nature',
    'alt'     => 'O canto das aves',
    'loading' => true // ou 'lazy'
));

// Saída
<img src="https://site.com/uploads/2025/05/sabia-900x500.jpg" 
    alt="O canto das aves" width="900" height="400" 
    class="image-featured nature" loading="lazy" 
/>