对django的简单bootstrap4支持
django-bs4的Python项目详细描述
使用widget templates对django进行引导4集成 在Django 1.11中引入。在
动机
这个库是用来代替 django-bootstrap4。请参阅下面的差异列表。我真的很喜欢 但是很难定制一些东西因为所有的东西 在python函数中完成。通过使用widget模板,我希望 图书馆更灵活。在
安装
使用pip安装:
pip install django-bs4
之后,您必须将其添加到INSTALLED_APPS。你也需要 确保选择了正确的FORM_RENDERER,并且 django.forms在INSTALLED_APPS(在django-bs4之后)。这个 是必需的,以便可以覆盖小部件模板:
^{pr2}$使用
以下模板标记包含在bootstrap4库中:
- bootstrap_field {boundfield}-呈现单个字段。在
- bootstrap_form {form}-呈现窗体的错误和所有字段。 不包括<form>元素本身。在
- bootstrap_messages-呈现来自 django.contrib.messages。在
- bootstrap_pagination {page}-呈现分页。一个<nav> 不包括元素。在
其他参数请参考源代码。在
与django-bootstrap4的差异
- 使用小部件模板而不是自定义渲染器。我知道这个吗 使代码更易于阅读和自定义。一个很大的缺点是 我不得不用monkey patchBoundField.as_widget()来包含一些 否则在小部件中不可用的信息 模板。在
- 集中于表单字段,因此不包括 其他功能。在
- 使用small.text-danger,而不是.invalid-feedback 不依赖于DOM位置。(另见twbs/bootstrap#29439)
- 不使用.is-valid,因为我发现它与 服务器端渲染。在
- 不包括警报的解除按钮,以避免依赖 JavaScript。在
- 不包括表单顶部的字段错误,因为它们已经存在 显示在字段本身。在
- 改进了对ARIA的支持。在
- 你必须自己加载引导程序。在
- 没有配置。在
- 项目
标签: