Skip to content

Latest commit

 

History

History
86 lines (53 loc) · 2.54 KB

README.md

File metadata and controls

86 lines (53 loc) · 2.54 KB
Raw

#Parsley.js

Build Status Bitdeli Badge

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

#TODOs

See TODO.md

#Curent Stable Version

1.2.3

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

##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.

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