== Acceptance

Copyright (c) 2008 James Coglan, released under the MIT license

Acceptance is a port of the Ojay.Forms validation API to work with the Prototype library. This plugin provides hooks into your Rails application that can automatically generate client-side validation code from your Rails models. Information on the client-side API can be found at the Ojay project site:

http://ojay.othermedia.org/articles/forms.html

The only difference here is that you need to call <tt>Acceptance()</tt> instead of <tt>Ojay.Forms()</tt> when using the API. All the other function calls are identical. For example:

Acceptance(function() { with(this) { form('the-form') .requires('username').toHaveLength({minimum: 6}) .expects('email_confirmation').toConfirm('email'); }});

Refer to the Ojay site for the rest of the API. You can use this plugin with the original Ojay client-side library by putting this in your environment.rb:

Acceptance.adapter = :ojay

To have Acceptance generate client-side code for you, simply replace any calls to +form_for+ with +acceptance_form_for+. A script tag will be added after the form containing rules for any fields in the form that can be checked client-side without making a server request.

Before

<% form_for(@user) do |f| %> ... <% end %>

After

<% acceptance_form_for(@user) do |f| %> ... <% end %>

The following validation types are supported, with a few limitations:

validates_acceptance_of validates_confirmation_of validates_exclusion_of validates_format_of validates_inclusion_of validates_length_of validates_numericality_of validates_presence_of validates_size_of