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
| Attribute | Type | Description |
|---|---|---|
| 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. |
| _processors | tuple | A tuple of additional context processor callables to be executed alongside the engine's default processors. |
| _processors_index | int | The 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
| Name | Type | Description |
|---|---|---|
| request | [HttpRequest](../../http/request/httprequest.md?sid=django_http_request_httprequest) | The current HTTP request object. |
| dict_ | dict = None | A dictionary of values to add to the context. |
| processors | list = None | A list of additional context processors to use. |
| use_l10n | bool = None | A boolean that controls whether data will be localized by default. |
| use_tz | bool = None | A boolean that controls whether datetimes will be timezone-aware by default. |
| autoescape | bool = True | A 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
| Name | Type | Description |
|---|---|---|
| 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 = None | An optional dictionary of initial variables to populate the context. |
| processors | list = None | A list of additional callable context processors to run specifically for this request. |
| use_l10n | boolean = None | A flag to enable or disable localized formatting of data. |
| use_tz | boolean = None | A flag to enable or disable timezone-aware datetime formatting. |
| autoescape | boolean = True | Determines 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
| Name | Type | Description |
|---|---|---|
| template | [Template](../base/template.md?sid=django_template_base_template) | The template instance whose engine configuration determines which context processors to execute. |
Returns
| Type | Description |
|---|---|
ContextManager | A 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
| Name | Type | Description |
|---|---|---|
| values | dict = None | A dictionary of new variables to push onto the context stack of the returned instance. |
Returns
| Type | Description |
|---|---|
[Context](context.md?sid=django_template_context_context) | A standard Context instance containing the provided values and the current context stack. |