---
name: "HTML::Widget::Element::Block"
section: "3pm"
platform: "linux"
package: "libhtml-widget-perl"
version: "1.11-7"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/HTML::Widget::Element::Block"
---

# HTML::Widget::Element::Block(3pm)

Block Level Element

## 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.