Template engine concept in Express

Introduction

A template engine helps you create HTML pages by mixing static content with dynamic data easily.

You want to show user-specific information on a webpage, like a username.

You need to generate HTML pages that change based on data from a database.

You want to separate your webpage design from your server code for easier updates.

You want to reuse parts of your webpage like headers or footers across many pages.

Syntax

Express

res.render('templateName', { key: value, ... });

The 'templateName' is the file without extension in your views folder.

The object passed contains data you want to show in the template.

Examples

This sends data to the 'home' template to show a title and user name.

Express

res.render('home', { title: 'Welcome', user: 'Alice' });

This renders the 'profile' template with age and city data.

Express

res.render('profile', { age: 30, city: 'Paris' });

Sample Program

This Express app uses EJS as the template engine. When you visit the homepage, it sends the message 'Hello, friend!' to the 'index' template, which shows it inside an <h1> tag.

Express

import express from 'express';
import path from 'path';

const app = express();

// Set EJS as the template engine
app.set('view engine', 'ejs');
app.set('views', path.join(process.cwd(), 'views'));

app.get('/', (req, res) => {
  res.render('index', { message: 'Hello, friend!' });
});

app.listen(3000, () => {
  console.log('Server running on http://localhost:3000');
});

// views/index.ejs content:
// <html>
// <head><title>Home</title></head>
// <body>
//   <h1><%= message %></h1>
// </body>
// </html>

Important Notes

Make sure to install the template engine package (like ejs) with npm before using it.

Templates help keep your HTML clean and easy to update without changing server code.

Summary

Template engines mix HTML with data to create dynamic pages.

Use res.render() in Express to send data to templates.

Templates keep your design and code separate for easier maintenance.

Practice

1. What is the main purpose of using a template engine in Express?

easy

A. To improve server performance by caching files

B. To combine HTML with data and create dynamic web pages

C. To handle database connections automatically

D. To replace JavaScript code in the backend

Solution

1. Step 1: Understand what template engines do

   Template engines allow mixing HTML with data to generate dynamic content.

2. Step 2: Identify the main purpose in Express

   Express uses template engines to render HTML pages with data, making pages dynamic.

3. Final Answer:

   To combine HTML with data and create dynamic web pages -> Option B

4. Quick Check:

   Template engine purpose = dynamic HTML generation [OK]

Hint: Template engines create HTML pages with data dynamically [OK]

Common Mistakes:

• Thinking template engines handle databases
• Confusing template engines with performance tools
• Believing template engines replace backend code

2. Which Express method is used to render a template with data?

easy

A. res.render()

B. res.sendFile()

C. res.json()

D. res.redirect()

Solution

1. Step 1: Recall Express response methods

   Express has methods like res.sendFile, res.json, res.redirect, and res.render.

2. Step 2: Identify the method for templates

   res.render() is specifically used to render templates with data.

3. Final Answer:

   res.render() -> Option A

4. Quick Check:

   Render templates = res.render() [OK]

Hint: Use res.render() to send templates with data [OK]

Common Mistakes:

• Using res.sendFile() for templates
• Confusing res.json() with rendering HTML
• Trying to use res.redirect() to show templates

3. Given this Express code snippet, what will be the rendered output if the template shows <h1>Hello, <%= name %></h1> and res.render('greet', { name: 'Sam' }) is called?

medium

A. Hello,

B. Hello, <%= name %>

C. Hello, Sam

D. Error: Template variable not found

Solution

1. Step 1: Understand template variable usage

   The template uses <%= name %> to insert the value of 'name'.

2. Step 2: Check the data passed to the template

   The code passes { name: 'Sam' }, so 'Sam' replaces <%= name %>.

3. Final Answer:

   <h1>Hello, Sam</h1> -> Option C

4. Quick Check:

   Template variable replaced by 'Sam' [OK]

Hint: Variables in templates show passed data values [OK]

Common Mistakes:

• Thinking template tags show as text
• Assuming missing variables cause errors
• Ignoring passed data object

4. What is the error in this Express code snippet for rendering a template?

app.get('/hello', (req, res) => {
  res.render('hello', name: 'Alex');
});

medium

A. Template name should be a variable, not a string

B. The route path '/hello' is invalid

C. res.render() cannot be used inside app.get()

D. Missing curly braces around data object in res.render()

Solution

1. Step 1: Check res.render() syntax

   res.render() expects the template name and a data object in curly braces.

2. Step 2: Identify the mistake in data argument

   The code passes name: 'Alex' without curly braces, which is invalid syntax.

3. Final Answer:

   Missing curly braces around data object in res.render() -> Option D

4. Quick Check:

   Data object must be wrapped in {} [OK]

Hint: Always wrap data in {} when passing to res.render() [OK]

Common Mistakes:

• Omitting curly braces for data object
• Thinking template name must be variable
• Believing res.render() can't be used in routes

5. You want to create a page that shows a list of users using a template engine in Express. Which approach correctly passes the user list to the template for rendering?

hard

A. res.render('users', { users: ['Anna', 'Ben', 'Cara'] });

B. res.render('users', ['Anna', 'Ben', 'Cara']);

C. res.render('users', users = ['Anna', 'Ben', 'Cara']);

D. res.render('users', { 'Anna', 'Ben', 'Cara' });

Solution

1. Step 1: Understand how to pass data to templates

   Data must be passed as an object with keys matching template variables.

2. Step 2: Check each option's syntax

   res.render('users', { users: ['Anna', 'Ben', 'Cara'] }); correctly passes an object with key 'users' and an array value.

3. Final Answer:

   res.render('users', { users: ['Anna', 'Ben', 'Cara'] }); -> Option A

4. Quick Check:

   Pass data as object with keys [OK]

Hint: Pass data as an object with named keys to res.render() [OK]

Common Mistakes:

• Passing array directly without object
• Using assignment inside res.render()
• Using invalid object syntax