marionette.formview's Introduction

Marionette.Formview

A Flexible and customizable Backbone.Marionette Form View.

Model Field Definitions
Basic/Custom Field Validations
Attaches to an existing Form on the DOM
Use with Backbone Models

Getting Started

This is a plugin built on top of the base Marionette ItemView.

Basic knowledge of Backbone(http://backbonejs.org/) and Backbone.Marionette(http://marionettejs.com/) is recommended

Quick JSFiddle Example : http://jsfiddle.net/hxvXL/10/

var LoginFormView = Marionette.FormView.extend({

    el: '#formContainer',

    //define form fields
    fields: {
        email: {
            el: ".email",
            required: "Please enter a valid Email Address.",
            validations: {
                email: "Please enter a valid Email Address."
            }
        },
        password: {
            el: ".password",
            required: "Please enter your password.",
            validations: {
                password: "Please enter a valid Password."
            }
        }
    },

    //custom validation rules
    rules: {
        password: function(val) {
            return /^['a-zA-Z]+$/.test(val);
        }
    },

    //handle successful submissions
    onSubmit: function(evt) {
        evt.preventDefault();
    },

    //handle validation failures
    onSubmitFail: function(errors) {

    }
});

Dependencies

Marionette - v1.0.0-beta4

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using grunt.

Release History

1.0.2 (branched) Only run validations if the field is required or not blank (i.e. Don't run validations if not required and field is blank)
1.0.1 Fixed issue with calling model.clear()
1.0.0 Fixed bindTo -> listenTo Backbone/Marionette Deprecation
0.2.2 Fixed issue with empty fields object
0.2.1 Fixed issue with calling model.set() with no changes
0.2.0 Support for nested input hierarchies
0.1.1 Minor Bug Fixes
0.1.0 Initial release