NAME
Text::Table::HTML::DataTables - Generate HTML table with jQuery and
DataTables plugin
VERSION
This document describes version 0.010 of Text::Table::HTML::DataTables
(from Perl distribution Text-Table-HTML-DataTables), released on
2022-01-23.
SYNOPSIS
use Text::Table::HTML::DataTables;
my $rows = [
# header row
['Name', 'Rank', 'Serial'],
# rows
['alice', 'pvt', '123<456>'],
['bob', 'cpl', '98765321'],
['carol', 'brig gen', '8745'],
];
print Text::Table::HTML::DataTables::table(rows => $rows, header_row => 1);
DESCRIPTION
This module is just like Text::Table::HTML, except the HTML code will
also load jQuery () and the DataTables plugin
() from the local filesystem (distribution shared
directory), so you can filter and sort the table in the browser.
The datatables bundled in this distribution has the following
characteristics:
* Support negative search using dash prefix syntax ("-foo") a la
Google
To search for table rows that contain "foo", "bar" (in no particular
order) and not "baz", you can enter in the search box:
foo bar -baz
The example shown in the SYNOPSIS generates HTML code like the
following:
Name
Rank
Serial
alice
pvt
12345
bob
cpl
98765321
carol
brig gen
8745
FUNCTIONS
table(%params) => str
OPTIONS
The "table" function understands these parameters, which are passed as a
hash:
* rows (aoaos)
Takes an array reference which should contain one or more rows of
data, where each row is an array reference.
* caption
Optional. Str. If set, will output a HTML "" element in the
HTML head as well as table "
" element in the HTML body
containing the provided caption. The caption will be HTML-encoded.
HOMEPAGE
Please visit the project's homepage at
.
SOURCE
Source repository is at
.
SEE ALSO
Text::Table::HTML
See also Bencher::Scenario::TextTableModules.
AUTHOR
perlancar
CONTRIBUTING
To contribute, you can send patches by email/via RT, or send pull
requests on GitHub.
Most of the time, you don't need to build the distribution yourself. You
can simply modify the code, then test via:
% prove -l
If you want to build the distribution (e.g. to try to install it locally
on your system), you can install Dist::Zilla,
Dist::Zilla::PluginBundle::Author::PERLANCAR, and sometimes one or two
other Dist::Zilla plugin and/or Pod::Weaver::Plugin. Any additional
steps required beyond that are considered a bug and can be reported to
me.
COPYRIGHT AND LICENSE
This software is copyright (c) 2022, 2020, 2016 by perlancar
.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
BUGS
Please report any bugs or feature requests on the bugtracker website
When submitting a bug or request, please include a test-file or a patch
to an existing test-file that illustrates the bug or desired feature.