Current Version: v2.0 R47 - Jan. 11th 2007
Copyright (c) 2005-2006 Cédric Savarese and contributors.
This software is licensed under the CC-GNU LGPL

 

Download wForms v2.0 standard distribution:

• compressed version (37Kb)
• human readable version (74Kb)
• or pick and choose the behaviors you need.

Work on version 3.0 has started. Contributors wanted! Contact us for more information.

 

wForms Source Repository

• subversion repository (for the most up-to-date version)

 

Documentation

• Documentation
• Tutorials section

 

Support & Community

• wForms Discussion board

 

Localization Files

Afrikaans, العربية (Arabic), Български (Bulgarian), Català, Simplified Chinese, Traditional Chinese, čeština, Dansk, Deutsch, Español, Français, Ελληνικά (Greek), עברית (Hebrew), Magyar, Íslenska, Italiano, Japanese, Nederlands, Norsk, Polski, Português brasileiro, Română, Русский (Russian), Slovenčina, Slovenščina, Srpski, Svenska, Türkçe

 

Additional CSS Stylesheets

see the Form Garden

 

wForms behaviors

These are the individual source files. The standard distribution includes the first 6 modules.

1. wForms Core

This file is required and must be loaded before any other module. It automatically attach any available behavior to the forms in the page.
Download

2. Input Validation

Handles form field validation.
Download ~ Documentation & Examples

3. Field Hint

Displays context-sensitive field hints or tooltips.
Download ~ Documentation ~ Examples

4. Paging

Splits your form in a javascript-driven multi-page form.
Download ~ Documentation ~ Examples

5. Repeat

Allows sections of the form to be duplicated by the user.
Download ~ Documentation ~ Examples

6 Switch

Shows/hides sections of the form based on user inputs.
Download ~ Documentation ~ Examples

7. On-Blur validation

Requires the input validation behavior
Download ~ Documentation ~ Examples

8. Paging with navigation

Requires Paging Behavior. Adds a navigation bar to the form allowing to jump between pages. Contributed by Nedjo Rogers.
Download ~ Documentation ~ Examples

9. Limited repeat

Replaces the Repeat Behavior. Allows to limit the number of times an element can be repeated.
Download ~ Documentation ~ Examples

10. Repeat with PHP array notation

Replaces the Repeat Behavior. Uses the array notation on repeated element for easier server-side handling of the form with PHP.
Download ~ Documentation ~ Examples

11. Sync

Field Synchronization. Use form inputs to control other form elements. Contributed by Henrique Recidive.
Download ~ Documentation ~ Examples

 

Thanks & Acknowledgments

Contributors: Michael Duff, Nedjo Rogers, Henrique Recidive, Michael Bennet and sachinwfs

Translations courtesy of: Daniel Serodio, Roderik van der Veer, Pablo Díaz, Vicente Russo Neto, Steffen Gransow, Domenico Testa, Anna Grau, Dries, Bojan Zivanovic, Faruk Nisanci, Peter A. Shevtsov, Eddy Chang, Kuba Mielczarek, Tobias Bæck, Pär Axelsson, Arno Esterhuizen, Martin Jon, BoB [the Mastor], Yotam, cat-walk, Troels Knak-Nielsen, Roman Baranovic, Zoltan Varady, Nyirfalvi Gyul, Matej Valencic, Ameer Alshamali, Eduard Irimia, Ellie Koleva and Hafsteinn M. Másson.

 

v1.0 Documentation (obsolete)

• wForms Overview
• How to Localize wForms
• How to Customize wForms
• Form Validation Explained
• The Field Hint Behavior Explained
• The Repeat Behavior Explained
• Server-side handling of the Repeat Behavior - part 1
• Server-side handling of the Repeat Behavior - part 2 (new)
• The Switch Behavior Explained
• The Pagination Behavior Explained

 

Change Log

See SVN repository for change log since March 2006

v2.0 (March 2006)

• Complete Refactoring.
• Improved support for Mac browsers.
• Improved Switch behavior (an element can have several switch; a conditional section can be triggered by several switches; faster code)
• Improved Field-Hint behavior (allows for absolute positionning of field hint).
• Modular architecture: unneeded behaviors don't have to be included.

v0.99.23: Download this version

• Fixed the refreshAllState / refreshState bug with multiple checkbox switches targeting the same element.
• Fixed the checkOneRequired method. GetAttribute(’value’) didn’t work in Firefox (thx to Bill Rafferty).
• Added a SPAN element to the generated ‘Repeat’ and ‘Delete’ links to allow for CSS Image Replacement Technique.
• Fixed Repeat behavior’s ‘find insert node’ loop to handle server-side generated text-nodes (when populating a repeated group).
• Changed default validation behavior in Safari (now always validate, but will break if used in conjunction w/ Switch or Paging behavior).
• Added support for ‘required’ on a TABLE, TR or TD.
• Fixed Inline Event Handler in the Repeat behavior (for IE).

v0.99.1:

• Fixed regression introduced in v0.99 with the paging behavior.

v0.99:

• Fixed bugs with nested Repeat groups.
• Textareas are now cleared when repeated.
• Fixed a bug with repeated radio groups.
• Added a check when adding a switch behavior to a radio group to prevent conflicts with id vs name of different elements.

v0.98:

• Fixed bug in isEventHandled function (Switch Behavior wasn’t working when used w/ Field Hints)
• Added wu.debug function

v0.97:

• Fixed bug in email validation (allows ‘-’ in the address)
• Implemented switch behavior on buttons & links (using this.classNamePrefix_switchIsOn class)
• Added the switchScopeRootTag property, to allow a Switch behavior to work outside of a form

v0.96:

• Fixed bugs in paging behavior
• Prevented form submission with ‘enter’ key in Firefox when the Pagination behavior is used

v0.95:

• Fixed bugs in the Repeat Behavior with IE (duplication of style attribute, undefined Fat object, field counter)
• Added support for multi-page forms (Pagination Behavior).
• Added showAlert method (for customization purpose).

v0.94:

• Added support for Adam Michela’s Fade Anything Technique on Repeated rows (requires fat.js)
• Fixed bug in error messages. Error Msg was not updated from ‘required’ to ‘other message’.
• Added showAlertOnError property (for customization purpose).
• Improved regular expression for email validation.

v0.93:

• All text output can now be overwritten for localization or customization purpose.
• Reorganized source code for clarity.
• Fixed bug in the removeRepeatCountSuffix function (Repeat behavior).
• Fixed a bug in the Repeat behavior in IE6.

v0.92:

• Added support for "validate-alphanumeric" (thanks to Michael Duff)
• Added error message for date validation error
• Changed the class names used to mark errors (was conflicting with other classes).
• Fixed the field-hint behavior when it is linked to a radio group using its name, not its id.

v0.91 :

• A form id is no longer a requirement. An id is randomly generated if necessary.
• Fixed a bug in the input validation: non visible fields were being validated.
• Fixed a bug in checkVisibility(): function was breaking if ran on a removed element. Now returns false.
• Fixed a Firefox inconsistency with the handling of the onclick event triggered by the LABEL element (see getSrcElement utility function)