Guide / Controls / Layout

Divider

A line between sections

When to use it. A horizontal rule used to visually separate sections within a tab. Can optionally display a centered section label.

Type
divider
Default size
1 row × 4 columns
Symbol
minus
Docs
Docs complete
Search for it as
  • line
  • separator
  • rule
  • break
  • split
  • hr
Divider: Section divider with label
Rendered by the app

Fields

4 fields you can set on a divider control. Every control also takes the shared fields (id, position, span, sync, action).

Fields
FieldTypeDefaultWhat it does
Titlelabeltext—

A name shown in the middle of the line

Shows this text centered on the divider with a line on each side, in the label font size and the line color; empty gives a plain line.

Colortintcolor#FFFFFF

The line color

Colors the line and the label text; if unset it is the text color at a faint 20% strength.

Line stylestylechoiceone of 2line

Solid or dashed line

Switches the line between solid and dashed.

  • line defaultone unbroken solid line
  • dasheda row of short dashes with small gaps
ThicknesslineThicknessnumber0.5–8 ptstep 0.51

How thick the line is

Sets the line's height from 0.5 to 8 pt (default 1).

Examples

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

Section divider with label

A dashed gray line with a centered title above the advanced settings.

JSON 9 lines
{
  "type": "divider",
  "id": "section-break",
  "position": [2, 0],
  "span": [1, 4],
  "label": "Advanced Settings",
  "style": "dashed",
  "tint": "#8E8E93"
}

Open in CAR-TER

Divider: Section divider with label
Rendered by the app

Plain rule

A thin default line between two groups, no text.

JSON 6 lines
{
  "type": "divider",
  "id": "plain-rule",
  "position": [1, 0],
  "span": [1, 4]
}

Open in CAR-TER

Bold colored break

A thick accent line to mark a major change of topic.

JSON 9 lines
{
  "type": "divider",
  "id": "major-break",
  "position": [4, 0],
  "span": [1, 4],
  "style": "line",
  "lineThickness": 3,
  "tint": "#667eea"
}

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 “Section divider with label” on your phone.

    carterkit demo divider --example 'Section divider with label'
  3. Swap in any example name from this page, or leave --example off for the first one.

carterkit quickstart · Get CAR-TER

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