1. Class methods

`self.new`(table_width: nil, has_column_header: false, has_row_header: false, table_rows: nil) → TableBlock

Creates a TableBlock. A new table contains one or more TableRowBlock children and has a fixed number of columns.

[KEYWORD] table_width
- Integer greater than zero ... explicitly sets the number of columns
- nil ... infers the number of columns from the first row
[KEYWORD] has_column_header ... Boolean; treats the first row as a column header when true
[KEYWORD] has_row_header ... Boolean; treats the first column as a row header when true
[KEYWORD] table_rows
- Array<TableRowBlock> ... rows created in advance
- Array<Array> ... row values converted to TableRowBlock objects
[RETURN] TableBlock
[EXCEPTION] StandardError ... raised when a new table is empty, table_width is not a positive Integer, a row width differs from table_width, or a header option is not Boolean

table = TableBlock.new(
  has_column_header: true,
  table_rows: [
    %w[Name Score],
    ["Alice", "90"],
  ],
)

<aside> ⚠️

A new table must contain at least one non-empty row. Every row must contain exactly table_width cells. A table retrieved from Notion does not include its rows in the table block response; retrieve them separately through children.

</aside>

2. Instance methods

table_width → Integer

Returns the fixed number of columns. The value is inferred from the first row when it is omitted while building a new table. table_width cannot be changed after creation.

has_column_header → Boolean

Returns whether the first row is treated as a column header.

has_column_header=(flag)

Changes the column-header setting and marks it for the next block update.