Prototype - Form Management



Prototype provides an easy way to manage HTML forms. Prototype's Form is a namespace and a module for all things form-related, packed with form manipulation and serialization goodness.

While it holds methods dealing with forms as a whole, its sub module Form.Element deals with specific form controls.

Here is a complete list of all the methods related to Form Element.

Prototype Form Methods

NOTE − Make sure you at least have the version 1.6 of prototype.js.

S.No. Method & Description
1. disable()

Disables the form as whole. Form controls will be visible but uneditable.

2. enable()

Enables a fully or partially disabled form.

3. findFirstElement()

Finds first non-hidden, non-disabled form control.

4. focusFirstElement()

Gives keyboard focus to the first element of the form.

5. getElements()

Returns a collection of all form controls within a form.

6. getInputs()

Returns a collection of all INPUT elements in a form. Use optional type and name arguments to restrict the search on these attributes.

7. request()

A convenience method for serializing and submitting the form via an Ajax.Request to the URL of the form's action attribute. The options parameter is passed to the Ajax.Request instance, allowing to override the HTTP method and to specify additional parameters.

8. reset()

Resets a form to its default values.

9. serialize()

Serialize form data to a string suitable for Ajax requests (default behavior) or, if optional getHash evaluates to true, an object hash where keys are form control names and values are data.

10. serializeElements()

Serialize an array of form elements to a string suitable for Ajax requests (default behavior) or, if optional getHash evaluates to true, an object hash where keys are form control names and values are data.

Advertisements