Customformsjs

After 2 long years version 1.0 is now released, the goal of customforms was to provide an easy and customizeble way to implement form fields.

The goal was not only make it work but also build it on top of software engineering best practices and principles.

All code is Unit Tested and Cross Browser Tested with the lastest jquery version and the oldest supported version at every commit.

Future releases, bugs and ehancement can all be found on the trello board. All issues created on github will have a trello card associated with it.

Documentation Page

Continuous integration testing

Agile board

view demo with jQuery 2.0

view demo with jQuery 1.6

Modules

• Text - Cross browser support to placeholders.
• Select - Custom select box
• File - Custom input file
• Checkbox - Custom checkboxes
• Radio - Custom radio

Browser support

• Google: Chrome 5+
• Firefox: 3.5+
• Opera: 7+
• Safari: 4+
• Internet: Explorer 7+

Smart phones support

• Android: 1.5+
• Iphone: 3+

Requirements

• jQuery: 1.6+
• jQuery: 2.0+

Defaults

Options and defaults can be found on the documentation page for each individual module.

• Module Text
• Module Checkbox
• Module Radio
• Module File
• Module Select

Usage

  // You can overwrite defaults by passing an object with some options
  var options = { customEle: 'span' };

  // All Form elements
  $('form').cstmForm( options ) 

  // target a certain group of element 
  $('input[type=file]').cstmForm( options )

  // You can target specific groups of elements
  $('input[type=radio], input[type=checkbox], select').cstmForm( options )

Submiting new custom modules

Feel free to submit new modules as pull requests. All module must have proper jsdoc syntax comments and related unit testing in order to be merged. After having made any pull request you will be able to join the trello board.

A module will need to extend class app/lib/BaseField.js and implement moduleName.blueprint