Construir un componente de imagen personalizado
Astro proporciona dos componentes integrados que puedes usar para mostrar y optimizar tus imágenes. El componente <Picture> te permite mostrar imágenes responsivas y trabajar con diferentes formatos y tamaños. El componente <Image> optimizará tus imágenes y te permitirá pasar diferentes formatos y propiedades de calidad.
Cuando necesites opciones que los componentes <Picture> e <Image> no admitan actualmente, puedes usar la función getImage() para crear un componente personalizado.
En esta receta, utilizarás la función getImage() para crear tu propio componente de imagen personalizado que muestre diferentes imágenes de origen según las media queries.
-
Crea un nuevo componente de Astro e importa la función
getImage():src/components/MyCustomImageComponent.astro ---import { getImage } from "astro:assets";--- -
Crea un nuevo componente para tu imagen personalizada.
MyCustomComponent.astrorecibirá trespropsdesdeAstro.props. Las propsmobileImgUrlydesktopImgUrlse utilizan para crear tu imagen en diferentes tamaños de viewport. La propaltse utiliza para el texto alternativo de la imagen. Estas props se pasarán allí donde renderices tus componentes de imagen personalizados. Añade las siguientes importaciones y define las props que utilizarás en tu componente. También puedes usar TypeScript para tipar las props:src/components/MyCustomImageComponent.astro ---import type { ImageMetadata } from "astro";import { getImage } from "astro:assets";interface Props {mobileImgUrl: string | ImageMetadata;desktopImgUrl: string | ImageMetadata;alt: string;}const { mobileImgUrl, desktopImgUrl, alt } = Astro.props;--- -
Define cada una de tus imágenes responsivas llamando a la función
getImage()con las propiedades que desees:src/components/MyCustomImageComponent.astro ---import type { ImageMetadata } from "astro";import { getImage } from "astro:assets";interface Props {mobileImgUrl: string | ImageMetadata;desktopImgUrl: string | ImageMetadata;alt: string;}const { mobileImgUrl, desktopImgUrl, alt } = Astro.props;const mobileImg = await getImage({src: mobileImgUrl,format: "webp",width: 200,height: 200,});const desktopImg = await getImage({src: desktopImgUrl,format: "webp",width: 800,height: 200,});--- -
Crea un elemento
<picture>que genere unsrcsetcon tus diferentes imágenes según las media queries que desees:src/components/MyCustomImageComponent.astro ---import type { ImageMetadata } from "astro";import { getImage } from "astro:assets";interface Props {mobileImgUrl: string | ImageMetadata;desktopImgUrl: string | ImageMetadata;alt: string;}const { mobileImgUrl, desktopImgUrl, alt } = Astro.props;const mobileImg = await getImage({src: mobileImgUrl,format: "webp",width: 200,height: 200,});const desktopImg = await getImage({src: desktopImgUrl,format: "webp",width: 800,height: 200,});---<picture><source media="(max-width: 799px)" srcset={mobileImg.src} /><source media="(min-width: 800px)" srcset={desktopImg.src} /><img src={desktopImg.src} alt={alt} /></picture> -
Importa y usa
<MyCustomImageComponent />en cualquier archivo.astro. Asegúrate de pasar las props necesarias para generar dos imágenes diferentes en los distintos tamaños de viewport:src/pages/index.astro ---import MyCustomImageComponent from "../components/MyCustomImageComponent.astro";import mobileImage from "../images/mobile-profile-image.jpg";import desktopImage from "../images/desktop-profile-image.jpg";---<MyCustomImageComponentmobileImgUrl={mobileImage}desktopImgUrl={desktopImage}alt="foto de perfil del usuario"/>