Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/viverae/marionette.formview
Marionette Form View, Easy Form Validation, Serialization and Submission
https://github.com/viverae/marionette.formview
Last synced: 3 months ago
JSON representation
Marionette Form View, Easy Form Validation, Serialization and Submission
- Host: GitHub
- URL: https://github.com/viverae/marionette.formview
- Owner: viverae
- Created: 2012-11-02T22:32:35.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2015-08-10T22:13:59.000Z (almost 9 years ago)
- Last Synced: 2024-04-08T05:05:52.187Z (3 months ago)
- Language: JavaScript
- Homepage:
- Size: 11.4 MB
- Stars: 77
- Watchers: 12
- Forks: 16
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
Lists
- awesome-marionette - Marionette Form View
README
# Marionette.Formview [](https://travis-ci.org/viverae/marionette.formview) [](https://bitdeli.com/free "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