Spec-Zone.ru › Django 1.8

Простые миксины

ContextMixin

class django.views.generic.base.ContextMixin

Методы

get_context_data(**kwargs)

Возвращает словарь, представляющий контекст шаблона. Переданные ключевые аргументы составят возвращаемый контекст. Пример использования:

def get_context_data(self, **kwargs):
    context = super(RandomNumberView, self).get_context_data(**kwargs)
    context['number'] = random.randrange(1, 100)
    return context

Контекст шаблона всех шаблонно-ориентированных общих представлений включает переменную view, которая указывает на экземпляр View.

Использовать alters_data по мере необходимости

Обратите внимание, что наличие экземпляра представления в контексте шаблона может предоставить авторам шаблонов потенциально опасные методы. Чтобы предотвратить вызов таких методов в шаблоне, установите alters_data=True для этих методов. Для получения дополнительной информации ознакомьтесь с документацией по рендерингу контекста шаблона.

TemplateResponseMixin

class django.views.generic.base.TemplateResponseMixin

Предоставляет механизм построения TemplateResponse при наличии соответствующего контекста. Шаблон для использования настраивается и может быть дополнительно настроен подклассами.

Атрибуты

template_name

Полное имя шаблона, заданное строкой. Если template_name не определено, будет выброшено исключение django.core.exceptions.ImproperlyConfigured.

template_engine

NAME используемого движка шаблонов для загрузки шаблона. template_engine передаётся в качестве ключевого аргумента using методу response_class. По умолчанию используется None, что указывает Django на поиск шаблона во всех настроенных движках.

response_class

Класс ответа, который должен быть возвращён методом render_to_response. По умолчанию TemplateResponse. Шаблон и контекст экземпляров TemplateResponse могут быть изменены позже (например, в средстве обработки шаблонов ответа).

В более ранних версиях Django TemplateResponse использовался RequestContext таким образом, что значения из обработчиков контекста шаблонов переписывали переменные шаблона, определённые в ваших представлениях. Например, если вы создали подкласс DetailView и установили context_object_name в user, обработчик контекста django.contrib.auth.context_processors.auth перезапишет вашу переменную текущим пользователем. Теперь, для согласованности с render() сокращением, значения в контексте, предоставленном классом, перекрывают значения из обработчиков контекста.

Если вам нужен пользовательский загрузчик шаблонов или пользовательская инициализация объекта контекста, создайте подкласс TemplateResponse и назначьте его response_class.

content_type

Тип содержимого для использования в ответе. content_type передаётся в качестве ключевого аргумента методу response_class. По умолчанию None – это означает, что Django использует DEFAULT_CONTENT_TYPE.

Методы

render_to_response(context, **response_kwargs)

Возвращает экземпляр self.response_class.

Если предоставлены любые ключевые аргументы, они будут переданы в конструктор класса ответа.

Вызывает get_template_names() для получения списка имён шаблонов, которые будут проверяться на наличие.

get_template_names()

Возвращает список имён шаблонов, которые нужно искать при рендеринге шаблона.

Если указано template_name, реализация по умолчанию возвращает список, содержащий template_name (если он указан).

© Django Software Foundation and individual contributors
Licensed under the BSD License.
https://docs.djangoproject.com/en/1.8/ref/class-based-views/mixins-simple/

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API