Установка¶

Установка django-crispy-forms¶

Установите последнюю стабильную версию в среду python с помощью pip:

pip install django-crispy-forms

Если вы хотите установить версию для разработки (нестабильную), вы можете сделать это следующим образом:

pip install git+git://github.com/django-crispy-forms/django-crispy-forms.git@main#egg=django-crispy-forms

Или, если вы хотите установить версию разработки как git-репозиторий (чтобы можно было git pull обновлять), используйте флаг -e с pip install, как показано ниже:

pip install -e git+git://github.com/django-crispy-forms/django-crispy-forms.git@main#egg=django-crispy-forms

После установки добавьте crispy_forms к вашему INSTALLED_APPS в settings.py:

INSTALLED_APPS = (
    ...
    'crispy_forms',
)

В производственных средах всегда активируйте загрузчик кэша шаблонов Django. Он доступен с версии Django 1.2 и, по сути, загружает шаблоны один раз, а затем кэширует результат для каждого последующего рендеринга. Это приводит к значительному повышению производительности. Чтобы узнать, как его настроить, обратитесь к сказке Django docs page.

Пакеты шаблонов¶

Начиная с версии 1.1.0, django-crispy-forms имеет встроенную поддержку различных CSS-фреймворков, известных как пакеты шаблонов в django-crispy-forms:

• bootstrap Bootstrap - это пакет шаблонов по умолчанию crispy-forms, версия 2 популярного простого и гибкого HTML, CSS и Javascript для пользовательских интерфейсов от Twitter.

• bootstrap3 Twitter Bootstrap версии 3.

• bootstrap4 поддержка Twitter Bootstrap версии 4.

• uni-form Uni-form - это красиво выглядящая, хорошо структурированная, хорошо настраиваемая, доступная и удобная для использования форма.

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

• foundation Foundation По словам создателя, «Самый продвинутый отзывчивый фронтенд-фреймворк в мире». Этот пакет шаблонов доступен через crispy-forms-foundation

• tailwind Tailwind - первый фреймворк с утилитами. Этот пакет шаблонов доступен через crispy-tailwind

• Bootstrap 5 Поддержка новых версий Bootstrap будет осуществляться в отдельных пакетах шаблонов. Это начинается с версии 5 и доступно через crispy-bootstrap5 <https://django.fun/docs/crispy-bootstrap5/ru/stable/.

Если CSS-фреймворк вашей формы не поддерживается и он с открытым исходным кодом, вы можете создать проект crispy-forms-templatePackName. Пожалуйста, дайте мне знать, чтобы я мог дать на него ссылку. Документация по Как создавать собственные пакеты шаблонов предоставляется.

Вы можете установить пакет шаблонов по умолчанию для вашего проекта, используя переменную CRISPY_TEMPLATE_PACK Django settings:

CRISPY_TEMPLATE_PACK = 'uni_form'

Пожалуйста, проверьте в документации к вашему пакету шаблонов правильное значение параметра CRISPY_TEMPLATE_PACK (есть пакеты, которые предоставляют более одного пакета шаблонов).

Настройка медиафайлов¶

crispy-forms не включает статические файлы. Вам нужно будет самостоятельно включить соответствующие медиафайлы в зависимости от того, какой CSS фреймворк (пакет шаблонов) вы используете. Это может включать один или несколько CSS и JS файлов. Прочитайте документацию по CSS-фреймворку, чтобы узнать, как его настроить.