split_pane: Split pane

In termr: Modern Reactive Terminal Applications with Data Workflows

Split pane

Description

Two panes separated by a divider the user can drag with the mouse (press on the divider, move, release) or move with the keyboard (focus the divider with Tab; arrows move it, Shift+arrows ten cells, Home / End to the ends). Typical uses: a tree next to a preview, a table above a detail view, an editor above its output.

Usage

split_pane(
  first,
  second,
  direction = "horizontal",
  ratio = 0.5,
  min_size = 3L,
  id = NULL,
  classes = NULL,
  style = NULL
)

Arguments

first, second	The two panes.
direction	"horizontal": panes side by side, divider vertical; "vertical": stacked panes.
ratio	Share of the first pane, between 0 and 1.
min_size	Smallest pane size in cells.
id	Optional identifier.
classes	Optional classes.
style	A style().

Details

The panes fill their share of the space regardless of their own size styles. ratio is the share of the first pane; min_size keeps both panes from collapsing. The pane sends "splitpane.resized" (ratio) when the user finishes moving the divider. Experimental.

Value

A SplitPane widget with ⁠$ratio⁠ and ⁠$sizes⁠.

Examples

ui <- split_pane(label("left"), label("right"), ratio = 0.4)
render_widget(ui, 20, 2)$to_text()

termr documentation built on Oct. 21, 2026, 5:13 p.m.