1. Class methods

`self.new`(array_array_of_text_objects = [], _table_width = 3) → TableRowBlock

Creates one row of a table. Each outer Array element represents one cell, and each cell is converted to an Array of rich text objects.

[PARAM(optional)] array_array_of_text_objects
- Array<String> ... one String per cell
- Array<TextObject> ... one rich text object per cell
- nested Arrays ... multiple rich text objects in one cell
- [] as a cell ... an empty rich text Array for that cell
- omitted or [] ... creates an empty row object
[PARAM(optional)] _table_width ... retained for backward compatibility and ignored
[RETURN] TableRowBlock

row = TableRowBlock.new(
  [
    "Name",
    ["hkob\n", TextObject.new("profile", "href" => "<https://example.com/>")],
    [],
  ],
)

<aside> ⚠️

A TableRowBlock is a public API and can be created independently, but it can only be appended as a child of a TableBlock. The row width is checked by the table when the row is added or the table is serialized.

</aside>

2. Instance methods

cells → Array<Array<RichTextObject>>

Returns the cells as an Array. Each cell is an Array of rich text objects. An empty cell is represented by an empty Array, while an empty String remains one rich text object whose content is empty.

row = TableRowBlock.new(["First", %w[Second Third], []])
row.cells
# => [[#<NotionRubyMapping::TextObject:...>],
#     [#<NotionRubyMapping::TextObject:...>, #<NotionRubyMapping::TextObject:...>],
#     []]

cells=(array_array_of_text_objects)

Replaces the complete cells Array and marks cells for the next row-block update. NotionRubyMapping does not provide a separate public API for updating one cell; modify the current values and assign the complete Array through cells=.

[PARAM] array_array_of_text_objects ... cell values in the same format accepted by self.new
[RETURN] the assigned Array, following Ruby setter semantics
[EXCEPTION] ArgumentError ... raised with cells must be an array when the argument is not an Array
[EXCEPTION] StandardError ... raised when changing the number of cells in a saved row

row = Block.find "table_row_block_id"
row.cells = %w[Updated Values]
row.save

1. Class methods

self.new(array_array_of_text_objects = [], _table_width = 3) → TableRowBlock

2. Instance methods

cells → Array<Array<RichTextObject>>

cells=(array_array_of_text_objects)

`self.new`(array_array_of_text_objects = [], _table_width = 3) → TableRowBlock