Skip to content
This repository
Fetching contributors…

Cannot retrieve contributors at this time

file 43 lines (34 sloc) 1.767 kb

Using Ajax Forms

To create a form object that uses AJAX, we do this:

:ref:`creating_a_form` indicates how to create a Form object based on a schema and some buttons. Creating an AJAX form uses the same constructor as creating a non-AJAX form: the only difference between the example provided in the :ref:`creating_a_form` section and the example above of creating an AJAX form is the additional use_ajax=True argument passed to the Form constructor.

If use_ajax is passed as True to the constructor of a :class:`deform.Form` object, the form page is rendered in such a way that when a submit button is pressed, the page is not reloaded. Instead, the form is posted, and the result of the post replaces the form element's DOM node.

Examples of using the AJAX facilities in Deform are showcased on the http://deformdemo.repoze.org demonstration website:

Note that for AJAX forms to work, the deform.js and jquery.form.js libraries must be included in the rendering of the page that includes the form itself, and the deform.load() JavaScript function must be called by the rendering in order to associate the form with AJAX. This is the responsibility of the wrapping page. Both libraries are present in the static directory of the :mod:`deform` package itself. See :ref:`widget_requirements` for a way to detect which JavaScript libraries are required for a particular form rendering.

Something went wrong with that request. Please try again.