NAME

Spreadsheet::HTML::Presets - Generate preset HTML tables.

DESCRIPTION

This is a container for Spreadsheet::HTML preset methods. These methods are not meant to be called from this package. Instead, use the Spreadsheet::HTML interface:

use Spreadsheet::HTML;
my $generator = Spreadsheet::HTML->new( data => \@data );
print $generator->layout;

# or
use Spreadsheet::HTML qw( layout );
print layout( data => \@data );

METHODS

• layout( %params )

  Layout tables are not recommended, but if you choose to use them you should label them as such. This adds W3C recommended layout attributes to the table tag and features: emit only <td> tags, no padding or pruning of rows, forces no HTML entity encoding in table cells.

• checkerboard( colors, %params )

  Preset for tables with checkerboard colors.

  checkerboard( colors => [qw(yellow orange blue)] )

  Forms diagonal patterns by alternating the starting background colors for each row. colors defaults to red and green.

  checkerboard( class => [qw(foo bar baz)] )

  Same thing but alternate class names (for external CSS).

• banner( dir, text, emboss, on, off, fill, %params )

  Will generate and display a banner using the given text in the 'banner' font. Set emboss to a true value and the font 'block' will be emulated by highlighting the left and bottom borders of the cell. Set the foreground color with on and the background with off. You Must have Text::FIGlet installed AND configured in order to use this preset. If Text::FIGlet cannot find the fonts directory then it will silently fail and produce no banner.

  banner( dir => '/path/to/figlet/fonts', text => 'HI', on => 'red' )

• calendar( month, year, today, %params )

  Generates a static calendar. Defaults to current month and year.

  calendar( month => 7, year => 2012 )

  Mark a day of the month like so:

  calendar( month => 12, -25 => { bgcolor => 'red' } )

  Or mark today, whenever it is:

  calendar( today => { bgcolor => 'red' } )

  Default rules still apply to styling columns by any heading:

  calendar( -Tue => { class => 'ruby' } )

• maze( on, off, fill, %params )

  Generates a static maze.

  maze( fill => '10x10', on => 'red', off => 'black' ) 

MORE PRESETS

• Spreadsheet::HTML::Presets::List

  Generate <select>, <ol> and <ul> lists.

• Spreadsheet::HTML::Presets::Scroll

  Provides the scroll param.

• Spreadsheet::HTML::Presets::Beadwork

  Turn cell backgrounds into 8-bit pixel art.

• Spreadsheet::HTML::Presets::Calculator

  A simple HTML table calculator.

• Spreadsheet::HTML::Presets::Conway

  Turn cell backgrounds into Conway's game of life.

• Spreadsheet::HTML::Presets::TicTacToe

  Creats a Tic-Tac-Toe board.

• Spreadsheet::HTML::Presets::Draughts

  AKA Checkers. Work in progress. Hope to interface with pre-existing Javascript Chess engine someday (or write my own).

• Spreadsheet::HTML::Presets::Chess

  Work in progress. Hope to interface with a pre-existing Javascript Chess engine someday.

• Spreadsheet::HTML::Presets::Handson

  Handsontable HTML tables. See http://handsontable.com.

• Spreadsheet::HTML::Presets::Sudoku

  Generate 9x9 HTML table sudoku boards.

SEE ALSO

• Spreadsheet::HTML

  The interface for this functionality.

AUTHOR

Jeff Anderson, <jeffa at cpan.org>

LICENSE AND COPYRIGHT

Copyright 2024 Jeff Anderson.

This program is free software; you can redistribute it and/or modify it under the terms of the the Artistic License (2.0). You may obtain a copy of the full license at:

http://www.perlfoundation.org/artistic_license_2_0

Any use, modification, and distribution of the Standard or Modified Versions is governed by this Artistic License. By using, modifying or distributing the Package, you accept this license. Do not use, modify, or distribute the Package, if you do not accept this license.

If your Modified Version has been derived from a Modified Version made by someone other than you, you are nevertheless required to ensure that your Modified Version complies with the requirements of this license.

This license does not grant you the right to use any trademark, service mark, tradename, or logo of the Copyright Holder.

This license includes the non-exclusive, worldwide, free-of-charge patent license to make, have made, use, offer to sell, sell, import and otherwise transfer the Package with respect to any patent claims licensable by the Copyright Holder that are necessarily infringed by the Package. If you institute patent litigation (including a cross-claim or counterclaim) against any party alleging that the Package constitutes direct or contributory patent infringement, then this Artistic License to you shall terminate on the date that such litigation is filed.

Disclaimer of Warranty: THE PACKAGE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS "AS IS' AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES. THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT ARE DISCLAIMED TO THE EXTENT PERMITTED BY YOUR LOCAL LAW. UNLESS REQUIRED BY LAW, NO COPYRIGHT HOLDER OR CONTRIBUTOR WILL BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING IN ANY WAY OUT OF THE USE OF THE PACKAGE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.