Include for reusable fragments in Flask - Performance & Optimization

Performance: Include for reusable fragments

MEDIUM IMPACT

This affects page load speed by reducing template parsing and rendering time through reuse of common HTML parts.

Reusing common HTML parts like headers or footers in multiple pages

Flask

{% raw %}
<!-- base.html -->
<!DOCTYPE html>
<html>
<head><title>{% block title %}{% endblock %}</title></head>
<body>
  {% include 'header.html' %}
  {% block content %}{% endblock %}
  {% include 'footer.html' %}
</body>
</html>

<!-- page.html -->
{% extends 'base.html' %}
{% block title %}Page{% endblock %}
{% block content %}
<p>Page content here</p>
{% endblock %}
{% endraw %}

Includes load reusable fragments once and insert them, reducing duplication and parsing overhead.

📈 Performance GainReduces template size and parsing time, improving LCP by faster HTML generation

Reusing common HTML parts like headers or footers in multiple pages

Flask

{% raw %}
<!DOCTYPE html>
<html>
<head>
  <title>Page</title>
</head>
<body>
  <header>
    <h1>Site Title</h1>
    <nav>...</nav>
  </header>
  <!-- page specific content -->
  <footer>
    <p>© 2024 Company</p>
  </footer>
</body>
</html>
{% endraw %}

Duplicating the same header and footer in every template causes repeated parsing and larger template files.

📉 Performance CostIncreases template parsing time and memory usage for each page load

Performance Comparison

Pattern	Template Parsing	Server CPU	HTML Size	Verdict
Duplicated fragments in every template	High (repeated parsing)	Higher CPU usage	Larger HTML templates	[X] Bad
Includes for reusable fragments	Low (parsed once)	Lower CPU usage	Smaller templates	[OK] Good

Rendering Pipeline

Flask templates are parsed and rendered on the server before sending HTML to the browser. Using includes reduces repeated parsing of common fragments, speeding up server-side rendering.

→Template Parsing

→Server-side Rendering

⚠️ BottleneckTemplate Parsing when duplicating fragments

Core Web Vital Affected

LCP

This affects page load speed by reducing template parsing and rendering time through reuse of common HTML parts.

Optimization Tips

1Avoid duplicating common HTML in multiple templates to reduce parsing time.

2Use {% include %} to insert reusable fragments efficiently.

3Smaller, modular templates improve server rendering speed and LCP.

Performance Quiz - 3 Questions

How does using includes for reusable fragments affect server-side template rendering?

A It increases template size and slows down rendering

B It has no effect on rendering performance

C It reduces repeated parsing and speeds up rendering

D It causes more network requests for fragments

DevTools: Network

How to check: Open DevTools, go to Network tab, reload page, and inspect HTML response size and load time.

What to look for: Smaller HTML size and faster server response time indicate efficient template rendering with includes.

Practice

1. What is the main purpose of using {% include %} in Flask templates?

easy

A. To create new routes in Flask

B. To define variables in templates

C. To insert reusable HTML fragments into templates

D. To execute Python code inside templates

Solution

1. Step 1: Understand the role of {% include %}

   This tag is used to insert reusable HTML parts into templates to avoid repetition.

2. Step 2: Compare with other options

   Defining variables, creating routes, or executing Python code are not done with {% include %}.

3. Final Answer:

   To insert reusable HTML fragments into templates -> Option C

4. Quick Check:

   Reusable HTML insertion = A [OK]

Hint: Remember: include means insert reusable HTML [OK]

Common Mistakes:

• Confusing include with variable definition
• Thinking include creates routes
• Assuming include runs Python code

2. Which of the following is the correct syntax to include a reusable template named header.html inside another template?

easy

A. {% include 'header.html' %}

B. {% import 'header.html' %}

C. {{ include('header.html') }}

D. {% extend 'header.html' %}

Solution

1. Step 1: Recall the correct syntax for including templates

   The correct syntax uses {% include 'filename' %} with quotes around the filename.

2. Step 2: Eliminate incorrect options

   {% import %} is for macros, {{ include() }} is invalid, and {% extend %} is for template inheritance.

3. Final Answer:

   {% include 'header.html' %} -> Option A

4. Quick Check:

   Include syntax = {% include 'file' %} [OK]

Hint: Use {% include 'file.html' %} with quotes [OK]

Common Mistakes:

• Using {% import %} instead of {% include %}
• Trying to call include as a function {{ include() }}
• Confusing include with extend

3. Given the following templates, what will be rendered when base.html is rendered?

base.html:
<html>
  <body>
    {% include 'nav.html' %}
    <h1>Welcome</h1>
  </body>
</html>

nav.html:
<nav>Menu</nav>

medium

A. <nav>Menu</nav><h1>Welcome</h1>

B. <html><body><h1>Welcome</h1></body></html>

C. Error: nav.html not found

D. <html><body><nav>Menu</nav><h1>Welcome</h1></body></html>

Solution

1. Step 1: Understand how {% include %} works

   The {% include 'nav.html' %} inserts the content of nav.html exactly where the tag is placed.

2. Step 2: Combine the templates

   In base.html, the <nav>Menu</nav> from nav.html appears before the <h1>Welcome</h1> inside the body.

3. Final Answer:

   <html><body><nav>Menu</nav><h1>Welcome</h1></body></html> -> Option D

4. Quick Check:

   Include inserts nav.html content inline [OK]

Hint: Include inserts file content exactly where placed [OK]

Common Mistakes:

• Ignoring the included file content
• Expecting an error if file exists
• Thinking include replaces whole template

4. What is the error in this template snippet?

{% include header.html %}

medium

A. Filename should be a variable, not a string

B. Missing quotes around the filename

C. Incorrect tag name, should be import

D. Include tag cannot be used inside templates

Solution

1. Step 1: Check syntax for include tag

   The filename must be a string literal enclosed in quotes, like 'header.html'.

2. Step 2: Identify the error

   Here, header.html is unquoted, causing a syntax error.

3. Final Answer:

   Missing quotes around the filename -> Option B

4. Quick Check:

   Filename must be quoted in include [OK]

Hint: Always put quotes around filenames in include [OK]

Common Mistakes:

• Omitting quotes around filename
• Using import instead of include
• Thinking include is invalid in templates

5. You want to create a reusable footer for your Flask app. Which approach correctly uses {% include %} to add footer.html to multiple pages and ensures easy updates?

hard

A. Add {% include 'footer.html' %} in each page template where footer is needed

B. Copy footer HTML code into every page template manually

C. Use {% extend 'footer.html' %} in each page template

D. Write footer HTML inside the Flask route function

Solution

1. Step 1: Understand reusable fragments with include

   Using {% include 'footer.html' %} inserts the footer code wherever needed, keeping code DRY.

2. Step 2: Compare other options

   Copying code manually duplicates it, {% extend %} is for inheritance, and writing HTML in route mixes logic and presentation.

3. Final Answer:

   Add {% include 'footer.html' %} in each page template where footer is needed -> Option A

4. Quick Check:

   Include footer in templates for easy updates [OK]

Hint: Use include tag in templates to reuse footer [OK]

Common Mistakes:

• Copy-pasting footer code instead of including
• Using extend instead of include for fragments
• Mixing HTML in Python route code