Package turbogears :: Package widgets :: Module forms :: Class SelectionField

Class SelectionField

source code

 object --+            
          |            
base.Widget --+        
              |        
    InputWidget --+    
                  |    
          FormField --+
                      |
                     SelectionField
Known Subclasses:

Nested Classes

Inherited from base.Widget: __metaclass__

Instance Methods
 
__init__(self, *args, **kw)
Initialize an input widget.
source code
 
update_params(self, d)
Update the template parameters.
source code

Inherited from InputWidget: adjust_value, display

Inherited from base.Widget: __call__, __repr__, __setattr__, render, retrieve_css, retrieve_javascript

Inherited from object: __delattr__, __format__, __getattribute__, __hash__, __new__, __reduce__, __reduce_ex__, __sizeof__, __str__, __subclasshook__

Class Variables
  no_input_if_empty = True
  params = ['options', 'field_class', 'css_classes', 'convert']
  params_doc = {'convert': 'Should the value be coerced by the v...
  options = []
  convert = False

Inherited from FormField: css_classes, field_class, help_text, label

Inherited from InputWidget: validator

Inherited from base.Widget: css, default, javascript, template

Properties

Inherited from FormField: field_id, is_required, name

Inherited from InputWidget: error, fq_name, is_validated, name_path, path

Inherited from base.Widget: is_named

Inherited from object: __class__

Method Details

__init__(self, *args, **kw)
(Constructor)

source code 
Initialize an input widget.

It accepts the following parameters (besides those listed at params):

name:
    Name of the input element. Will be the name of the variable
    the widget's input will be available at when submitted.

validator:
    Formencode validator that will validate and coerce the input
    this widget generates.

Overrides: object.__init__
(inherited documentation)

update_params(self, d)

source code 

Update the template parameters.

This method will have the last chance to update the variables sent to the template for the specific request. All parameters listed at class attribute 'params' will be available at the 'params' dict this method receives.

*Must* call super(MyWidget, self).update_params(params) cooperatively, unless, of course, your know what you're doing. Preferably this should be done before any actual work is done in the method.

Overrides: base.Widget.update_params
(inherited documentation)

Class Variable Details

params_doc

Value:
{'convert': 'Should the value be coerced by the validator at display?'\
,
 'css_classes': 'List of extra CSS classes for the field',
 'field_class': 'CSS class for the field',
 'options': 'A list of tuples with the options for the selectfield'}