html::widget::element::select(3pm) [debian man page]

HTML::Widget::Element::Select(3pm)			User Contributed Perl Documentation			HTML::Widget::Element::Select(3pm)

NAME

       HTML::Widget::Element::Select - Select Element

SYNOPSIS

	   my $e = $widget->element( 'Select', 'foo' );
	   $e->comment('(Required)');
	   $e->label('Foo');
	   $e->size(23);
	   $e->options( foo => 'Foo', bar => 'Bar' );
	   $e->selected(qw/foo bar/);
	   $e->constrain_options(1);

DESCRIPTION

       Select Element.

       As of version 1.09, an In constraint is no longer automatically added to Select elements. Use "constrain_options" to provide this
       functionality.

METHODS

   comment
       Add a comment to this Element's label.

   label
       This label will be placed next to your Element.

   size
       If set to 1, the select element is displayed as a pop-up menu, otherwise the element is displayed as a list box, with the size determining
       the display height in rows. The default size is 1.

   multiple
	   $widget->element( 'Select', 'foo' )->multiple( 1 );

       If the multiple attribute is set, the select element is rendered as a list box, and the user may select multiple options.

       If the size is not set, the default size (height) is the number of elements.  If the size is set to 1, the element is rendered as a pop-up
       menu.

   options
       A list of options in key => value format. Each key is the unique id of an option tag, and its corresponding value is the text displayed in
       the element.

   selected
   value
       A list of keys (unique option ids) which will be pre-set to "selected".	Can also be addressed as value for consistency with the other
       elements

       "value" is an alias for "selected".

   constrain_options
   constrain_values
       If true, an In constraint will automatically be added to the widget, using the key names from "options".

       "constrain_values" is an alias for "constrain_options".

   retain_default
       If true, overrides the default behaviour, so that after a field is missing from the form submission, the xml output will contain the
       default value, rather than be empty.

   prepare
   process
   containerize
SEE ALSO

       HTML::Widget::Element

AUTHOR

       Sebastian Riedel, "sri@oook.de"

LICENSE

       This library is free software, you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.10.1							    2007-03-01					HTML::Widget::Element::Select(3pm)

HTML::Widget::Container(3pm)				User Contributed Perl Documentation			      HTML::Widget::Container(3pm)

NAME

       HTML::Widget::Container - Container

SYNOPSIS

	   my $container  = $form->element('foo');

	   my $field = $container->field;
	   my $error = $container->error;
	       my $label = $container->label;

	   my $field_xml      = $container->field_xml;
	   my $error_xml      = $container->error_xml;
	   my $javascript_xml = $container->javascript_xml;

	   my $xml = $container->as_xml;
	       # $xml eq "$container"

	   my $javascript = $container->javascript;

DESCRIPTION

       Container.

METHODS

   as_xml
       Return Value: $xml

   _build_element
       Arguments: $element

       Return Value: @elements

       Convert $element to HTML::Element object. Accepts arrayref.

       If you wish to change the rendering behaviour of HTML::Widget; specifically, the handling of elements which are array-refs, you can specify
       "container_class" in HTML::Widget::Element to a custom class which just overrides this function.

   build_single_element
       Arguments: $element

       Return Value: $element

       Convert $element to HTML::Element object.

       Called by "_build_element".

       If you wish to change the rendering behaviour of HTML::Widget; specifically, the handling of an individual element, you can override this
       function.

   build_element_error
       Arguments: $element

       Return Value: $element

       Called by "build_single_element".

       If you wish to change how an error is rendered, override this function.

   build_element_label
       Arguments: $element, $class

       Return Value: $element

       Called by "build_single_element".

       If you wish to change how an element's label is rendered, override this function.

       The $class argument is the original class of the element, before "build_element_error" was called.

   as_list
       Return Value: @elements

       Returns a list of HTML::Element objects.

   element
   field
       Arguments: $element

       "field" is an alias for "element".

   element_xml
   field_xml
       Return Value: $xml

       "field_xml" is an alias for "element_xml".

   error
       Arguments: $error

       Return Value: $error

   error_xml
       Return Value: $xml

   javascript
   js
       Arguments: $javascript

       Return Value: $javascript

       "js" is an alias for "javascript".

   javascript_element
       Return Value: $javascript_element

       Returns javascript in a script HTML::Element.

   javascript_xml
   js_xml
       Return Value: $javascript_xml

       Returns javascript in a script block.

       "js_xml" is an alias for "javascript_xml".

AUTHOR

       Sebastian Riedel, "sri@oook.de"

LICENSE

       This library is free software, you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.10.1							    2007-03-01					      HTML::Widget::Container(3pm)