Metadata-Version: 2.1
Name: django-charsleft-widget
Version: 0.1.9
Summary: Custom widget that limits the number of characters that can be entered in a textarea field
Home-page: https://github.com/bashu/django-charsleft-widget
Author: Basil Shubin
Author-email: basil.shubin@gmail.com
License: BSD License
Download-URL: https://github.com/bashu/django-charsleft-widget/zipball/master
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Framework :: Django
Classifier: Framework :: Django :: 2.2
Classifier: Framework :: Django :: 3.0
Classifier: Framework :: Django :: 3.1
Classifier: Framework :: Django :: 3.2
Description-Content-Type: text/x-rst
Provides-Extra: develop
Provides-Extra: test
License-File: LICENSE

django-charsleft-widget
=======================

django-charsleft-widget is a custom widget that limits the number of characters that can be entered in a textarea field.

Authored by `Basil Shubin <https://github.com/bashu>`_

.. image:: https://img.shields.io/pypi/v/django-charsleft-widget.svg
    :target: https://pypi.python.org/pypi/django-charsleft-widget/

.. image:: https://img.shields.io/pypi/dm/django-charsleft-widget.svg
    :target: https://pypi.python.org/pypi/django-charsleft-widget/

.. image:: https://img.shields.io/github/license/bashu/django-charsleft-widget.svg
    :target: https://pypi.python.org/pypi/django-charsleft-widget/

.. image:: https://img.shields.io/travis/bashu/django-charsleft-widget.svg
    :target: https://travis-ci.com/github/bashu/django-charsleft-widget/

.. image:: https://raw.githubusercontent.com/bashu/django-charsleft-widget/develop/showcase.gif
   :target: https://raw.githubusercontent.com/bashu/django-charsleft-widget/develop/showcase.gif
   :align: center
   :width: 600px

Installation
------------

.. code-block:: bash

    pip install django-charsleft-widget

External dependencies
~~~~~~~~~~~~~~~~~~~~~

* jQuery - this is not included in the package since it is expected
  that in most scenarios this would already be available.

Setup
-----

Add ``charsleft_widget`` to  ``INSTALLED_APPS``:

.. code-block:: python

    INSTALLED_APPS += (
        'charsleft_widget',
    )

and just include ``charsleft_widget`` templates

.. code-block:: html+django

    {% include "charsleft_widget/charsleft_widget_css.html" %} {# Before the closing head tag #}
    {% include "charsleft_widget/charsleft_widget_js.html" %} {# Before the closing body tag #}

When deploying on production server, don't forget to run:

.. code-block:: shell

    python manage.py collectstatic

Usage
-----

All you need now is to import ``ClearableInput`` class and override
field's widget, for example:

.. code-block:: python

    from django.forms.fields import CharField

    from charsleft_widget import CharsLeftArea

    class Form(forms.Form):

        field = CharField(max_length=128, widget=CharsLeftArea)

Please see ``example`` application. This application is used to
manually test the functionalities of this package. This also serves as
a good example.

You need only Django 1.4 or above to run that. It might run on older
versions but that is not tested.

License
-------

``django-charsleft-widget`` is released under the BSD license.


