Obtenga un elemento img HTML que represente un archivo adjunto de imagen.

Descripción

Tiempo $size aceptará una matriz, es mejor registrar un tamaño con add_image_size () para que se genere una versión recortada. Es mucho más eficiente que tener que encontrar la imagen del tamaño más cercano y luego hacer que el navegador reduzca la escala de la imagen.

Parámetros

$ attach_id

(En t)(Requerido)ID de imagen adjunta.

$ tamaño

(cuerda|En t[])(Opcional) Tamaño de la imagen. Acepta cualquier nombre de tamaño de imagen registrado o una matriz de valores de ancho y alto en píxeles (en ese orden).

Valor predeterminado: ‘miniatura’

$ icono

(bool)(Opcional) Si la imagen debe tratarse como un icono.

Valor predeterminado: falso

$ attr

(cuerda|formación)(Opcional)Atributos para el marcado de la imagen.

  • ‘src’
    (cuerda) URL del archivo adjunto de la imagen.
  • ‘clase’
    (cuerda) Nombre de clase CSS o lista de clases separadas por espacios. Defecto attachment-$size_class size-$size_class, dónde $size_class es el tamaño de la imagen que se solicita.
  • ‘alt’
    (cuerda) Descripción de la imagen para el atributo alt.
  • ‘srcset’
    (cuerda) El valor del atributo ‘srcset’.
  • ‘tamaños’
    (cuerda) El valor del atributo ‘tamaños’.
  • ‘cargando’
    (cadena | falso) El valor del atributo ‘cargando’. Pasar un valor de falso resultará en la omisión del atributo para la imagen. El valor predeterminado es ‘lazy’, dependiendo de wp_lazy_loading_enabled ().

Valor por defecto: ”

Regreso

(cuerda) Elemento img HTML o cadena vacía en caso de falla.

Más información

Uso 

wp_get_attachment_image($attachment_id,$size,$icon,$attr);

Si el archivo adjunto es una imagen, la función devuelve una imagen con el tamaño especificado. Para otros archivos adjuntos, la función devuelve un icono multimedia si el parámetro $ icon se establece en true.

Para obtener ID de adjuntos dinámicamente en una plantilla, puede usar get_posts( array( 'post_type' => 'attachment' ) )etc.

Fuente

Expediente: wp-includes / media.php

functionwp_get_attachment_image($attachment_id,$size='thumbnail',$icon=false,$attr='')int[] $size          Requested image size. Can be any registered image size name, or
	 *                                    an array of width and height values in pixels (in that order).
	 * @param bool         $icon          Whether the image should be treated as an icon.
	 * @param string[]     $attr          Array of attribute values for the image markup, keyed by attribute name.
	 *                                    See wp_get_attachment_image().
	 */returnapply_filters('wp_get_attachment_image',$html,$attachment_id,$size,$icon,$attr);

Relacionado

Usos

Usos Descripción
wp-includes / media.php:wp_get_attachment_image

Elemento img HTML que representa un archivo adjunto de imagen.
wp-includes / media.php:wp_lazy_loading_enabled ()

Determina si agregar el loading atributo a la etiqueta especificada en el contexto especificado.
wp-includes / media.php:wp_calculate_image_srcset ()

Una función auxiliar para calcular las fuentes de la imagen que se incluirán en un atributo ‘srcset’.
wp-includes / media.php:wp_calculate_image_sizes ()

Crea un valor de atributo de ‘tamaños’ para una imagen.
wp-includes / functions.php:wp_parse_args ()

Fusiona argumentos definidos por el usuario en una matriz predeterminada.
wp-includes / functions.php:absenta ()

Convierte un valor en un número entero no negativo.
wp-includes / plugin.php:aplicar_filtros ()

Llama a las funciones de devolución de llamada que se han agregado a un enlace de filtro.
wp-includes / media.php:wp_get_attachment_image_src ()

Recupera una imagen para representar un archivo adjunto.
wp-includes / media.php:wp_get_attachment_image_attributes

Filtra la lista de atributos de imagen adjunta.
wp-includes / media.php:image_hwstring ()

Recupere los atributos de ancho y alto utilizando valores de ancho y alto dados.
wp-includes / post.php:wp_get_attachment_metadata ()

Recupera metadatos de archivos adjuntos para la identificación del archivo adjunto.
wp-includes / post.php:get_post_meta ()

Recupera un metacampo de publicación para el ID de publicación dado.
wp-includes / post.php:get_post ()

Recupera los datos de la publicación con un ID de publicación o un objeto de publicación.

Usado por

Usado por Descripción
wp-includes / widgets / class-wp-widget-media-image.php:WP_Widget_Media_Image :: render_media ()

Renderiza los medios en la interfaz.
wp-includes / general-template.php:get_custom_logo ()

Devuelve un logotipo personalizado, vinculado a la página de inicio a menos que el tema admita la eliminación del enlace en la página de inicio.
wp-admin / includes / class-wp-media-list-table.php:WP_Media_List_Table :: column_title ()

Maneja la salida de la columna de título.
wp-admin / includes / post.php:_wp_post_thumbnail_html ()

Devuelve HTML para el metabox de la miniatura de la publicación.
wp-admin / includes / class-wp-comments-list-table.php:WP_Comments_List_Table :: column_response ()
wp-includes / post-thumbnail-template.php:get_the_post_thumbnail ()

Recupera la miniatura de la publicación.
wp-includes / post-template.php:wp_get_attachment_link ()

Recupere el enlace de una página adjunta usando una imagen o icono, si es posible.
wp-includes / media.php:gallery_shortcode ()

Crea la salida del código corto de la Galería.
wp-includes / post.php:set_post_thumbnail ()

Establece la miniatura de la publicación (imagen destacada) para la publicación determinada.

Registro de cambios

Versión Descripción
5.5.0 los $loading se agregó el atributo.
4.4.0 los $srcset y $sizes Se agregaron atributos.
2.5.0 Introducido.