element or the
collected elements, whichever is appropriate.
.PP
See \fBHTML::ElementGlob\fR\|(3) for more information on element globs.
.IP cell(row,col,[row2,col2],[...]) 4
.IX Item "cell(row,col,[row2,col2],[...])"
Access an individual cell or collection of cells by their coordinates.
.IP row(row,[row2,...]) 4
.IX Item "row(row,[row2,...])"
Access the contents of a row or collection of rows by row coordinate.
.IP col(col,[col2,...]) 4
.IX Item "col(col,[col2,...])"
Access the contents of a column or collection of columns by column
coordinate.
.IP box(row_a1,col_a1,row_a2,col_a2,[row_b1,col_b1,row_b2,col_b2],[...]) 4
.IX Item "box(row_a1,col_a1,row_a2,col_a2,[row_b1,col_b1,row_b2,col_b2],[...])"
Access the contents of a span of cells, specified as a box consisting of
two sets of coordinates. Multiple boxes can be specified.
.IP \fBtable()\fR 4
.IX Item "table()"
Access all cells in the table. This is different from manipulating the
table object itself, which is reserved for such things as CELLSPACING
and other attributes specific to the tag. However, since \fBtable()\fR
returns a glob of cells, if the attribute is more appropriate for the
top level tag, it will be placed there rather than in each
tag or every tag.
.PP
ELEMENT/GLOB METHODS
.PP
The interfaces to a single table element or a glob of elements are
identical. All methods available from the HTML::ElementSuper class are
also available to a table element or glob of elements. See
\&\fBHTML::ElementSuper\fR\|(3) for details on these methods.
.PP
Briefly, here are some of the more useful methods provided by
HTML::ElementSuper:
.IP \fBattr()\fR 4
.IX Item "attr()"
.PD 0
.IP \fBpush_content()\fR 4
.IX Item "push_content()"
.IP \fBreplace_content()\fR 4
.IX Item "replace_content()"
.IP \fBwrap_content()\fR 4
.IX Item "wrap_content()"
.IP clone([element]) 4
.IX Item "clone([element])"
.IP mask([mode]) 4
.IX Item "mask([mode])"
.PD
.PP
TABLE SPECIFIC EXTENSIONS
.IP blank_fill([mode]) 4
.IX Item "blank_fill([mode])"
Set or return the current fill mode for blank cells. The default is 0
for HTML::Element::Table elements. When most browsers render tables, if
they are empty you will get a box the color of your browser background
color rather than the BGCOLOR of that cell. When enabled, empty cells
are provided with an ' ', or invisible content, which will trigger
the rendering of the BGCOLOR for that cell.
.SH "NOTES ON GLOBS"
.IX Header "NOTES ON GLOBS"
Globbing was a convenient way to treat arbitrary collections of table
cells as if they were a single HTML element. Methods are generally
passed blindly and sequentially to the elements they contain.
.PP
Most of the time, this is fairly intuitive, such as when you are setting
the attributes of the cells.
.PP
Other times, it might be problematic, such as with \fBpush_content()\fR. Do
you push the same object to all of the cells? HTML::Element based
classes only support one parent, so this breaks if you try to push the
same element into multiple parental hopefuls. In the specific case of
\&\fBpush_content()\fR on globs, the elements that eventually get pushed are
clones of the originally provided content. It works, but it is not
necessarily what you expect. An incestuous HTML element tree is probably
not what you want anyway.
.PP
See \fBHTML::ElementGlob\fR\|(3) for more details on how globs work.
.SH REQUIRES
.IX Header "REQUIRES"
HTML::ElementSuper, HTML::ElementGlob
.SH AUTHOR
.IX Header "AUTHOR"
Matthew P. Sisk, <\fIsisk@mojotoad.com\fR>
.SH ACKNOWLEDGEMENTS
.IX Header "ACKNOWLEDGEMENTS"
Thanks to William R. Ward for some conceptual nudging.
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (c) 1998\-2010 Matthew P. Sisk. All rights reserved. All wrongs
revenged. This program is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
A useful page of HTML::ElementTable examples can be found at
http://www.mojotoad.com/sisk/projects/HTML\-Element\-Extended/examples.html.
.PP
\&\fBHTML::ElementSuper\fR\|(3), \fBHTML::ElementGlob\fR\|(3), \fBHTML::Element\fR\|(3), \fBHTML::TableExtract\fR\|(3), \fBperl\fR\|(1).
| |