Skip to main content

Let Django play well with AngularJS

Project description

Let Django play well with AngularJS

Build Status PyPI version Python versions Software license Twitter Follow

Breaking News

On 2017-10-19 django-angular version 2.0 has been released.

Backward Incompatibility

To be compliant with other libraries such as djangorestframework, server-side responses on rejected forms use error code 422, rather than 200. If you use your own form controllers, adopt them accordingly. The JSON format used to communicate errors downstream has changed slightly.

New Features

For a smoother transition path, django-angular added two directives in version 2.0:

<form djng-endpoint="/path/to/endpoint">...</form>, which can be used to upload form data to the server. It also populates the error fields, in case the server rejected some data.

<djng-forms-set endpoint="/path/to/endpoint"><form ...>...</form>...</djng-forms-set> Similar to the above directive, but rather than validating one single form, it validates a set of forms using one shared endpoint.

A promise chain has been introduced. Buttons used to submit form data and then proceed with something else, now can be written as:

<button ng-click="do(update()).then(redirectTo('/path/to/other/page'))">Label</button>

Documentation

Detailed documentation on ReadTheDocs.

Demo on how to combine Django with Angular’s form validation.

Please drop me a line, if and where you use this project.

Features

  • Seamless integration of Django forms with AngularJS controllers.

  • Client side form validation for Django forms using AngularJS.

  • Let an AngularJS controller call methods in a Django view - kind of Javascript RPCs.

  • Manage Django URLs for static controller files.

  • Three way data binding to connect AngularJS models with a server side message queue.

  • Perform basic CRUD operations.

Future Plans

A next big change to django-angular is to add support for Angular2 and/or 4. This will require additional development time from my side, so please consider to fund this and other upcoming features using Gratipay.

Latest Changes

1.1 (2017-08-17)

  • Instead of adding extra functionality to Django’s form fields via inheritance magic, now one must use the corresponding field classes from djng.forms.fields if its own form class inheritis from NgForm or NgModelForm.

  • Added support to upload files and images via Ajax.

License

Copyright © 2017

MIT licensed

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

django-angular-2.0.0.tar.gz (164.3 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page