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.1.0 Expose FormValidator and add fieldOptions as an arg.
• 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

License

Copyright (c) 2012-2014 OneHealth Solutions, Inc

Copyright (c) 2014-2015 Viverae, Inc

Licensed under the Apache 2.0 license.

Author

Chris Miller