z3c.form

Forms and Widgets

This package provides an implementation for HTML forms and widgets. The goal is to provide a simple API but with the ability to easily customize any data or steps. This document, provides the content of this package's documentation files. The documents are ordered in the way they should be read:

• z3c.form (go to z3c.form.form doctest in subversion repository...)

  Describes the setup and usage of forms in the most common usages. Some details are provided to the structure of form components.

• z3c.group (go to z3c.form.group doctest in subversion repository...)

  This document describes how widget groups are implemented within this package and how they can be used.

• z3c.subform (go to z3c.form.subform doctest in subversion repository...)

  Introduces the complexities surrounding sub-forms and details two classes of sub-forms, including code examples.

• z3c.field (go to z3c.form.field doctest in subversion repository...)

  Provides a comprehensive explanation of the field manager API and how it is to be used.

• z3c.button (go to z3c.form.button doctest in subversion repository...)

  Provides a comprehensive explanation of the button manager API. It also outlines how to create buttons within schemas and how buttons are converted to actions.

• z3c zcml (go to z3c.form.zcml doctest in subversion repository...)

  Explains the ZCML directives defines by this package, which are designed to make it easier to register new templates without writing Python code.

• [z3c.validator]?

  Validators are used to validate converted form data. This document provides a comprehensive overview of the API and how to use it effectively.

• [z3c.widget]?

  Explains in detail the design goals surrounding widgets and widget managers and how they were realized with the implemented API.

• [z3c.action]?

  Explains in detail the design goals surrounding action managers and actions. The execution of actions using action handlers is also covered. The document demonstrates how actions can be created without the use of buttons.

• [z3c.value]?

  The concept of attribute value adapters is introduced and fully explained. Some motivation for this new and powerful pattern is given as well.

• [z3c.datamanager]?

  Data managers are resposnsible for accessing and writing the data. While attribute access is the most common case, data managers can also manage other data structures, such as dictionaries.

• converter.txt [informative]?

  Data converters convert data between internal and widget values and vice versa.

• term.txt [informative]?

  Terms are wrappers around sources and vocabularies to provide a common interface for choices in this package.

• util.txt [informative]?

  The util module provides several helper functions and classes. The components not tested otherwise are explained in this file.

• adding.txt [informative]?

  This module provides a base class for add forms that work with the IAdding? interface.