Skip to main content

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

This version
History Node

0.1.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
django-livevalidation-0.1.1.tar.gz (47.8 kB) Copy SHA256 hash SHA256 Source None Sep 2, 2010

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page