Skip to main content

RequestContext

This subclass of template.Context automatically populates itself using the processors defined in the engine's configuration. Additional processors can be specified as a list of callables using the "processors" keyword argument.

Attributes

AttributeTypeDescription
request[HttpRequest](../../http/request/httprequest.md?sid=django_http_request_httprequest)The current HttpRequest instance used by context processors to generate variable data for the template.
_processorstupleA tuple of additional context processor callables to be executed alongside the engine's default processors.
_processors_indexintThe integer index within the internal context stack where the results of context processors are stored.

Constructor

Signature

def RequestContext(
request: [HttpRequest](../../http/request/httprequest.md?sid=django_http_request_httprequest),
dict_: dict = None,
processors: list = None,
use_l10n: bool = None,
use_tz: bool = None,
autoescape: bool = True
) - > null

Parameters

NameTypeDescription
request[HttpRequest](../../http/request/httprequest.md?sid=django_http_request_httprequest)The current HTTP request object.
dict_dict = NoneA dictionary of values to add to the context.
processorslist = NoneA list of additional context processors to use.
use_l10nbool = NoneA boolean that controls whether data will be localized by default.
use_tzbool = NoneA boolean that controls whether datetimes will be timezone-aware by default.
autoescapebool = TrueA boolean that controls whether auto-escaping is enabled.

Signature

def RequestContext(
request: [HttpRequest](../../http/request/httprequest.md?sid=django_http_request_httprequest),
dict_: dict = None,
processors: list = None,
use_l10n: boolean = None,
use_tz: boolean = None,
autoescape: boolean = True
) - > null

Parameters

NameTypeDescription
request[HttpRequest](../../http/request/httprequest.md?sid=django_http_request_httprequest)The current HTTP request object used by context processors to generate dynamic data.
dict_dict = NoneAn optional dictionary of initial variables to populate the context.
processorslist = NoneA list of additional callable context processors to run specifically for this request.
use_l10nboolean = NoneA flag to enable or disable localized formatting of data.
use_tzboolean = NoneA flag to enable or disable timezone-aware datetime formatting.
autoescapeboolean = TrueDetermines whether HTML auto-escaping is enabled for variable interpolation.

Methods


bind_template()

@classmethod
def bind_template(
template: [Template](../base/template.md?sid=django_template_base_template)
) - > ContextManager

Binds the context to a specific template and executes all associated context processors to populate the context data.

Parameters

NameTypeDescription
template[Template](../base/template.md?sid=django_template_base_template)The template instance whose engine configuration determines which context processors to execute.

Returns

TypeDescription
ContextManagerA context manager that ensures the template is unbound and processor data is cleared after use.

new()

@classmethod
def new(
values: dict = None
) - > [Context](context.md?sid=django_template_context_context)

Creates a new Context instance from the current one, intentionally stripping context processor logic for backwards compatibility.

Parameters

NameTypeDescription
valuesdict = NoneA dictionary of new variables to push onto the context stack of the returned instance.

Returns

TypeDescription
[Context](context.md?sid=django_template_context_context)A standard Context instance containing the provided values and the current context stack.