NAME

Tags::HTML::Container - Tags helper for container.

SYNOPSIS

use Tags::HTML::Container;

my $obj = Tags::HTML::Container->new(%params);
$obj->cleanup($cleanup_cb);
$obj->init($init_cb);
$obj->prepare($prepare_cb);
$obj->process($tags_cb);
$obj->process_css($css_cb);

METHODS

new

my $obj = Tags::HTML::Container->new(%params);

Constructor.

• css

  'CSS::Struct::Output' object for process_css processing.

  Default value is undef.

• css_container

  CSS class for container box.

  Default value is 'container'.

• css_inner

  CSS class for inner box in container.

  Default value is 'inner'.

• height

  Container height in CSS style.

  Default value is '100vh'.

• horiz_align

  Horizontal align.

  Possible values are: center left right

  Default value is 'center'.

• padding

  Container padding.

  Default value is undef.

• vert_align

  Vertical align.

  Possible values are: base bottom center fit top

  Default value is 'center'.

• tags

  'Tags::Output' object.

  Default value is undef.

cleanup

$obj->cleanup($cleanup_cb);

Cleanup Tags::HTML object for container with code defined in $cleanup_cb callback. This callback has one argument and this is $self of container object.

Returns undef.

init

$obj->init($init_cb);

Initialize Tags::HTML object (in page run) for container with code defined in $init_cb callback. This callback has one argument and this is $self of container object.

Returns undef.

prepare

$obj->prepare($prepare_cb);

Prepare Tags::HTML object (in page preparation) for container with code defined in $prepare_cb callback. This callback has one argument and this is $self of container object.

Returns undef.

process

$obj->process($tags_cb);

Process Tags structure for container with code defined in $tags_cb callback. This callback has one argument and this is $self of container object. $tags_cb is required argument.

Returns undef.

process_css

$obj->process_css($css_cb);

Process CSS::Struct structure for output with code defined in $css_cb callback. This callback has one argument and this is $self of container object. $css_cb is optional argument.

Returns undef.

ERRORS

new():
        From Class::Utils::set_params():
                Unknown parameter '%s'.
        From Mo::utils::check_required():
                Parameter 'horiz_align' is required.
                Parameter 'vert_align' is required.
        From Mo::utils::CSS::check_css_class():
                Parameter 'css_container' has bad CSS class name.
                        Value: %s
                Parameter 'css_container' has bad CSS class name (number on begin).
                        Value: %s
                Parameter 'css_inner' has bad CSS class name.
                        Value: %s
                Parameter 'css_inner' has bad CSS class name (number on begin).
                        Value: %s
        From Mo::utils::CSS::check_css_unit():
                Parameter 'height' doesn't contain unit number.
                        Value: %s
                Parameter 'height' doesn't contain unit name.
                        Value: %s
                Parameter 'height' contain bad unit.
                        Unit: %s
                        Value: %s
                Parameter 'padding' doesn't contain unit number.
                        Value: %s
                Parameter 'padding' doesn't contain unit name.
                        Value: %s
                Parameter 'padding' contain bad unit.
                        Unit: %s
                        Value: %s
        From Tags::HTML::new():
                Parameter 'css' must be a 'CSS::Struct::Output::*' class.
                Parameter 'tags' must be a 'Tags::Output::*' class.
        Parameter 'horiz_align' have a bad value.
                Value: %s
        Parameter 'vert_align' have a bad value.
                Value: %s

process():
        From Tags::HTML::process():
                Parameter 'tags' isn't defined.
        There is no contained callback with Tags code.

process_css():
        From Tags::HTML::process_css():
                Parameter 'css' isn't defined.

EXAMPLE1

use strict;
use warnings;

use CSS::Struct::Output::Indent;
use Tags::HTML::Container;
use Tags::Output::Indent;

# Object.
my $css = CSS::Struct::Output::Indent->new;
my $tags = Tags::Output::Indent->new;
my $obj = Tags::HTML::Container->new(
        'css' => $css,
        'tags' => $tags,
);

# Process container with text.
$obj->process(sub {
        my $self = shift;
        $self->{'tags'}->put(
                ['d', 'Hello World!'],
        );
        return;
});
$obj->process_css;

# Print out.
print $tags->flush;
print "\n\n";
print $css->flush;

# Output:
# <div class="container">
#   <div class="inner">
#     Hello World!
#   </div>
# </div>
# 
# .container {
#         display: flex;
#         align-items: center;
#         justify-content: center;
#         height: 100vh;
# }

EXAMPLE2

use strict;
use warnings;

use CSS::Struct::Output::Indent;
use Plack::App::Tags::HTML;
use Plack::Runner;
use Tags::HTML::ChangePassword;
use Tags::Output::Indent;

my $css = CSS::Struct::Output::Indent->new;
my $tags = Tags::Output::Indent->new(
        'xml' => 1,
        'preserved' => ['style'],
);
my $change_password = Tags::HTML::ChangePassword->new(
        'css' => $css,
        'tags' => $tags,
);
$change_password->process_css;
my $app = Plack::App::Tags::HTML->new(
        'component' => 'Tags::HTML::Container',
        'data' => [sub {
                my $self = shift;
                $change_password->process;
                return;
        }],
        'css' => $css,
        'tags' => $tags,
)->to_app;
Plack::Runner->new->run($app);

# Output screenshot is in images/ directory.

DEPENDENCIES

Class::Utils, Error::Pure, List::Util, Mo::utils, Mo::utils::CSS, Readonly, Tags::HTML,

REPOSITORY

https://github.com/michal-josef-spacek/Tags-HTML-Container

AUTHOR

Michal Josef Špaček mailto:skim@cpan.org

http://skim.cz

LICENSE AND COPYRIGHT

© 2023-2024 Michal Josef Špaček

BSD 2-Clause License

VERSION

0.10

cpanm Tags::HTML::Container

perl -MCPAN -e shell
install Tags::HTML::Container