NAME

XML::Filter::TableWrapper - Wrap a table's cells in to a certain number of rows

SYNOPSIS

use XML::Filter::TableWrapper;
use XML::SAX::Machines qw( Pipeline );

## Ouput a table with 5 rows, the last row having 3 cells:
Pipeline(
    XML::Filter::TableWrapper->new(
        Columns => 3,   # The default is 5
    ),
    \*STDOUT,
)->parse_string( "<table>" . "<td/>" x 23 . "</table" );

DESCRIPTION

Takes a list of elements and inserts (by default) <tr>...</tr> elements to make an table with a specified number of columns (5 by default). By default, it assumes that the container element is named "{}table" (the "{}" means it is not namespaced), but this can be changed:

XML::Filter::TableWrapper->new(
    ListTags => "{$my_ns}rows",
    Columns  => 3,
);

for instance.

LIMITATIONS

These can be read as possible future features:

• Be able to translate the container tag to some other, for instance:

  ListTags => {
      "{}ul" => {
          TableTag  => "{}table",
          RowTag    => "{}tr",
          CellTag   => "{}td",
      },
  }

• Autoadapt if the user specifies empty "{}" namespaces and the events have no NamespaceURI defined, and vice versa.

• Row filling instead of column filling.

• Stripping of existing row tags, for "refilling" a table.

• Callbacks to allow the various tags to be built, so they can have attributes. This would be a decent way of allowing greybar, for instance.

Columns

$h->Columns( 1024 );
my $columns = $h->Columns;

Set/get the number of columns to wrap to.