client:media for responsive interactivity in Astro - Mini Project: Build & Apply

Responsive Image Gallery with client:media in Astro

📖 Scenario: You are building a simple image gallery for a website. The gallery should show different images depending on the screen size. This helps users see the best version of images on their device, whether a phone, tablet, or desktop.

🎯 Goal: Create an Astro component that uses client:media to load different images based on screen width. The gallery will show a small image on narrow screens and a larger image on wider screens.

📋 What You'll Learn

Create an Astro component with an image element

Add a media query variable to detect screen width

Use client:media with the media query to load images responsively

Ensure the component updates images automatically when resizing the browser

💡 Why This Matters

🌍 Real World

Responsive images improve website performance and user experience by loading appropriate images for different devices.

💼 Career

Knowing how to use client:media in Astro is useful for frontend developers building fast, adaptive websites.

1

Set up the image URLs

Create two variables called smallImage and largeImage with these exact string values: "/images/small.jpg" and "/images/large.jpg" respectively.

Astro

# Create variables for small and large image URLs
# Your code here

Hint

Use const to create variables and assign the exact string paths.

2

Define the media query

Create a variable called mediaQuery and set it to the string "(min-width: 600px)" to detect screens wider than 600 pixels.

Astro

const smallImage = "/images/small.jpg";
const largeImage = "/images/large.jpg";

# Define a media query string for screens wider than 600px
# Your code here

Hint

Use const mediaQuery = "(min-width: 600px)" exactly.

3

Add the responsive image element

Write an <img> element that uses client:media={mediaQuery}. Set the default src attribute to {smallImage} and add client:media={mediaQuery} src={largeImage} after the directive.

Astro

const smallImage = "/images/small.jpg";
const largeImage = "/images/large.jpg";
const mediaQuery = "(min-width: 600px)";

 tag with client:media and src attributes -->

Hint

Use <img src={smallImage} client:media={mediaQuery} src={largeImage} alt="Responsive gallery image" />.

4

Complete the Astro component

Wrap the code in an <Fragment> or root element if needed. Ensure the component exports properly and includes the image with client:media for responsive interactivity.

Astro

const smallImage = "/images/small.jpg";
const largeImage = "/images/large.jpg";
const mediaQuery = "(min-width: 600px)";

Hint

Use Astro frontmatter with --- and wrap the image in <> fragment tags.

Practice

1. What is the main purpose of using client:media in Astro components?

easy

A. To style components with CSS variables

B. To preload all components regardless of screen size

C. To disable JavaScript on mobile devices

D. To load components only when a specific media query matches

Solution

1. Step 1: Understand what client:media does

   client:media loads components conditionally based on media queries, meaning it only activates when the screen matches certain conditions.

2. Step 2: Compare options with this behavior

   To load components only when a specific media query matches this behavior exactly. Options B, C, and D describe unrelated or incorrect behaviors.

3. Final Answer:

   To load components only when a specific media query matches -> Option D

4. Quick Check:

   client:media loads components conditionally = A [OK]

Hint: Remember: client:media triggers only on matching screen sizes [OK]

Common Mistakes:

• Thinking client:media preloads all components
• Confusing client:media with CSS styling
• Assuming it disables JavaScript entirely

2. Which of the following is the correct syntax to load a component only on screens wider than 768px using client:media?

easy

A.

B.

C.

D.

Solution

1. Step 1: Recall correct media query syntax

   Media queries require parentheses around conditions, e.g., (min-width: 768px).

2. Step 2: Match syntax with options

   <Component client:media="(min-width: 768px)" /> uses correct parentheses and syntax. <Component client:media="min-width: 768px" /> misses parentheses. <Component client:media="screen and min-width: 768px" /> has incorrect syntax (missing parentheses around the condition). <Component client:media="(max-width: 768px)" /> uses max-width, which is the opposite condition.

3. Final Answer:

   <Component client:media="(min-width: 768px)" /> -> Option A

4. Quick Check:

   Correct media query syntax = B [OK]

Hint: Always wrap media queries in parentheses for client:media [OK]

Common Mistakes:

• Omitting parentheses around media queries
• Using max-width instead of min-width by mistake
• Adding unnecessary keywords like 'screen and'

3. Given this Astro component usage:

<MyWidget client:media="(max-width: 600px)" />

What happens when the screen width is 500px?

medium

A. The MyWidget component loads only on the server

B. The MyWidget component loads and runs on the client

C. The MyWidget component loads but does not run JavaScript

D. The MyWidget component does not load at all

Solution

1. Step 1: Understand the media query condition

   The media query (max-width: 600px) matches screen widths 600px or less.

2. Step 2: Check screen width against condition

   At 500px, the condition is true, so the component loads and runs on the client.

3. Final Answer:

   The MyWidget component loads and runs on the client -> Option B

4. Quick Check:

   Screen 500px matches max-width 600px = D [OK]

Hint: If screen matches query, component loads and runs client-side [OK]

Common Mistakes:

• Thinking component loads but does not run JavaScript
• Assuming component loads only on server
• Confusing max-width with min-width behavior

4. Identify the error in this Astro component usage:

<Sidebar client:media="min-width: 1024px" />

medium

A. Missing parentheses around the media query

B. Using client:media instead of client:load

C. Incorrect component name capitalization

D. Media query should be max-width, not min-width

Solution

1. Step 1: Check media query syntax

   The media query must be wrapped in parentheses, e.g., (min-width: 1024px).

2. Step 2: Verify other parts

   Component name capitalization is fine. Using client:media is correct for media queries. min-width is valid depending on intent.

3. Final Answer:

   Missing parentheses around the media query -> Option A

4. Quick Check:

   Media queries need parentheses = A [OK]

Hint: Always wrap media queries in parentheses to avoid syntax errors [OK]

Common Mistakes:

• Omitting parentheses in media queries
• Confusing client:media with client:load
• Changing media query type without reason

5. You want to load a navigation menu component only on screens between 600px and 1200px wide. Which client:media attribute correctly achieves this?

hard

A.

B.

C.

D.

Solution

1. Step 1: Understand the range condition

   You want the component to load only when the screen width is at least 600px and at most 1200px.

2. Step 2: Analyze each option's media query

   <NavigationMenu client:media="(min-width: 600px) and (max-width: 1200px)" /> correctly uses and to combine (min-width: 600px) and (max-width: 1200px). Options A and B have reversed or impossible ranges. <NavigationMenu client:media="(min-width: 600px) or (max-width: 1200px)" /> uses or, which matches too broadly.

3. Final Answer:

   <NavigationMenu client:media="(min-width: 600px) and (max-width: 1200px)" /> -> Option C

4. Quick Check:

   Use 'and' to combine min and max width = C [OK]

Hint: Use 'and' to combine min-width and max-width in client:media [OK]

Common Mistakes:

• Reversing min-width and max-width order
• Using 'or' instead of 'and' for range
• Creating impossible media query ranges