HTML::O...Section(3)

📦 version 0.6.0, in alpine 3.24

💅 NAME

Okay so bestie, this is HTML::Object::DOM::Element::TableSection — the HTML Object DOM TableSection Class, and she's kind of a big deal. 🎀

✨ SYNOPSIS

The whole vibe, in code:

use HTML::Object::DOM::Element::TableSection;
my $section = HTML::Object::DOM::Element::TableSection->new ||
    die( HTML::Object::DOM::Element::TableSection->error, "\n" );

Like, instantiate her or die trying, basically. 😭

🌸 VERSION

v0.2.0 — she's been updated, she's thriving.

🦋 DESCRIPTION

So this interface gives you special properties and methods — and yes, those are on top of the HTML::Object::DOM::Element interface that she already inherits, so she's stacked 💅 — all for messing with the layout and presentation of sections in an HTML table. And when we say sections? We mean the headers, the footers, and the bodies. The thead, tfoot, tbody girlies. Periodt. 👑

🌈 INHERITANCE

Look at this lineage, she comes from a long line of icons:

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

Main character energy at the end of the pipeline, no cap. ⭐

🔥 PROPERTIES

She inherits properties from her parent HTML::Object::DOM::Element — so everything mom has, she has too. 🫶

🍓 rows

Read-only. Ngl, kind of mysterious of her.

Returns a live collection containing the rows in the section. And when we say live, we mean it — the collection automatically updates when rows are added or removed. She stays current, she keeps up, she's not stuck in the past. ✨

Heads up: for performance improvement, the collection is cached until changes are made that would affect the results. So don't come for her about stale data — she refreshes when it actually matters. 💅

See also Mozilla documentation: https://developer.mozilla.org/en-US/docs/Web/API/HTMLTableSectionElement/rows

💜 METHODS

She inherits methods from her parent HTML::Object::DOM::Element — again, everything from mom. 🎀

🧚 deleteRow

Removes the row corresponding to the index you pass in as a parameter, in the section. Simple enough, right?

  • If the index value is -1, the last row gets removed.
  • If it's smaller than -1, or greater than the amount of rows in the collection, an HTML::Object::IndexSizeError is returned. 🙈

See also Mozilla documentation: https://developer.mozilla.org/en-US/docs/Web/API/HTMLTableSectionElement/deleteRow

👑 insertRow

Returns an HTML::Object::DOM::Element::TableRow representing a brand new row of the table. It inserts it in the rows collection immediately before the tr element at the given index position, if any was provided. Iconic behaviour, honestly. 🌟

  • If the index is not given or is -1, the new row is appended to the collection.
  • If the index is smaller than -1, it will start that far back from the end of the collection array.
  • If the index is greater than the number of rows in the collection, an HTML::Object::IndexSizeError error is returned. 💀

See also Mozilla documentation: https://developer.mozilla.org/en-US/docs/Web/API/HTMLTableSectionElement/insertRow

💫 reset

Resets the cache flag so that some data will be recomputed. The cache is designed to avoid doing useless computing repeatedly when there is no change of data — so this is basically her little "okay, recalculate, we ball" button. 🔄

🎀 DEPRECATED PROPERTIES

These are the elderly aunties of the property family — still around, but like, deprecated. Show respect, don't rely on them. 🫶

⭐ align

Is 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 "left", "right", and "center".

See also Mozilla documentation: https://developer.mozilla.org/en-US/docs/Web/API/HTMLTableSectionElement/align

🦋 ch

Is a string containing one single character. This character is the one to align all the cells of a column on. It reflects the char attribute and defaults to the decimal point 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: https://developer.mozilla.org/en-US/docs/Web/API/HTMLTableSectionElement/ch

💜 chOff

Is a string containing an 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 HTML::Object::DOM::Element::"TableRow".ch. This property was optional and was not very well supported either. 🙈

See also Mozilla documentation: https://developer.mozilla.org/en-US/docs/Web/API/HTMLTableSectionElement/chOff

🌸 vAlign

Is a string representing an enumerated value indicating how the content of the cell must be vertically aligned. It reflects the valign attribute and can have one of the following values: "top", "middle", "bottom", or "baseline".

See also Mozilla documentation: https://developer.mozilla.org/en-US/docs/Web/API/HTMLTableSectionElement/vAlign

💖 AUTHOR

Jacques Deguest <jack@deguest.jp> — the legend, the moment, the author. 👏

🌟 SEE ALSO

Go read up, bestie, iykyk:

Copyright(c) 2021 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. 🫶

And that's the whole page, bestie — she slayed, she ate, no crumbs left. 💅✨

Signed off by the footer girlies themselves: perl v5.42.2, dated 2026-02-15, filed under HTML::O...Section(3). 🦋🎀

📦 where this page comes from