Block definitions and overriding in Flask

Introduction

Blocks let you create parts of a webpage that can be changed later. This helps you reuse layouts and change only what you want.

You want a main page layout but different pages have different content.

You want to keep a header and footer the same on all pages but change the middle part.

You want to create a base template and let other templates add or change sections.

You want to avoid repeating the same HTML code on every page.

Syntax

Flask

{% block block_name %}
  Default content here
{% endblock %}

<!-- To override in child template -->
{% extends 'base.html' %}
{% block block_name %}
  New content here
{% endblock %}

Use {% block %} to define a replaceable section in your base template.

Use {% extends %} in child templates to inherit and override blocks.

Examples

Defines a block named title with default text 'My Site'.

Flask

{% block title %}My Site{% endblock %}

Overrides the title block in the base template to show 'Home Page'.

Flask

{% extends 'base.html' %}
{% block title %}Home Page{% endblock %}

Defines a content block with a welcome message.

Flask

{% block content %}
  <p>Welcome to my website!</p>
{% endblock %}

Sample Program

This example shows a base template with blocks for title and content. The home.html template extends the base and overrides these blocks to show a custom title and content.

Flask

{# base.html #}
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>{% block title %}Default Title{% endblock %}</title>
</head>
<body>
  <header>
    <h1>My Website</h1>
  </header>
  <main>
    {% block content %}
    <p>This is the default content.</p>
    {% endblock %}
  </main>
  <footer>
    <p>© 2024 My Website</p>
  </footer>
</body>
</html>

{# home.html #}
{% extends 'base.html' %}

{% block title %}Home Page{% endblock %}

{% block content %}
  <p>Welcome to the home page!</p>
{% endblock %}

Important Notes

Blocks help keep your templates clean and avoid repeating code.

If a block is not overridden, the default content inside the block is shown.

Always use {% extends %} at the very top of your child templates.

Summary

Blocks define parts of a template that can be changed in child templates.

Use {% block %} and {% endblock %} to create blocks.

Use {% extends %} to inherit and override blocks in other templates.

Practice

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

easy

A. To include external CSS files

B. To define sections that child templates can override

C. To write Python code inside templates

D. To create comments in the template

Solution

1. Step 1: Understand block usage in Flask templates

   The {% block %} tag defines a section in a base template that child templates can replace or extend.

2. Step 2: Identify the purpose of blocks

   Blocks allow flexible template inheritance by letting child templates override specific parts without rewriting the whole template.

3. Final Answer:

   To define sections that child templates can override -> Option B

4. Quick Check:

   Blocks = override sections [OK]

Hint: Blocks mark replaceable sections in templates [OK]

Common Mistakes:

• Confusing blocks with comments
• Thinking blocks run Python code
• Using blocks to include CSS

2. Which of the following is the correct syntax to override a block named content in a child template?

easy

A. {% block content %}New content{% endblock %}

B. {% extends content %}New content{% endextends %}

C. {% override content %}New content{% endoverride %}

D. {% include content %}New content{% endinclude %}

Solution

1. Step 1: Recall block override syntax

   To override a block, use {% block block_name %}...{% endblock %} in the child template.

2. Step 2: Check each option

   Only {% block content %}New content{% endblock %} uses the correct {% block %} and {% endblock %} tags with the block name.

3. Final Answer:

   {% block content %}New content{% endblock %} -> Option A

4. Quick Check:

   Override block = {% block %}...{% endblock %} [OK]

Hint: Override blocks with {% block name %}...{% endblock %} [OK]

Common Mistakes:

• Using {% extends %} instead of {% block %} to override
• Using non-existent tags like {% override %}
• Confusing {% include %} with block override

3. Given the base template base.html with:

{% raw %}{% block title %}Base Title{% endblock %}{% endraw %}

and child template child.html with:

{% raw %}{% extends 'base.html' %}{% block title %}Child Title{% endblock %}{% endraw %}

What will be displayed in the title block when rendering child.html?

medium

A. Base Title

B. Base TitleChild Title

C. Child Title

D. An error occurs

Solution

1. Step 1: Understand template inheritance

   The child template extends the base and overrides the title block.

2. Step 2: Determine which block content is used

   Since the child overrides the block, the content shown is from the child: "Child Title".

3. Final Answer:

   Child Title -> Option C

4. Quick Check:

   Child block overrides base block [OK]

Hint: Child block content replaces base block content [OK]

Common Mistakes:

• Assuming base block content shows instead
• Thinking both contents concatenate automatically
• Expecting a syntax error

4. Identify the error in this child template code:

{% raw %}{% extends 'base.html' %}{% block content %}Hello{% endblock content %}{% endraw %}

medium

A. Incorrect block closing tag; should be {% endblock %} not {% endblock content %}

B. Missing {% block %} tag

C. Incorrect extends syntax

D. No error; code is correct

Solution

1. Step 1: Check block closing syntax

   The correct way to close a block is with {% endblock %} without repeating the block name.

2. Step 2: Identify the error in the code

   The code uses {% endblock content %}, which is invalid and causes a syntax error.

3. Final Answer:

   Incorrect block closing tag; should be {% endblock %} not {% endblock content %} -> Option A

4. Quick Check:

   Block ends with {% endblock %} only [OK]

Hint: Close blocks with {% endblock %} only, no name [OK]

Common Mistakes:

• Adding block name in endblock tag
• Omitting {% block %} tag
• Wrong quotes in extends

5. You have a base template with two blocks:

{% raw %}{% block header %}Base Header{% endblock %}{% block footer %}Base Footer{% endblock %}{% endraw %}

You want a child template to override only the footer block but keep the base header. Which is the correct child template code?

hard

A. {% raw %}{% extends 'base.html' %}{% block header %}Base Header{% endblock %}{% block footer %}Child Footer{% endblock %}{% endraw %}

B. {% raw %}{% extends 'base.html' %}{% block header %}Child Header{% endblock %}{% endraw %}

C. {% raw %}{% block footer %}Child Footer{% endblock %}{% endraw %}

D. {% raw %}{% extends 'base.html' %}{% block footer %}Child Footer{% endblock %}{% endraw %}

Solution

1. Step 1: Understand block overriding behavior

   Only blocks defined in the child template override the base. Blocks not overridden use base content.

2. Step 2: Check which blocks are overridden

   {% raw %}{% extends 'base.html' %}{% block footer %}Child Footer{% endblock %}{% endraw %} overrides only footer, so header remains from base.

3. Final Answer:

   {% extends 'base.html' %}{% block footer %}Child Footer{% endblock %} -> Option D

4. Quick Check:

   Override only needed blocks in child [OK]

Hint: Override only blocks you want to change [OK]

Common Mistakes:

• Overriding blocks unnecessarily
• Forgetting {% extends %} in child
• Defining blocks without extends