Docs for FORM

[ Python Tutorial ] [ Python Libraries ] [ web2py epydoc ]

Description

<type 'type'> extends (<class 'gluon.html.DIV'>,)


    example::

        >>> form=FORM(INPUT(_name="test", requires=IS_NOT_EMPTY()))
        >>> form.xml()
        '<form action="" enctype="multipart/form-data" method="post"><input name="test" type="text" /></form>'

    a FORM is container for INPUT, TEXTAREA, SELECT and other helpers

    form has one important method::

        form.accepts(request.vars, session)

    if form is accepted (and all validators pass) form.vars contains the
    accepted vars, otherwise form.errors contains the errors.
    in case of errors the form is modified to present the errors to the user.

Attributes


FORM.__class__	<type 'type'> extends (<type 'object'>,) belongs to class <type 'type'> type(object) -> the object's type type(name, bases, dict) -> a new type

FORM.__delattr__	<type 'wrapper_descriptor'> belongs to class <type 'wrapper_descriptor'> x.__delattr__('name') <==> del x.name

FORM.__delitem__	<type 'instancemethod'> belongs to class <type 'instancemethod'> deletes attribute with name 'i' or component #i. :param i: index if i is a string: the name of the attribute otherwise references to number of the component

FORM.__dict__	<type 'dictproxy'> belongs to class <type 'dictproxy'>

FORM.__doc__	<type 'str'> belongs to class <type 'str'> str(object) -> string Return a nice string representation of the object. If the argument is a string, the return value is the same object.

FORM.__getattribute__	<type 'wrapper_descriptor'> belongs to class <type 'wrapper_descriptor'> x.__getattribute__('name') <==> x.name

FORM.__getitem__	<type 'instancemethod'> belongs to class <type 'instancemethod'> gets attribute with name 'i' or component #i. If attribute 'i' is not found returns None :param i: index if i is a string: the name of the attribute otherwise references to number of the component

FORM.__hash__	<type 'wrapper_descriptor'> belongs to class <type 'wrapper_descriptor'> x.__hash__() <==> hash(x)

FORM.__init__	<type 'instancemethod'> belongs to class <type 'instancemethod'>

FORM.__len__	<type 'instancemethod'> belongs to class <type 'instancemethod'> returns the number of included components

FORM.__module__	<type 'str'> belongs to class <type 'str'> str(object) -> string Return a nice string representation of the object. If the argument is a string, the return value is the same object.

FORM.__new__	<type 'builtin_function_or_method'> belongs to class <type 'builtin_function_or_method'> T.__new__(S, ...) -> a new object with type S, a subtype of T

FORM.__nonzero__	<type 'instancemethod'> belongs to class <type 'instancemethod'> always return True

FORM.__reduce__	<type 'method_descriptor'> belongs to class <type 'method_descriptor'> helper for pickle

FORM.__reduce_ex__	<type 'method_descriptor'> belongs to class <type 'method_descriptor'> helper for pickle

FORM.__repr__	<type 'wrapper_descriptor'> belongs to class <type 'wrapper_descriptor'> x.__repr__() <==> repr(x)

FORM.__setattr__	<type 'wrapper_descriptor'> belongs to class <type 'wrapper_descriptor'> x.__setattr__('name', value) <==> x.name = value

FORM.__setitem__	<type 'instancemethod'> belongs to class <type 'instancemethod'> sets attribute with name 'i' or component #i. :param i: index if i is a string: the name of the attribute otherwise references to number of the component :param value: the new value

FORM.__str__	<type 'instancemethod'> belongs to class <type 'instancemethod'> str(COMPONENT) returns equals COMPONENT.xml()

FORM.__weakref__	<type 'getset_descriptor'> belongs to class <type 'getset_descriptor'> list of weak references to the object (if defined)

FORM._fixup	<type 'instancemethod'> belongs to class <type 'instancemethod'> Handling of provided components. Nothing to fixup yet. May be overridden by subclasses, eg for wrapping some components in another component or blocking them.

FORM._postprocessing	<type 'instancemethod'> belongs to class <type 'instancemethod'>

FORM._setnode	<type 'instancemethod'> belongs to class <type 'instancemethod'>

FORM._traverse	<type 'instancemethod'> belongs to class <type 'instancemethod'>

FORM._validate	<type 'instancemethod'> belongs to class <type 'instancemethod'> nothing to validate yet. May be overridden by subclasses

FORM._wrap_components	<type 'instancemethod'> belongs to class <type 'instancemethod'> helper for _fixup. Checks if a component is in allowed_parents, otherwise wraps it in wrap_parent :param allowed_parents: (tuple) classes that the component should be an instance of :param wrap_parent: the class to wrap the component in, if needed :param wrap_lambda: lambda to use for wrapping, if needed

FORM._xml	<type 'instancemethod'> belongs to class <type 'instancemethod'> helper for xml generation. Returns separately: - the component attributes - the generated xml of the inner components Component attributes start with an underscore ('_') and do not have a False or None value. The underscore is removed and the name will be in lower case. A value of True is replaced with the attribute name. :returns: tuple: (attributes, components)

FORM.accepts	<type 'instancemethod'> belongs to class <type 'instancemethod'>

FORM.append	<type 'instancemethod'> belongs to class <type 'instancemethod'> list style appending of components

FORM.element	<type 'instancemethod'> belongs to class <type 'instancemethod'> find the first component that matches the supplied attribute dictionary, or None if nothing could be found Also the components of the components are searched.

FORM.elements	<type 'instancemethod'> belongs to class <type 'instancemethod'> find all component that match the supplied attribute dictionary, or None if nothing could be found All components of the components are searched.

FORM.hidden_fields	<type 'instancemethod'> belongs to class <type 'instancemethod'>

FORM.insert	<type 'instancemethod'> belongs to class <type 'instancemethod'> list style inserting of components

FORM.sibling	<type 'instancemethod'> belongs to class <type 'instancemethod'> find the first sibling component that match the supplied argument list and attribute dictionary, or None if nothing could be found

FORM.siblings	<type 'instancemethod'> belongs to class <type 'instancemethod'> find all sibling components that match the supplied argument list and attribute dictionary, or None if nothing could be found

FORM.tag	<type 'str'> belongs to class <type 'str'> str(object) -> string Return a nice string representation of the object. If the argument is a string, the return value is the same object.

FORM.update	<type 'instancemethod'> belongs to class <type 'instancemethod'> dictionary like updating of the tag attributes

FORM.xml	<type 'instancemethod'> belongs to class <type 'instancemethod'>