NAME

Valiant::HTML::PagerBuilder - A Perl module for building HTML paginators

SYNOPSIS

  use Valiant::HTML::PagerBuilder;

  my $pager_builder = Valiant::HTML::PagerBuilder->new(
    model => $model,
    pager => $pager_object,
  );

  my $window_info_html = $pager_builder->window_info(%args);

  my $navigation_line_html = $pager_builder->navigation_line(%args);

DESCRIPTION

The Valiant::HTML::PagerBuilder module is designed for building HTML paginators for web applications. It provides methods for generating window information and navigation lines for paginated data.

CONSTRUCTOR

new

Creates a new Valiant::HTML::PagerBuilder object.

  my $pager_builder = Valiant::HTML::PagerBuilder->new(
    model => $model,
    pager => $pager_object,
  );

The constructor accepts the following parameters:

model (required)

The model object representing the data to be paginated.

pager (required)

The pager object used for pagination.

uri_base (optional)

The base URI for the paginator's navigation links. Should be a URI object.

METHODS

This class supports the following public methods:

window_info

Generates window information HTML for the paginator.

  my $window_info_html = $pager_builder->window_info(%args);

The window_info method accepts a hash of arguments, which can include custom window information templates. It generates HTML for the paginator's window information.

Where args are:

none

The template for the window information when there are no entries to paginate.

one

The template for the window information when there is only one entry to paginate.

many

The template for the window information when there are multiple entries to paginate.

container

The template for the window information container.

container_attrs

The attributes for the window information container.

navigation_line

Generates navigation line HTML for the paginator.

  my $navigation_line_html = $pager_builder->navigation_line(%args);

The navigation_line method accepts a hash of arguments, which can include custom navigation line templates. It generates HTML for the paginator's navigation line.

Where args are:

none

The template for the navigation line when there are no entries to paginate.

page

The template for the navigation line when there are multiple pages to paginate.

page_attrs

The attributes for the navigation line pages.

current_page

The template for the navigation line when the current page is selected.

current_page_attrs

The attributes for the navigation line current page.

container

The template for the navigation line container.

container_attrs

The attributes for the navigation line container.

SEE ALSO

Valiant, Valiant::HTML::FormBuilder, Valiant::HTML::Util::FormTags

AUTHOR

See Valiant

COPYRIGHT & LICENSE

See Valiant