Templates#

Quart uses the Jinja2 templating engine, which is well documented. Quart adds a standard context, and some standard filters to the Jinja2 defaults. Quart also adds the ability to define custom filters, tests and contexts at an app and blueprint level.

There are two functions to use when templating, render_template() and render_template_string(), both must be awaited. The return value from either function is a string and can form a route response directly or be otherwise combined. Both functions take an variable number of additional keyword arguments to pass to the template as context, for example,

@app.route('/')
async def index():
    return await render_template('index.html', hello='world')

Quart standard extras#

The standard context includes the config, request, session, and g with these objects referencing the current_app.config and those defined in globals respectively. The can be accessed as expected,

@app.route('/')
async def index():
    return await render_template_string("{{ request.endpoint }}")

The standard global functions are url_for() and get_flashed_messages(). These can be used as expected,

@app.route('/')
async def index():
    return await render_template_string("<a href="{{ url_for('index') }}>index</a>")

Adding filters, tests, globals and context#

To add a filter for usage in templates, make use of template_filter() or app_template_filter() as decorators, or add_template_filter() or add_app_template_filter() as functions. These expect the filter to take in Any value and return a str, e.g.

@app.template_filter(name='upper')
def upper_case(value):
    return value.upper()

@app.route('/')
async def index():
    return await render_template_string("{{ lower | upper }}")

tests and globals work in a very similar way only with the test and global methods rather than filter.

The context processors however have an additional feature, in that they can be specified on a per blueprint basis. This allows contextual information to be present only for requests that are routed to the blueprint. By default context_processor() adds contextual information to blueprint routed requests whereas app_context_processor() adds the information to all requests to the app. An example,

@blueprint.context_processor
async def blueprint_only():
    return {'context': 'value'}

@blueprint.app_context_processor
async def app_wide():
    return {'context': 'value'}