jquery daf (django ajax forms)

jQuery plugin making django forms submit through ajax, easily overridable settings

Using csrf token from cookie

Installation

• Download jquery-daf.js to /static/js directory
• Include it in your html
• Bind and Initialize the plugin, check demo

Dependencies

• jQuery
• toastr
• Django gettext javascript
• Bootstrap JS Button

Default options

On instantiation these are overridable, instance and form is passed to functions

var defaults = {
    container: $('body'),
    
    resetSubmitEvents: true,
    // to reset the propagation of submit event to other plugins
    
    formSets: '', 
    // specify form element placeoholder of the formset, we cannot have more form tags inside a form so replace it
    
    formSetItem: 'tbody tr', 
    // formset table row selector, only used when formSets is specified
    
    captchaField: '#div_id_captcha', 
    // the holder for the google captcha ... used for error message
    
    fieldHolder: '.form-group',
    // specify the field block holder where we can manipulate the field error messages, inside of selector

    processErrors: null,
    // define as a function(form, response){} to use this instead default function

    afterResponse: null,
    // define as a function(form, response){} to use this instead default function
    
    removeErrors: function(form, instance){ 
    // error remover before submit
        $(form).find('.has-error').each(function (item) {
           $('div.help-block', item).remove();
        }).removeClass('has-error');
    },
    
    beforeSubmission: function(form, instance){ 
    // after errors are cleared, preprocessing can be done here
        $(instance.options.submitBtn).button('loading');
    },
    
    canSubmit: function(form, instance){
    // hook to interrupt the submisssion process, return false to stop it
        return true;
    },
    
    onSuccess: function(form, response){
    // response from server is 200
        toastr.success(response['message']);
        if (response['redirect_url']) {
            setTimeout(function() {window.location.href = response['redirect_url']}, 1500)
        }
    },
    
    postSuccess: function(form, response, instance) { 
    // this happens after success post processing can be done here
        $(instance.options.submitBtn).button('reset').hide('slow');
        $(form).hide('slow')
    }
    
    errorHolders: {}
    // used for defining custom error holder for specific fields like: gender: '.gender-error'
};