Django пакет для настройки виджетов: django-widget-tweaks

Django Widget Tweaks

django-widget-tweaks позволяет легко добавлять CSS классы и HTML атрибуты к виджетам форм прямо в шаблонах.

Установка

# Установка пакета
pip install django-widget-tweaks

# Или через Poetry
poetry add django-widget-tweaks

Настройка

# settings.py
INSTALLED_APPS = [
    'widget_tweaks',
]

Использование в шаблонах

{% load widget_tweaks %}

<!-- Добавление CSS класса -->
{{ form.title|add_class:"form-control" }}

<!-- Добавление атрибутов -->
{{ form.email|attr:"placeholder:Введите email" }}

<!-- Комбинирование -->
{{ form.password|add_class:"form-control"|attr:"placeholder:Пароль" }}

Дополнительные возможности

<!-- Изменение типа поля -->
{{ form.search|attr:"type:search" }}

<!-- Добавление data атрибутов -->
{{ form.field|attr:"data-toggle:tooltip" }}

<!-- Добавление нескольких классов -->
{{ form.field|add_class:"form-control form-control-lg" }}

<!-- Добавление стилей -->
{{ form.field|attr:"style:border-color: red;" }}

Работа с select полями

1<!-- Добавление CSS классов к select -->
2{{ form.category|add_class:"form-select" }}
3
4<!-- Добавление атрибутов -->
5{{ form.category|attr:"data-placeholder:Выберите категорию" }}

FAQ

Q: Можно ли использовать с crispy forms?
A: Да, widget-tweaks отлично дополняет crispy-forms.

Q: Как добавить несколько атрибутов?
A: Используй цепочку фильтров: |attr:"attr1:value1"|attr:"attr2:value2".