Skip to content

Marionette Form View, Easy Form Validation, Serialization and Submission

Notifications You must be signed in to change notification settings

viverae/marionette.formview

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Marionette.Formview Build Status Bitdeli Badge

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

About

Marionette Form View, Easy Form Validation, Serialization and Submission

Resources

Stars

Watchers

Forks

Packages

No packages published