List builder

forms.inputs.list_builder

When the user must assemble a list of items, provide a list builder (available vs selected), not a single free-text dump.

Description

When the user must assemble a list of items, provide a list builder with available versus selected (add/remove), not a single free-text dump. Pass when assembling a list uses that UI; fail when a multi-item list is one free-text dump. The builder makes membership visible and editable without inventing list semantics beyond the cited pattern.

When to use

Users must build a list of items from candidates.

Not when

Single-value fields that are not multi-item lists.

Agent hint

Provide available-vs-selected add/remove; ban one free-text dump for lists.

Pass

Assembling a list uses available-vs-selected (add/remove) UI.

Fail

Multi-item list is one free-text dump.

Citations

Designing Interfaces 3e ch. Getting Input — List Builder (Tidwell, Brewer, Valencia)

https://www.oreilly.com/library/view/designing-interfaces-3rd/9781492051954/