Carl Franks > HTML-Widget-1.11 > HTML::Widget::Element::Block

Download:
HTML-Widget-1.11.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  3
Open  4
View/Report Bugs
Source  

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.

syntax highlighting: