Guide / Controls / Layout

Space

An empty gap

When to use it. An invisible layout element that reserves grid cells. Use spacers to create gaps or push other controls into specific positions.

Type
spacer
Also titled
Spacer
Default size
1 row × 1 column
Symbol
square.dashed
Docs
Docs complete
Search for it as
  • gap
  • space
  • padding
  • blank
  • empty
  • filler
Space: Single-cell gap
Rendered by the app

Examples

3 examples, each one a control you can paste into a layout.

Single-cell gap

Leaves one empty cell at row 1, column 2.

JSON 5 lines
{
  "type": "spacer",
  "id": "gap-1",
  "position": [1, 2]
}

Open in CAR-TER

Space: Single-cell gap
Rendered by the app

Wide gap

Reserves a block two rows tall and two columns wide so neighbours sit apart.

JSON 6 lines
{
  "type": "spacer",
  "id": "gap-wide",
  "position": [0, 0],
  "span": [2, 2]
}

Open in CAR-TER

Try it on your phone

carterkit serves a small hub on your computer and pushes one example to CAR-TER on your iPhone or iPad. Pair once with the code it prints.

  1. Install the Python kit.

    pip install carterkit
  2. Show “Single-cell gap” on your phone.

    carterkit demo spacer --example 'Single-cell gap'
  3. Swap in any example name from this page, or leave --example off for the first one.

carterkit quickstart · Get CAR-TER

Relevant Fields

Inherits all Shadow opacity. The spacer has no control-specific fields.

Field Type Default Description
span array [1, 1] Number of grid cells to reserve [rows, cols]

Generated from ControlDocs/spacer.md. Something unclear or missing? Tell me.