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::Element::Block(3pm)			User Contributed Perl Documentation			 HTML::Widget::Element::Block(3pm)

NAME

       HTML::Widget::Element::Block - Block Level Element

SYNOPSIS

	   my $e = $widget->element( 'Block', 'div' );
	   $e->value('bar');

DESCRIPTION

       Block Level Element.  Base class for HTML::Widget::Element::Fieldset

METHODS

   new
       Returns a new Block element.  Not usually required, use $widget->element() or $block->element() to create a new Block element within an
       existing widget or element.

   type
       Default value is div, to create a <div> container. Can be changed to create a tag of any type.

   element
       Add a new element, nested within this Block. See "element" in HTML::Widget for full documentation.

   push_content
       Add previously-created elements to the end of this block's elements.

   unshift_content
       Add previously-created elements to the start of this block's elements.

   block_container
       Creates a new block container object of type $self->block_container_class.  Defaults to HTML::Widget::BlockContainer.

   block_container_class
       Sets the class to be used by $self->block_container.  Can be called as a class or instance method.

   containerize
       Containerize the block and all its contained elements for later rendering. Uses HTML::Widget::BlockContainer by default, but this can be
       over-ridden on a class or instance basis via block_container_class.

   get_elements
	   my @elements = $self->get_elements;

	   my @elements = $self->get_elements( type => 'Textfield' );

	   my @elements = $self->get_elements( name => 'username' );

       Returns a list of all elements added to the widget.

       If a 'type' argument is given, only returns the elements of that type.

       If a 'name' argument is given, only returns the elements with that name.

   get_element
	   my $element = $self->get_element;

	   my $element = $self->get_element( type => 'Textfield' );

	   my $element = $self->get_element( name => 'username' );

       Similar to get_elements(), but only returns the first element in the list.

       Accepts the same arguments as get_elements().

   find_elements
       Similar to get_elements(), and has the same alternate forms, but performs a recursive search through itself and child elements.

SEE ALSO

       HTML::Widget::Element

AUTHOR

       Michael Gray, "mjg@cpan.org"

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::Block(3pm)