Multimedia
Las imágenes del tema están fuera de la biblioteca multimedia, así que WordPress desconoce sus dimensiones y cada imagen sin estilos desplaza el diseño mientras se carga. Blockstudio resuelve este problema con un manifiesto de metadatos generado, una función auxiliar de plantilla que siempre emite las dimensiones reales y un cargador diferido opcional.
Renderizado de imágenes
bs_media_image() renderiza los recursos del tema con el ancho y el alto reales, y una proporción reservada:
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
'class' => 'hero-media',
'sources' => [
['srcset' => '/hero-small.webp', 'media' => '(max-width: 640px)'],
],
]);
?>
El resultado es un figure.blockstudio-media con un aspect-ratio en línea alrededor de un img que incluye valores reales de width, height, loading y decoding.
src acepta una ruta relativa al tema, una ruta absoluta o un URL completo, y attachmentId se ocupa de las imágenes de la biblioteca multimedia. eager desactiva la carga diferida por encima del pliegue, y sources genera un elemento <picture> con las versiones alternativas indicadas.
Cuando hay metadatos, la función auxiliar siempre emite valores conocidos de ancho, alto y proporción. El modo diferido usa únicamente clases, atributos, identificadores y variables globales de blockstudio-*.
El manifiesto de metadatos
Las dimensiones provienen de assets/media.json, que genera Blockstudio\Media_Metadata_Builder durante una compilación o manualmente:
use Blockstudio\Media_Metadata_Builder;
(new Media_Metadata_Builder())->write(
get_stylesheet_directory(),
true
);
Esto escribe metadatos deterministas para los recursos del tema y, con el segundo argumento, para los adjuntos opcionales de WordPress. Vuelve a generarlo cada vez que cambien los archivos de assets/.
Media_Metadata_Builder::build( string $root ) devuelve el manifiesto sin escribirlo; write() es la variante que lo guarda. Blockstudio\Media_Metadata::reset() borra la caché del proceso después de una reconstrucción, algo que necesitan los procesos de compilación de larga duración antes de renderizar con los metadatos actualizados.
Carga diferida
Los ajustes de performance.media controlan el cargador del frontend:
{
"performance": {
"media": {
"lazy": true,
"skeleton": true,
"metadata": true,
"rootMargin": "300px"
}
}
}
Con lazy activado, el URL real se desplaza a data-src detrás de un marcador de posición del tamaño correcto. El cargador de Blockstudio, que detecta las intersecciones, lo sustituye por la imagen cuando esta se acerca al área visible; rootMargin lo hace con antelación. skeleton muestra el marcador de posición de carga integrado, y metadata indica que se está usando assets/media.json.
Los perfiles de rendimiento speed y strict activan el cargador de forma predeterminada; compat lo deja desactivado. Cada valor secundario puede anular el valor predeterminado del perfil.
La tabla completa de opciones de
performance.media.
Los metadatos multimedia son el segundo paso del orden de implementación en producción.