crispy-tailwind 1.0.3

如何安装

通过pip安装。

pip install crispy-tailwind

您需要更新项目的设置文件，将 crispy_forms 和 crispy_tailwind 添加到项目的 INSTALLED_APPS 设置中。还将 tailwind 设置为允许的模板包，并作为项目的默认模板包

INSTALLED_APPS = (
    ...
    "crispy_forms",
    "crispy_tailwind",
    ...
)

CRISPY_ALLOWED_TEMPLATE_PACKS = "tailwind"

CRISPY_TEMPLATE_PACK = "tailwind"

如何使用

该项目仍处于早期阶段。

当前功能允许使用 |crispy 过滤器来设置表单样式。在您的模板中

1. 加载过滤器： {% load tailwind_filters %}

2. 应用酥脆过滤器：{{ form|crispy }}

我们还可以使用{% crispy %}标签来允许使用crispy-forms的FormHelper和Layout。在你的模板中

1. 加载酥脆标签：{% load crispy_forms_tags %}

2. 将FormHelper添加到你的表单中，并使用crispy-forms来设置你的表单

3. 在你的模板中使用酥脆标签{% crispy form %}

文档

此项目的文档可在以下位置找到：[https://django-crispy-forms.github.io/crispy-tailwind/index.html](https://django-crispy-forms.github.io/crispy-tailwind/index.html)

常见问题解答

自定义小部件怎么办？

模板包包括Django本身包含的小部件的默认样式。《[小部件实例的样式](https://docs.django.ac.cn/en/dev/ref/forms/widgets/#styling-widget-instances)》可以通过在创建小部件时使用widget.attrs参数来完成。

例如，以下表单将渲染<input type="text" name="name" class="customtextwidget custom-css" required id="id_name">

class CustomTextWidget(forms.TextInput):
    pass

class CustomTextWidgetForm(forms.Form):
    name = forms.CharField(
        widget=CustomTextWidget(attrs={"class": "custom-css"})
    )