`<cellBlock>`

Container for grouping `<cell>`, `<row>`, and `<column>` children inside a `<spreadsheet>`

<cellBlock> is a container for grouping <cell>, <row>, <column>, or other <cellBlock> children inside a <spreadsheet>, with an optional starting row and column. It lets you populate a rectangular block of cells without naming every cell’s location individually — the cells inside the block fill in relative to the block’s origin.

Attributes and Properties

Attributes for `<cellBlock>`

Other (2)

colNum

text. Column number where this block starts (1-based; can be a letter or number).

rowNum

text. Row number where this block starts (1-based; can be a letter or number).

Common to all components (9)

copy

reference. Create an independent copy of another component by reference. Enter a references a $name.

disabled

boolean. Default value: false. Whether this component is disabled and cannot be interacted with.

extend

reference. Extend another component by reference, inheriting its children and attributes. Enter a reference as $name.

fixed

boolean. Default value: false. Whether this component's value is fixed and cannot be modified.

fixLocation

boolean. Default value: false. Whether this component's location is fixed (preventing it from being moved while still allowing other modifications).

hide

boolean. Default value: false. Whether to hide this component from the rendered output.

isResponse

boolean. Default value: false. Whether this component is treated as a response for the purposes of assessment.

name

text. The name used to reference this component from elsewhere in the document.

styleNumber

integer. Default value: 1. The style number used to select this component's visual styling from the available style definitions.

Properties for `<cellBlock name="c">`

Other (6)

$c.colNum

text. Column number where this block starts (1-based; can be a letter or number).

$c.disabled

boolean. Whether this component is disabled and cannot be interacted with.

$c.fixed

boolean. Whether this component's value is fixed and cannot be modified.

$c.fixLocation

boolean. Whether this component's location is fixed (preventing it from being moved while still allowing other modifications).

$c.hidden

boolean. Whether this component is hidden from the rendered output.

$c.rowNum

text. Row number where this block starts (1-based; can be a letter or number).

Common to all components (4)

$c.doenetML

text. The DoenetML source code that produced this component.

$c.hide

boolean. Whether to hide this component from the rendered output.

$c.isResponse

boolean. Whether this component is treated as a response for the purposes of assessment.

$c.styleNumber

integer. The style number used to select this component's visual styling from the available style definitions.

Examples

Example: A block of cells anchored at row 2, column B

The block’s rowNum and colNum attributes place the top-left corner of the block at row 2, column B. Cells inside fill the block relative to that starting point.

Example: Multiple `<cellBlock>`s in one spreadsheet

Two <cellBlock> elements place data tables side-by-side in the same <spreadsheet>. Each block sets its own starting row and column.

cell choice

<cellBlock>