Why template engines matter in Flask

Introduction

Template engines help you create web pages by mixing code and design easily. They keep your website organized and make it simple to update content.

You want to show dynamic content like user names or lists on a webpage.

You need to separate the look of your site from the data it shows.

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

You want to avoid writing HTML inside your Python code directly.

You want to make your website easier to maintain and update.

Syntax

Flask

{% block content %}
  <h1>Hello, {{ user_name }}!</h1>
{% endblock %}

Use double curly braces {{ }} to insert variables into HTML.

Use {% %} for control statements like loops or conditions.

Examples

Insert a variable called user_name into the HTML.

Flask

<h1>Welcome, {{ user_name }}!</h1>

Show different messages based on a condition.

Flask

{% if user_is_logged_in %}
  <p>Welcome back!</p>
{% else %}
  <p>Please log in.</p>
{% endif %}

Loop through a list and display each item.

Flask

{% for item in items %}
  <li>{{ item }}</li>
{% endfor %}

Sample Program

This Flask app uses a template string to greet the user by name. The template engine replaces {{ user_name }} with 'Alice' when rendering the page.

Flask

from flask import Flask, render_template_string

app = Flask(__name__)

@app.route('/')
def home():
    user_name = 'Alice'
    template = '''
    <html>
      <head><title>Welcome</title></head>
      <body>
        <h1>Hello, {{ user_name }}!</h1>
      </body>
    </html>
    '''
    return render_template_string(template, user_name=user_name)

if __name__ == '__main__':
    app.run(debug=True)

Important Notes

Template engines keep your Python code clean by separating HTML from logic.

They help prevent security issues by escaping harmful input automatically.

Flask uses Jinja2 as its default template engine, which is powerful and easy to learn.

Summary

Template engines mix data and design to build web pages easily.

They help keep your code organized and your site easy to update.

Flask's template engine uses simple tags to insert variables and control flow.

Practice

1. Why do Flask developers use template engines like Jinja2?

easy

A. To separate the website design from the Python code

B. To write all HTML directly inside Python functions

C. To avoid using any HTML in the project

D. To make the website load faster by skipping HTML

Solution

1. Step 1: Understand the role of template engines

   Template engines help keep the design (HTML) separate from the Python logic, making code cleaner.

2. Step 2: Identify the correct purpose in Flask

   Flask uses template engines to insert data into HTML without mixing code and design.

3. Final Answer:

   To separate the website design from the Python code -> Option A

4. Quick Check:

   Separation of concerns = To separate the website design from the Python code [OK]

Hint: Template engines separate code and design for clarity [OK]

Common Mistakes:

• Thinking template engines remove HTML entirely
• Believing all HTML must be inside Python code
• Assuming template engines speed up loading by skipping HTML

2. Which of the following is the correct way to insert a variable name in a Flask template using Jinja2?

easy

A. {{ name }}

B. <% name %>

C. [[ name ]]

D. {% name %}

Solution

1. Step 1: Recall Jinja2 syntax for variables

   Jinja2 uses double curly braces {{ }} to insert variables into templates.

2. Step 2: Match the syntax to the options

   Only {{ name }} uses the correct {{ name }} syntax for variable insertion.

3. Final Answer:

   {{ name }} -> Option A

4. Quick Check:

   Variable insertion = {{ }} [OK]

Hint: Use double curly braces {{ }} for variables in templates [OK]

Common Mistakes:

• Using {% %} which is for control flow, not variables
• Confusing with other template syntaxes like <% %>
• Using brackets or other symbols instead of {{ }}

3. Given this Flask template snippet:

{% if user %}
  Hello, {{ user }}!
{% else %}
  Hello, Guest!
{% endif %}

What will be displayed if user is set to "Alice"?

medium

A. Hello, Guest!

B. Hello, {{ user }}!

C. Hello, Alice!

D. SyntaxError

Solution

1. Step 1: Understand the if-else logic in the template

   The template checks if user has a value. If yes, it shows "Hello, {{ user }}!" with the variable replaced.

2. Step 2: Substitute the variable value

   Since user is "Alice", the output becomes "Hello, Alice!".

3. Final Answer:

   Hello, Alice! -> Option C

4. Quick Check:

   Variable present = personalized greeting [OK]

Hint: If variable exists, template shows its value inside {{ }} [OK]

Common Mistakes:

• Thinking the variable name {{ user }} will print literally
• Ignoring the if condition and choosing the else output
• Assuming a syntax error due to template tags

4. What is wrong with this Flask template code?

{% for item in items %}
  
{{ item }
{% endfor %}

medium

A. Incorrect for loop syntax in Jinja2

B. Missing closing curly brace in variable tag

C. The <p> tag cannot be used inside loops

D. No need to use {% endfor %} in templates

Solution

1. Step 1: Check the variable tag syntax

   The variable tag {{ item } is missing one closing curly brace '}' at the end.

2. Step 2: Verify loop and HTML tags

   The for loop syntax and <p> tags are correct; only the variable tag is wrong.

3. Final Answer:

   Missing closing curly brace in variable tag -> Option B

4. Quick Check:

   Variable tags need double braces {{ }} [OK]

Hint: Count your curly braces carefully in {{ }} tags [OK]

Common Mistakes:

• Forgetting the second closing brace in {{ }}
• Thinking {% endfor %} is optional
• Believing HTML tags can't be inside loops

5. You want to display a list of products with their prices in a Flask template. Which approach best uses a template engine to keep your code clean and easy to update?

hard

A. Write all HTML and Python code together in the Flask route function

B. Generate the entire HTML page as a single string in Python and return it

C. Hardcode the product list in the HTML template without variables

D. Use a template with a for loop to list products and insert prices dynamically

Solution

1. Step 1: Understand separation of concerns

   Keeping HTML in templates and logic in Python functions makes code organized and maintainable.

2. Step 2: Use template loops for dynamic lists

   Using a for loop in the template to display products with prices allows easy updates and clean code.

3. Final Answer:

   Use a template with a for loop to list products and insert prices dynamically -> Option D

4. Quick Check:

   Templates + loops = clean dynamic pages [OK]

Hint: Use template loops to display lists dynamically [OK]

Common Mistakes:

• Mixing HTML and Python code in one place
• Hardcoding data instead of using variables
• Building HTML strings manually in Python