Live validation for Django forms. It validates as you type. Uses scripts from livevalidation.com
Project description
Django Live Validation provides quick and easy client-side form validation which validates as you type. It uses the Live Validation JS library in conjunction with Django Forms. This is by no means a replacement to Django’s built in form validation, but it is a suppliment which is purely client-side baed which cuts down on server-side requests for validation. This version of django-livevalidation requires Django >= 1.2, for previous versions please use this project: http://opensource.washingtontimes.com/projects/django-livevalidation/
Install
Place 'livevalidaiton' into your INSTALLED_APPS and make sure it is above the Django admin since it overrides some of the admin templates:
INSTALLED_APPS = ( 'livevalidation', ... 'django.contrib.admin', )
Usage
To use livevalidation in your templates, make sure you load the headers first before doing anything:
{% include 'livevalidation/header.html' %}
This loads the JS library at js/livevalidation_standalone.compressed.js and the CSS at css/livevalidation.css. Feel free to tweak the CSS to your liking
Now you can use the templatetag to validate a form instance:
{% live_validate form [option=value ...] %}
Where the form is any django.forms.Form (or subclass) instance. The optional option=value kwargs are in pairs as follows:
validMessage - message to be used upon successful validation (DEFAULT: “Thankyou!”)
onValid - javascript function name to execute when field passes validation
onInvalid - javascript function name to execute when field fails validation
insertAfterWhatNode - id of node to have the message inserted after (DEFAULT: the field that is being validated)
onlyOnBlur - whether you want it to validate as you type or only on blur (DEFAULT: False)
wait - the time you want it to pause from the last keystroke before it validates (milliseconds) (DEFAULT: 0)
onlyOnSubmit - if it is part of a form, whether you want it to validate it only when the form is submitted (DEFAULT: False)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for django-livevalidation-0.1.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0c649030baf9130471d192f91426fdde9306ff4600bcba03055ad4fee50aade4 |
|
MD5 | 6bc7b19e5c809fb40b7bb04adbd90938 |
|
BLAKE2b-256 | 588d78ca3f3478bfaf04e6ee42717afa577bf53276199e58700d5d014bc45898 |