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)