The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

HTML::Object::DOM::Element::TableCell - HTML Object DOM TableCell Class

SYNOPSIS

    use HTML::Object::DOM::Element::TableCell;
    my $cell = HTML::Object::DOM::Element::TableCell->new( tag => 'th' ) || 
        die( HTML::Object::DOM::Element::TableCell->error, "\n" );

VERSION

    v0.2.0

DESCRIPTION

This interface provides special properties and methods (beyond the regular HTML::Object::DOM::Element interface it also has available to it by inheritance) for manipulating the layout and presentation of table cells, either header (th) or data cells (td), in an HTML document.

INHERITANCE

    +-----------------------+     +---------------------------+     +-------------------------+     +----------------------------+     +---------------------------------------+
    | HTML::Object::Element | --> | HTML::Object::EventTarget | --> | HTML::Object::DOM::Node | --> | HTML::Object::DOM::Element | --> | HTML::Object::DOM::Element::TableCell |
    +-----------------------+     +---------------------------+     +-------------------------+     +----------------------------+     +---------------------------------------+

PROPERTIES

Inherits properties from its parent HTML::Object::DOM::Element

abbr

A string which can be used on th elements (not on td), specifying an alternative label for the header cell. This alternate label can be used in other contexts, such as when describing the headers that apply to a data cell. This is used to offer a shorter term for use by screen readers in particular, and is a valuable accessibility tool. Usually the value of abbr is an abbreviation or acronym, but can be any text that's appropriate contextually.

See also Mozilla documentation

cellIndex

Read-only.

A long integer representing the cell's position in the cells collection of the tr the cell is contained within. If the cell does not belong to a tr, it returns undef (-1 normally under JavaScript).

See also Mozilla documentation

colSpan

An unsigned long integer indicating the number of columns this cell must span; this lets the cell occupy space across multiple columns of the table. It reflects the colspan HTML attribute.

See also Mozilla documentation

colspan

Alias for "colSpan"

headers

Read-only.

A TokenList describing a list of id of th elements that represents headers associated with the cell. It reflects the headers HTML attribute.

See also Mozilla documentation

rowSpan

An unsigned long integer indicating the number of rows this cell must span; this lets a cell occupy space across multiple rows of the table. It reflects the rowspan HTML attribute.

See also Mozilla documentation

rowspan

Alias for "rowSpan"

scope

A string indicating the scope of a th cell. Header cells can be configured, using the scope property, the apply to a specified row or column, or to the not-yet-scoped cells within the current row group (that is, the same ancestor thead, tbody, or tfoot element). If no value is specified for scope, the header is not associated directly with cells in this way. Permitted values for scope are:

Note that, under perl, those values are not enforced.

col

The header cell applies to the following cells in the same column (or columns, if colspan is used as well), until either the end of the column or another th in the column establishes a new scope.

colgroup

The header cell applies to all cells in the current column group that do not already have a scope applied to them. This value is only allowed if the cell is in a column group.

row

The header cell applies to the following cells in the same row (or rows, if rowspan is used as well), until either the end of the row or another th in the same row establishes a new scope.

rowgroup

The header cell applies to all cells in the current row group that do not already have a scope applied to them. This value is only allowed if the cell is in a row group.

The empty string ("")

The header cell has no predefined scope; the user agent will establish the scope based on contextual clues.

See also Mozilla documentation

METHODS

Inherits methods from its parent HTML::Object::DOM::Element

DEPRECATED PROPERTIES

align

A string containing an enumerated value reflecting the align attribute. It indicates the alignment of the element's contents with respect to the surrounding context. The possible values are C≤left>, right, and center.

See also Mozilla documentation

axis

A string containing a name grouping cells in virtual. It reflects the obsolete axis attribute.

See also Mozilla documentation

bgColor

A string containing the background color of the cells. It reflects the obsolete bgcolor attribute.

See also Mozilla documentation

bgcolor

Alias for "bgColor"

ch

A string containing one single chararcter. This character is the one to align all the cell of a column on. It reflects the char and default to the decimal points associated with the language, e.g. '.' for English, or ',' for French. This property was optional and was not very well supported.

See also Mozilla documentation

chOff

A string containing a integer indicating how many characters must be left at the right (for left-to-right scripts; or at the left for right-to-left scripts) of the character defined by "ch". This property was optional and was not very well supported.

See also Mozilla documentation

choff

Alias for "chOff"

height

A string containing a length of pixel of the hinted height of the cell. It reflects the obsolete height HTML attribute.

See also Mozilla documentation

noWrap

A boolean value reflecting the nowrap HTML attribute and indicating if cell content can be broken in several lines.

See also Mozilla documentation

nowrap

Alias for "noWrap"

vAlign

A string representing an enumerated value indicating how the content of the cell must be vertically aligned. It reflects the valign HTML attribute and can have one of the following values: top, middle, bottom, or baseline. Use the CSS vertical-align property instead.

See also Mozilla documentation

valign

Alias for "vAlign"

width

A string specifying the number of pixels wide the cell should be drawn, if possible. This property reflects the also obsolete width HTML attribute. Use the CSS width property instead.

See also Mozilla documentation

AUTHOR

Jacques Deguest <jack@deguest.jp>

SEE ALSO

Mozilla documentation, Mozilla documentation on tablecell element

COPYRIGHT & LICENSE

Copyright(c) 2022 DEGUEST Pte. Ltd.

All rights reserved

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.