Image optimization with astro:assets

Introduction

Optimizing images makes websites load faster and look better on all devices. Astro's astro:assets helps do this automatically.

When you want your website images to load quickly on phones and computers.

When you need to serve different image sizes for different screen widths.

When you want to reduce the file size of images without losing quality.

When you want to use modern image formats like WebP for better performance.

Syntax

Astro

import { Image } from 'astro:assets';

<Image src="./path/to/image.jpg" alt="Description" width={300} height={200} />

Use the Image component from astro:assets to optimize images.

Specify src, alt, and size attributes like width and height.

Examples

Basic image with fixed width and height for a logo.

Astro

import { Image } from 'astro:assets';

<Image src="./logo.png" alt="Site Logo" width={150} height={50} />

Image optimized to use WebP format for better compression.

Astro

import { Image } from 'astro:assets';

<Image src="./photo.jpg" alt="Beautiful landscape" width={600} height={400} format="webp" />

Image with a blurred placeholder shown while loading.

Astro

import { Image } from 'astro:assets';

<Image src="./avatar.png" alt="User avatar" width={100} height={100} placeholder="blur" />

Sample Program

This Astro component imports the Image from astro:assets and displays an optimized image with a blurred placeholder. The image will load faster and look good on all devices.

Astro

---
import { Image } from 'astro:assets';
---

<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Astro Image Optimization Example</title>
  </head>
  <body>
    <h1>Welcome to My Site</h1>
    <Image src="./sample-photo.jpg" alt="Sample Photo" width={800} height={600} placeholder="blur" />
  </body>
</html>

Important Notes

Always provide an alt attribute for accessibility.

Use the placeholder="blur" option to improve user experience during image loading.

Astro automatically creates multiple image sizes and formats for best performance.

Summary

Astro's astro:assets makes image optimization easy and automatic.

Use the Image component to serve optimized images with proper sizes and formats.

Adding placeholders and alt text improves accessibility and user experience.

Practice

1. What is the main purpose of using the Image component from astro:assets in an Astro project?

easy

A. To automatically optimize images for size and format

B. To create image galleries manually

C. To write custom CSS for images

D. To upload images to a server

Solution

1. Step 1: Understand the role of astro:assets

   The astro:assets package provides tools to optimize images automatically.

2. Step 2: Identify the Image component's function

   The Image component serves images in optimized sizes and formats without manual work.

3. Final Answer:

   To automatically optimize images for size and format -> Option A

4. Quick Check:

   Image optimization = A [OK]

Hint: Remember: Image auto-optimizes images [OK]

Common Mistakes:

• Thinking Image uploads images
• Confusing styling with optimization
• Assuming manual resizing is needed

2. Which of the following is the correct way to import the Image component from astro:assets in an Astro file?

easy

A. import Image from 'astro:assets';

B. import { Image } from 'astro:assets';

C. import Image from '@astro/image';

D. import { Image } from '@astro/image';

Solution

1. Step 1: Recall the official import syntax

   The Image component is a named export from astro:assets, so it requires curly braces.

2. Step 2: Match the correct import statement

   Only import { Image } from 'astro:assets'; uses named import and correct package name.

3. Final Answer:

   import { Image } from 'astro:assets'; -> Option B

4. Quick Check:

   Named import with braces = C [OK]

Hint: Use curly braces for named imports like Image [OK]

Common Mistakes:

• Using default import without braces
• Wrong package name '@astro/image'
• Confusing default and named imports

3. Given the following Astro code snippet, what will be the rendered output in the browser?

---
import { Image } from 'astro:assets';
const photo = '../assets/photo.jpg';
---

medium

A. A syntax error due to wrong prop usage

B. A broken image link because the path is incorrect

C. An optimized image of width 400 pixels with alt text 'A mountain'

D. An image with original size ignoring width attribute

Solution

1. Step 1: Understand Image behavior with src and width

   The Image component optimizes the image and respects the width prop to resize it.

2. Step 2: Check alt text and path usage

   The alt text is provided correctly, and the relative path is valid for Astro assets.

3. Final Answer:

   An optimized image of width 400 pixels with alt text 'A mountain' -> Option C

4. Quick Check:

   Image optimization with width and alt = D [OK]

Hint: Width prop resizes image; alt improves accessibility [OK]

Common Mistakes:

• Assuming width is ignored
• Thinking relative paths break images
• Confusing alt text with title

4. Identify the error in this Astro code using Image from astro:assets:

---
import { Image } from 'astro:assets';
const logo = '/images/logo.png';
---

medium

A. The src path should be relative, not absolute

B. Missing width or height props causes a runtime error

C. The alt attribute is required but missing

D. The import statement is incorrect

Solution

1. Step 1: Check the src path format

   The Image component expects a relative path or imported asset, not an absolute URL path starting with '/'.

2. Step 2: Verify other props and import

   The alt attribute is present, and the import is correct; width/height are optional but recommended.

3. Final Answer:

   The src path should be relative, not absolute -> Option A

4. Quick Check:

   Use relative paths for src = B [OK]

Hint: Use relative paths for images, not absolute URLs [OK]

Common Mistakes:

• Using absolute paths starting with '/'
• Assuming width is mandatory
• Confusing import syntax

5. You want to serve an image with a blurred placeholder while it loads using astro:assets. Which of the following code snippets correctly implements this feature?

hard

A. import { Image } from 'astro:assets';
const pic = '../assets/pic.jpg';

<Image src={pic} alt="Scenery" placeholder={true} width={600} height={400} />

B. import Image from 'astro:assets';
const pic = '../assets/pic.jpg';

<Image src={pic} alt="Scenery" blur placeholder width={600} height={400} />

C. import { Image } from 'astro:assets';
const pic = '../assets/pic.jpg';

<Image src={pic} alt="Scenery" placeholder="loading" width={600} height={400} />

D. import { Image } from 'astro:assets';
const pic = '../assets/pic.jpg';

<Image src={pic} alt="Scenery" placeholder="blur" width={600} height={400} />

Solution

1. Step 1: Check correct import and usage of Image

   The Image component must be imported as a named import from astro:assets.

2. Step 2: Verify placeholder prop value

   The placeholder prop accepts string values like "blur" to enable blurred placeholders while loading.

3. Step 3: Confirm syntax correctness

   import { Image } from 'astro:assets';
   const pic = '../assets/pic.jpg';
   
   <Image src={pic} alt="Scenery" placeholder="blur" width={600} height={400} />
   

   uses correct import, relative path, and placeholder="blur" which is the proper way.

4. Final Answer:

   Code snippet with placeholder="blur" and named import -> Option D

5. Quick Check:

   Use placeholder="blur" with named import = A [OK]

Hint: Use placeholder="blur" for blurred loading effect [OK]

Common Mistakes:

• Using default import instead of named import
• Passing placeholder as boolean instead of string
• Using invalid placeholder values like "loading"