Component structure (frontmatter + template) in Astro

Introduction

Components in Astro help you build parts of a webpage separately. The frontmatter sets up data or logic, and the template shows what the user sees.

When you want to create a reusable part of a webpage like a header or footer.

When you need to prepare data or variables before showing content.

When you want to keep your code organized by separating logic and display.

When building static or dynamic pages with Astro.

When you want to combine HTML with JavaScript easily.

Syntax

Astro

---
// Frontmatter: JavaScript or TypeScript code here
const title = 'Welcome to my site';
---

<!-- Template: HTML and Astro syntax here -->
<h1>{title}</h1>

The frontmatter is always between triple dashes --- at the top.

The template uses curly braces {} to show variables or expressions.

Examples

Simple example showing a variable from frontmatter used in the template.

Astro

---
const name = 'Alice';
---
<p>Hello, {name}!</p>

Using JavaScript array and map to create a list in the template.

Astro

---
const items = ['Apple', 'Banana', 'Cherry'];
---
<ul>
  {items.map(item => <li key={item}>{item}</li>)}
</ul>

Conditional rendering based on a variable from frontmatter.

Astro

---
const isLoggedIn = true;
---
{isLoggedIn ? <p>Welcome back!</p> : <p>Please log in.</p>}

Sample Program

This component shows user information. The frontmatter defines the user object, and the template displays the name and age.

Astro

---
const user = {
  name: 'Sam',
  age: 30
};
---
<section>
  <h2>User Info</h2>
  <p>Name: {user.name}</p>
  <p>Age: {user.age}</p>
</section>

Important Notes

Always put frontmatter at the very top of the file.

Use curly braces {} in the template to insert JavaScript values.

Keep logic simple in frontmatter to keep templates clean and readable.

Summary

Astro components have two parts: frontmatter for code, template for display.

Frontmatter is inside --- at the top of the file.

Use curly braces {} in the template to show data from frontmatter.

Practice

1. What is the purpose of the frontmatter section in an Astro component?

easy

A. To style the component with CSS

B. To write JavaScript code and define variables used in the template

C. To write HTML markup for the component

D. To import other components only

Solution

1. Step 1: Understand frontmatter role

   The frontmatter section is where you write JavaScript code, such as variables or functions, that the template can use.

2. Step 2: Differentiate from template

   The template part is for HTML markup, not code. Styling is done separately, not in frontmatter.

3. Final Answer:

   To write JavaScript code and define variables used in the template -> Option B

4. Quick Check:

   Frontmatter = JavaScript code [OK]

Hint: Frontmatter holds code; template holds HTML display [OK]

Common Mistakes:

• Confusing frontmatter with template HTML
• Thinking frontmatter is for CSS styling
• Believing frontmatter is only for imports

2. Which of the following is the correct way to start the frontmatter section in an Astro component?

easy

A. //

B. { }

C. /* */

D. ---

Solution

1. Step 1: Identify frontmatter syntax

   Astro uses triple dashes --- at the top and bottom to mark the frontmatter section.

2. Step 2: Compare options

   Curly braces, comments, or single slashes are not used to mark frontmatter.

3. Final Answer:

   --- -> Option D

4. Quick Check:

   Frontmatter starts with --- [OK]

Hint: Frontmatter always starts and ends with --- [OK]

Common Mistakes:

• Using curly braces to start frontmatter
• Confusing comments with frontmatter markers
• Omitting the closing ---

3. Given this Astro component code, what will be displayed when rendered?

---
const greeting = "Hello, Astro!";
---
{greeting}

medium

A. {greeting}

B.

C. Hello, Astro!

D. Error: greeting is undefined

Solution

1. Step 1: Understand variable usage

   The variable greeting is defined in frontmatter with value "Hello, Astro!".

2. Step 2: Template interpolation

   The template uses curly braces {greeting} to insert the variable's value into the HTML.

3. Final Answer:

   <h1>Hello, Astro!</h1> -> Option C

4. Quick Check:

   Curly braces insert variable value [OK]

Hint: Curly braces show frontmatter variables in template [OK]

Common Mistakes:

• Thinking curly braces show as text literally
• Assuming variable is undefined without frontmatter
• Forgetting to close frontmatter with ---

4. What is wrong with this Astro component code?

---
const name = "Astro";

Hello, {name}!
---

medium

A. The template HTML is inside the frontmatter section

B. The variable name is not defined

C. Curly braces cannot be used in Astro templates

D. Missing closing tag for <h1>

Solution

1. Step 1: Identify frontmatter boundaries

   Frontmatter is only for JavaScript code and must be enclosed between --- lines.

2. Step 2: Check template placement

   The HTML template must be outside the frontmatter. Here, the <h1> is inside frontmatter, causing an error.

3. Final Answer:

   The template HTML is inside the frontmatter section -> Option A

4. Quick Check:

   Template must be outside frontmatter [OK]

Hint: Keep HTML outside --- frontmatter --- [OK]

Common Mistakes:

• Placing HTML inside frontmatter
• Forgetting to close frontmatter with ---
• Misusing curly braces syntax

5. How can you display a list of items defined in frontmatter inside the template in Astro? Choose the correct code snippet to render a list of fruits stored in fruits array.

hard

A. ---
const fruits = ["Apple", "Banana", "Cherry"];
---

{fruits.map(fruit => {fruit})}

B. ---
const fruits = ["Apple", "Banana", "Cherry"];
---

{for fruit in fruits}
{fruit}
{/for}

C. ---
const fruits = ["Apple", "Banana", "Cherry"];
---

{fruits.forEach(fruit => {fruit})}

D. ---
const fruits = ["Apple", "Banana", "Cherry"];
---

{fruits.map(fruit => "" + fruit + "")}

Solution

1. Step 1: Understand how to loop in Astro template

   Astro templates use JavaScript expressions inside curly braces. map() returns an array of JSX elements to render.

2. Step 2: Check each option's correctness

   ---
   const fruits = ["Apple", "Banana", "Cherry"];
   ---
   
     {fruits.map(fruit => 
   {fruit}
   )}
   

   uses map() correctly to return <li> elements.

   ---
   const fruits = ["Apple", "Banana", "Cherry"];
   ---
   
     {for fruit in fruits}
       
   {fruit}
     {/for}
   

   uses invalid syntax.

   ---
   const fruits = ["Apple", "Banana", "Cherry"];
   ---
   
     {fruits.forEach(fruit => 
   {fruit}
   )}
   

   uses forEach() which returns undefined.

   ---
   const fruits = ["Apple", "Banana", "Cherry"];
   ---
   
     {fruits.map(fruit => "
   " + fruit + "
   ")}
   

   returns strings, not JSX elements.

3. Final Answer:

   Option A correctly renders the list using map() -> Option A

4. Quick Check:

   Use map() to render lists in Astro templates [OK]

Hint: Use map() inside curly braces to render lists [OK]

Common Mistakes:

• Using forEach instead of map for rendering
• Trying template loops with invalid syntax
• Returning strings instead of JSX elements