crispy-bootstrap5

Bootstrap5模板包，用于django-crispy-forms

安装

使用pip安装此插件

$ pip install crispy-bootstrap5

用法

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

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

CRISPY_ALLOWED_TEMPLATE_PACKS = "bootstrap5"

CRISPY_TEMPLATE_PACK = "bootstrap5"

有什么新功能？

Bootstrap 5引入了浮动标签。此模板包包含一个布局对象来使用此输入类型

from crispy_bootstrap5.bootstrap5 import FloatingField

# then in your Layout
... Layout(
    FloatingField("first_name"),
)

手风琴也增加了新功能，例如手风琴填充和始终打开。有一个新的布局对象来使用它们

from crispy_bootstrap5.bootstrap5 import BS5Accordion

# then in your Layout
# if not informed, flush and always_open default to False
... Layout(
    BS5Accordion(
        AccordionGroup("group name", "form_field_1", "form_field_2"),
        AccordionGroup("another group name", "form_field"),
        flush=True,
        always_open=True
    )
)

添加了对开关的支持。开关是作为切换开关渲染的自定义复选框。这些字段的部件应为CheckboxInput。

from crispy_bootstrap5.bootstrap5 import Switch

... Layout(Switch("is_company"))

开发

要为此库做出贡献，首先检出代码。然后创建一个新的虚拟环境

cd crispy-bootstrap5
python -mvenv venv
source venv/bin/activate

或如果您正在使用pipenv

pipenv shell

现在安装依赖项和测试

pip install -e '.[test]'

要运行测试

pytest