Reorder

Rank a list by moving items into the order you want. It returns a list<string> - a full permutation of the option values, never a subset.

$p->reorder('basket', 'Rank your basket')
  ->options([
    'apple' => 'Apple',
    'carrot' => 'Carrot',
    'tomato' => 'Tomato',
  ])
  ->default(['apple', 'carrot']) // Seed the starting order; omitted items are appended.
  ->pageSize(10);                // Items visible before the list pages around the cursor.

Runnable script: playground/02-widgets-reorder.php.

Options

Name	Description	Required	Default
`options()`	The items to rank, as a `value => label` map.	Yes	-
`default()`	Seeds the starting order; any omitted options are appended in declared order, so the ranking is always complete.	No	Declared order
`pageSize()`	Items shown before the list pages around the cursor.	No	`10`

A description line can accompany the highlighted item, declared with ->option(..., description: ...).

Keyboard

Key	Action
`↑` / `↓`	Move the highlight, or carry a held item through the list
`Space`	Pick the highlighted item up, or drop a held one
`Enter`	Drop a held item, or accept when nothing is held
`Esc`	Cancel