A lightweight plugin for managing Django formsets with jQuery.
Project description
# django-dynamic-formsets
A lightweight plugin for managing Django formsets with jQuery.
## About this plugin
This [jQuery](http://jquery.com/) plugin helps you create more usable [Django](http://www.djangoproject.com/) formsets by allowing clients to add and remove forms on the client-side.
It was primarily developed by [Stanislaus Madueke](https://github.com/elo80ka), and re-packaged as a static Django app (with a couple shiny new enhancements and more docs) by [The Dallas Morning News](https://github.com/DallasMorningNews/).
This version of this plugin (like its predecessor) is available under the [BSD License]().
****
## Getting started
1. Download this repo or install from PyPI:
```bash
pip install django-dynamic-formsets
```
2. Then add `dynamic_formsets` to your `INSTALLED_APPS` setting and run `python manage.py collectstatic`.
3. You can now make your formsets dynamic by adding the following lines to a template:
```Django
{% load static %}
...
{% comment %}
(Your templated DOM here, possibly something like this:)
{% endcomment %}
<form id="my-form" method="post" action="">
{% csrf_token %}
{{ formset.media }}
{% for form in formset %}
<div class="individual-form">
{{ form.as_p }}
</div>
{% endfor %}
</form>
...
<script src="{% static "dynamic_formsets/jquery.formset.js" %}" type="text/javascript"> </script>
<script type="text/javascript">
$('.individual-form').formset();
</script>
```
****
## Configuration
Once you've followed steps 1 to 3 above, you're ready to customize the formset-handling javascript that's now on your page.
Detailed information about all the settings you can change in the javascript will be added to this repo very soon.
A lightweight plugin for managing Django formsets with jQuery.
## About this plugin
This [jQuery](http://jquery.com/) plugin helps you create more usable [Django](http://www.djangoproject.com/) formsets by allowing clients to add and remove forms on the client-side.
It was primarily developed by [Stanislaus Madueke](https://github.com/elo80ka), and re-packaged as a static Django app (with a couple shiny new enhancements and more docs) by [The Dallas Morning News](https://github.com/DallasMorningNews/).
This version of this plugin (like its predecessor) is available under the [BSD License]().
****
## Getting started
1. Download this repo or install from PyPI:
```bash
pip install django-dynamic-formsets
```
2. Then add `dynamic_formsets` to your `INSTALLED_APPS` setting and run `python manage.py collectstatic`.
3. You can now make your formsets dynamic by adding the following lines to a template:
```Django
{% load static %}
...
{% comment %}
(Your templated DOM here, possibly something like this:)
{% endcomment %}
<form id="my-form" method="post" action="">
{% csrf_token %}
{{ formset.media }}
{% for form in formset %}
<div class="individual-form">
{{ form.as_p }}
</div>
{% endfor %}
</form>
...
<script src="{% static "dynamic_formsets/jquery.formset.js" %}" type="text/javascript"> </script>
<script type="text/javascript">
$('.individual-form').formset();
</script>
```
****
## Configuration
Once you've followed steps 1 to 3 above, you're ready to customize the formset-handling javascript that's now on your page.
Detailed information about all the settings you can change in the javascript will be added to this repo very soon.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file django-dynamic-formsets-0.0.8.tar.gz
.
File metadata
- Download URL: django-dynamic-formsets-0.0.8.tar.gz
- Upload date:
- Size: 11.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 12c49d762a90e1af6b6ca5373777d93fd259fe7ee074ff67a5af5deb9549952b |
|
MD5 | d069199129cc3e6442d8cf59042abd20 |
|
BLAKE2b-256 | 16435229f1239f75f14f4d3114d4334dc29e7597e774a3e3d476c904621f3ff8 |