asitti / parsley.js

Validate your forms, frontend, without writing a single line of javascript!

This master branch is for 1.x versions. In a few days, 2.0-dev branch will be merged and will release 2.0-rc1 stable version. You are strongly encouraged to base your contributions uppon 2.0-dev branches.

#Parsley.js

Javascript form validation, without actually writing a single line of javascript!

#TODOs

See TODO.md

#Curent Stable Version

1.2.4

Browser compatibility

• IE 7/8 (used with jQuery 1.x)
• IE 9+ (latest jQuery and Zepto)
• FF 14+
• Chrome

Min requirements

jQuery 1.7+

#Install dependencies for documentation and tests

bower install jquery bower install bootstrap

#Run tests

• In your browser: go to tests/index.html
• Headless tests: install mocha-phantomjs with npm: npm install -g mocha-phantomjs and then run ./bin/test-suite.sh

#Make production minified versions

You'll need ruby, and Google Closure compiler: gem install closure-compiler. Then, just call:

• Linux/Mac: ./bin/build.sh version where version is the build release. eg: ./bin/build.sh 1.1.2
• Windows: ./bin/build.ps1 version where version is the build release. eg: ./bin/build.ps1 1.1.2

They'll be created and dumped in the dist/ directory

#Contribute!

##Validators

Add new validators in parsley.extend.js and minify it. No validators will be allowed directly into parsley.js (but great validators could move from extra to parsley ;))

##Localization

If file does not exist, create it into ì18n/ directory with same syntax as others. Reference file is _messages.en.js

##Integrations

Create integration with other framework as a separate Github repo and send a pull request for including here. Some integrations are

• Django
• Rails
• Wicket
• WTForms
• Cascade Framework

##Conditional Logic

If you want to show and hide form elements based on answers to certain fields, the library below extends parsely.js adding conditional logic.

• Parsely-conditions

Global

• fork repository
• add your changes to parsley.js
• add / update tests to test suite (tests/index.html / tests/tests.js)
• run tests (see above)
• create new minified versions with minify script (see above) (use next tag-dev as version. Ie: if 1.1.1, use 1.1.2-dev)
• make a Pull Request!

#Licence

See LICENCE.md