Builder Rows, Cells, and Navigation

Builder combines spreadsheet-style cell editing with method-aware value controls. You can add and reorganize data records, edit raw text or structured values, jump to an exact data cell, search the entire sheet, and adjust the grid without changing the saved table structure.

Read Builder Table Anatomy first if you are unfamiliar with the four pinned Darty header rows.

Select a Cell or Method Block

Select a cell to make it the current Builder position. Builder highlights the selected cell and its containing method block.

You can also select a method's top group header. This selects the start of that method block and exposes the block as the context for row-specific method editing.

The pinned column at the left identifies:

• The four Darty header rows by icon
• Data rows as [1], [2], [3], and so on
• Row-specific method and action controls

Builder's visible data row 1 is the first record after the four headers. The pinned headers do not change the displayed data-row numbering.

Which Cells Can Be Edited?

Method and property names are protected because changing either can alter the meaning or structure of the complete block. See Builder Method Blocks for structural edits.

Edit Plain Text Cells

For directly editable cells, select or double-click the cell and enter the value. Press Enter or move focus away to commit the edit.

Direct editing is used for:

• Tag Search headers
• Label headers
• Body values without a specialized property editor

An empty body cell means that record does not override the property's header default. If the property has no default, the value remains unset for that record.

Edit Property Defaults

Select a property-header cell to edit its default value. Builder keeps the property key intact and changes only the value after its colon.

For example:

opacity:50

The property is opacity, and 50 is the default used by rows whose opacity cell is empty.

Text-like defaults open a text field or textarea. Typed properties open the same structured controls used for body values. Clear the editor value and select Apply to remove the default while preserving the property column.

Use Typed Value Editors

Builder recognizes many method properties and opens an appropriate editor instead of requiring raw table syntax.

Selecting Apply writes the serialized Darty value into the cell. Selecting Unset, clearing the choice, or applying an empty value leaves the cell blank.

The same typed editor can appear for a property default in the header and for a record-specific value in the body.

Add and Manage Data Rows

Each body row is one complete data record across all method blocks.

Add a Row at the End

Select Add Row in the main Builder toolbar. Builder appends a new blank row with one cell for every current property column.

Open Row Actions

Use the three-dot More Row Actions control beside a data-row number.

Row operations always span the full table. You cannot insert or duplicate a row inside only one method block.

Edit a Method for One Row

Select a cell in the method block you want to edit, then use the pencil control beside the required data row. Builder opens Edit Method Block for Row with that method's structured controls.

Selecting Apply writes values into the chosen record. It can also add newly activated property columns to the block. It does not change another row or execute the method against Illustrator.

This is useful when several related values must be configured together. For one simple value, editing the body cell directly is usually faster.

Jump to a Data Cell

Use the Jump to cell field in the toolbar to focus an exact body cell. Builder displays coordinates in row-then-column form:

1A
12C
4AA

1A means data row 1, column A. The four pinned Darty headers are not counted as data rows.

Builder also accepts the familiar column-then-row form, such as A1, and normalizes it to its displayed format. Press Enter, leave the field, or pause after entering a complete coordinate to jump. Coordinates beyond the table are limited to the last available row or column.

Selecting a body cell updates the field to that cell's displayed coordinate. Jump to cell navigates body records only; use Search when you need to locate text in a header.

Search Sheet Cells

Select the magnifying-glass Search Sheet Cells control to open the search panel. Search includes the four Darty header rows and all data rows, beginning with column A.

As you type, Builder reports the number of matches and focuses the first result. Use the match-navigation controls or press Enter to continue through results. Navigation wraps when it reaches the first or last match.

Open More options to configure:

• Literal or Regex search mode
• Case-sensitive matching
• All rows, the selected row, or given row numbers and ranges
• All columns, the selected column, or given column letters and ranges

Examples of given scopes include:

• Rows: 1, 4-8, or header ranges such as H1:H4
• Columns: A or C:F

Header matches are identified separately from data-row matches and focus the corresponding pinned header cell. Close the panel with its close control or the toolbar search button.

Resize and Auto-Fit Columns

Drag a vertical cell boundary to resize a property column. The pinned row-number column can also be resized from its right edge.

Select Auto Fit Table Columns to resize every displayed column according to its current content. Manual and auto-fit widths affect only the Builder workspace; they are not written into the saved Darty table.

Loading or clearing a table can reset the captured Builder widths.

Change Grid Size

The Grid Size control offers Small, Medium, and Large table sizes. It adjusts row height and interface font sizing so you can favor density or readability.

Grid Size is a display preference. It does not change cell values, column count, or saved spreadsheet formatting.

Undo and Redo

Use the toolbar's Undo and Redo buttons for ordinary Builder table changes. Builder keeps up to 100 history snapshots.

Keyboard shortcuts are:

Undo and Redo restore table contents and Builder source state. A new edit clears the Redo stack. Display-only changes such as search options, grid size, selection, and column width are not table-history entries.

Clear Table is not undoable because it deliberately removes the table, source, and edit history. See Builder Data Sources and Files for the differences between Undo, Reset, Clear, and loading another source.

Efficient Editing Workflow

1. Select or add the required method blocks.
2. Use the block editor to establish properties and defaults.
3. Add or duplicate data rows.
4. Enter plain values directly and use typed editors for structured values.
5. Use row-specific method editing when several values belong together.
6. Jump or search to review large tables.
7. Save the table before loading another source or clearing Builder.

Related Documentation

• Builder Overview
• Builder Table Anatomy
• Builder Data Sources and Files
• Builder Method Blocks
• Darty Header