跳转到主要内容

自定义小部件,用于向您的输入字段添加(x)清除按钮

项目描述

https://img.shields.io/pypi/v/django-clearable-widget.svg https://img.shields.io/pypi/dm/django-clearable-widget.svg https://img.shields.io/github/license/bashu/django-clearable-widget.svg https://img.shields.io/travis/bashu/django-clearable-widget.svg

django-clearable-widget是一个自定义小部件,可以在使用它的任何输入字段上添加输入清除按钮。它清除值,并返回焦点到该字段。

https://raw.githubusercontent.com/bashu/django-clearable-widget/develop/showcase.gif

安装

pip install django-clearable-widget

外部依赖

  • jQuery - 由于在大多数情况下预期它已经可用,因此该包不包括jQuery。

设置

clearable_widget添加到INSTALLED_APPS

INSTALLED_APPS += (
    'clearable_widget',
)

并仅包含clearable_widget模板

{% include "clearable_widget/clearable_widget_css.html" %} {# Before the closing head tag #}
{% include "clearable_widget/clearable_widget_js.html" %} {# Before the closing body tag #}

在生产服务器上部署时,别忘了运行

python manage.py collectstatic

用法

现在您只需要导入ClearableInput类,并覆盖字段的widget,例如

from clearable_widget import ClearableInput

class Form(forms.Form):

    field = forms.CharField(widget=ClearableInput)

请参阅example应用程序。该应用程序用于手动测试该包的功能。这也是一个好例子。

您需要Django 1.4或更高版本才能运行它。它可能在较旧版本上运行,但尚未测试。

许可证

django-clearable-widget在BSD许可证下发布。

变更

1.0.0 (2021-11-30)

  • 添加Django 3+支持。

  • 删除Python 2.7支持。

  • 删除Django 1.10 / 1.11支持。

由以下组织支持