React components in Astro

Introduction

React components let you build interactive parts of a website. Using them in Astro helps combine React's power with Astro's fast page loading.

You want to add a button that changes when clicked inside an Astro page.

You need a form with live validation inside an Astro site.

You want to reuse a React-built widget in an Astro project.

You want to mix static content with dynamic React parts for better performance.

Syntax

Astro

import ReactComponent from './Component.jsx';

---

<ReactComponent client:load />

Use client:load to load React components on the client side after the page loads.

You can also use client:idle, client:visible, or client:media for different loading strategies.

Examples

This loads the MyButton React component when the page loads.

Astro

import MyButton from './MyButton.jsx';

---

<MyButton client:load />

This loads the Counter React component only when it becomes visible on the screen.

Astro

import Counter from './Counter.jsx';

---

<Counter client:visible />

This loads the Widget React component when the browser is idle, improving performance.

Astro

import Widget from './Widget.jsx';

---

<Widget client:idle />

Sample Program

This example shows a simple React Counter component used inside an Astro page. The button updates the count when clicked. The client:load directive tells Astro to load the React component on the client side.

Astro

// File: Counter.jsx
import React, { useState } from 'react';

export default function Counter() {
  const [count, setCount] = useState(0);
  return (
    <button onClick={() => setCount(count + 1)} aria-label="Increment count">
      Count: {count}
    </button>
  );
}

// File: src/pages/index.astro
---
import Counter from '../Counter.jsx';
---
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Astro React Example</title>
  </head>
  <body>
    <h1>Welcome to Astro with React</h1>
    <Counter client:load />
  </body>
</html>

Important Notes

Always add client: directives to React components in Astro to control when they load.

Use semantic HTML and ARIA labels inside React components for accessibility.

Astro renders static parts on the server and React handles dynamic parts on the client.

Summary

React components add interactivity inside Astro pages.

Use client:load or other client: directives to load React components properly.

This approach combines fast static content with dynamic React features.

Practice

1. What is the main reason to use React components inside an Astro page?

easy

A. To add interactive features to a mostly static Astro page

B. To replace Astro's static rendering completely

C. To write server-side code only

D. To avoid using any JavaScript on the page

Solution

1. Step 1: Understand Astro's rendering model

   Astro renders static HTML by default for fast loading.

2. Step 2: Role of React components in Astro

   React components add interactivity on top of static content.

3. Final Answer:

   To add interactive features to a mostly static Astro page -> Option A

4. Quick Check:

   React components = interactivity [OK]

Hint: React in Astro adds interactivity, not replaces static content [OK]

Common Mistakes:

• Thinking React replaces Astro's static rendering
• Believing React components run only on server
• Assuming no JavaScript is used with React

2. Which of the following is the correct way to load a React component in an Astro file for client-side interactivity?

easy

A.

B.

C.

D.

Solution

1. Step 1: Recall Astro client directives

   Astro uses client:load to load components on the client after page load.

2. Step 2: Identify correct directive for React interactivity

   client:load is the standard for React components to run in browser.

3. Final Answer:

   <ReactComponent client:load /> -> Option C

4. Quick Check:

   client:load = client-side React load [OK]

Hint: Use client:load to run React components in browser [OK]

Common Mistakes:

• Using client:server which runs only on server
• Using client:static which disables interactivity
• Confusing client:only with client:load

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

---
import Counter from '../components/Counter.jsx';
---

Assuming Counter is a React component that shows a button and a count starting at 0, which increments on click.

medium

A. A static button with count 0 that increments on click

B. A static button with count 0 but no increment on click

C. No button rendered because React is not loaded

D. An error because client:load is invalid

Solution

1. Step 1: Understand client:load behavior

   The client:load directive loads the React component in the browser, enabling interactivity.

2. Step 2: React Counter component behavior

   The Counter component shows a button with count 0 and increments count on click.

3. Final Answer:

   A static button with count 0 that increments on click -> Option A

4. Quick Check:

   client:load enables React interactivity [OK]

Hint: client:load means React runs and updates UI interactively [OK]

Common Mistakes:

• Thinking the button is static without interactivity
• Assuming React component won't render without server code
• Believing client:load causes errors

4. What is wrong with this Astro code snippet?

---
import MyButton from '../components/MyButton.jsx';
---

Assuming MyButton is a React component that should be interactive on the client.

medium

A. client:server causes the component to load twice

B. The import path is incorrect

C. React components cannot be used in Astro files

D. client:server does not load React components on the client for interactivity

Solution

1. Step 1: Understand client:server directive

   client:server means the component runs only on the server, no client interactivity.

2. Step 2: Requirement for React interactivity

   To make React interactive in browser, use client:load or similar client directives.

3. Final Answer:

   client:server does not load React components on the client for interactivity -> Option D

4. Quick Check:

   client:server = no client interactivity [OK]

Hint: Use client:load, not client:server, for React interactivity [OK]

Common Mistakes:

• Confusing client:server with client:load
• Assuming React components can't be interactive in Astro
• Thinking import path causes this error

5. You want to include a React component in an Astro page that fetches data from an API and updates on user interaction. Which approach correctly combines Astro's static rendering with React's dynamic behavior?

hard

A. Render the React component only on the server with client:server

B. Import the React component and use client:load to hydrate it on the client

C. Use Astro's built-in fetch inside the React component without client directives

D. Embed React code directly in Astro without importing or client directives

Solution

1. Step 1: Understand Astro static + React dynamic model

   Astro renders static HTML first, React components hydrate on client for interactivity.

2. Step 2: Correct way to hydrate React component

   Using client:load loads React on client, enabling data fetching and updates.

3. Final Answer:

   Import the React component and use <code>client:load</code> to hydrate it on the client -> Option B

4. Quick Check:

   client:load hydrates React for dynamic updates [OK]

Hint: Use client:load to combine static Astro with React dynamic [OK]

Common Mistakes:

• Trying to fetch data only on server without client hydration
• Embedding React code without proper client directives
• Assuming React runs without importing or hydration