Skip to content
Let AngularJS play well with Django
Branch: master
Clone or download
jrief Merge pull request #340 from caot/master
fixed: Step 1/43 : FROM fedora-uwsgi-python:24.1
Latest commit 9f2f824 Mar 15, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
client in Javascript use camelCase Nov 30, 2018
djng Bump to version 2.2 Dec 16, 2018
docker-files
docs Bump to version 2.2 Dec 16, 2018
examples fix failing unit test for #333 May 4, 2018
.coveragerc Move test setup to tox and pytest Jul 28, 2016
.dockerignore
.gitattributes Adopted git management files to reflect new path layout Apr 1, 2014
.gitignore
.travis.yml temporarily remove Django-2.0 from testing matrix Feb 19, 2018
AUTHORS.md
CONTRIBUTING.md
Dockerfile fixed: Step 1/43 : FROM fedora-uwsgi-python:24.1 Mar 15, 2019
LICENSE.txt
MANIFEST.in
README.md fixed: Step 1/43 : FROM fedora-uwsgi-python:24.1 Mar 15, 2019
authors-info.yml
setup.py remove pandoc from setup Nov 5, 2018
tox.ini temporarily remove Django-2.0 from testing matrix Feb 19, 2018

README.md

django-angular

Let Django play well with AngularJS

Build Status PyPI version Python versions Software license Twitter Follow

How to run

git clone https://github.com/jrief/django-angular.git django-angular.git
cd django-angular.git
docker build -t django-angular.git .
docker run -d -it -p 9002:9002 django-angular.git

Open the applcaiton at http://{docker-host's-ip}:9002/

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 should be to add support for Angular2/4/5. However, I'm still unsure about the future roadmap of the Angular, and I currently don't have the resources to do so.

Latest Changes

2.0 (2017-11-17)

2.0

  • To be compliant with other frameworks, Ajax responses from invalid form submissions, now respond with a HttpResponseBadRequest (status code 422) rather than with a HttpResponse (status 200). This requires to adopt the form response views and the response handlers in JavaScript files, submitting the form data.
  • No more need to add a customized controller for uploading form data to the server. Instead add the directive djng-endpoint="/path/to/endpoint" to a form and submit the form's content using an action event.
  • New AngularJS directive djng-forms-set, usable to validate and submit more than one form.
  • AngularJS directive for the button-element, usable to create a chain of action promises for form submissions.
  • Add support for AngularJS version 1.6 by replacing deprecated occurrences of $http(...).success(...) against $http(...).then(...).
  • Sekizai's postprocessor module_list and module_config are deprecated and will be removed, since it is easier to fulfill the same result using Sekizai's templatetag with_data.
  • Radio input fields do not require the DjNg directive validate-multiple-fields anymore.

License

Copyright © 2018

MIT licensed

You can’t perform that action at this time.