List builder

List builder in Huggle, a Wikipedia anti-vandalism tool
List builder in KDE to choose actions for a toolbar. The left listbox displays available actions, and the right listbox displays currently selected actions.

A list builder,[1][2] also known as a dual list, dual listbox,[3][4] disjoint listbox,[5] list shuttle,[6] shuttle,[7] swaplist,[8] transfer list[9] and two sided multi select,[10] is a graphical control element in which a user can select a set of text values by moving values between two list boxes, one representing selected values and the other representing unselected ones. Moving values back and forth is usually accomplished selecting values within one of the two lists and clicking buttons reading "Add" and "Remove", rather than by dragging and dropping them. (The buttons may alternatively be labeled ">" and "<" to visually indicate moving an item from the left list to the right, or vice versa.) Less traditionally, there may instead be an add or delete button individually next to each item.[11] The widget can sometimes also include the ability to rearrange the selected values. There may also be buttons to add or remove all values, or a text field to filter the list.

Microsoft Windows 7 design guidelines state that a list builder may be the right design choice if one wants to allow choosing multiple options from a list, to allow reordering the items, and/or to compactly show all the currently selected items.[2]

  1. ^ Tidwell, Jenifer (2005). Designing Interfaces. Sebastopol, CA: O'Reilly Media. p. 235. ISBN 978-0-596-00803-1.
  2. ^ a b List builders, Microsoft Developer Network
  3. ^ dual listbox demo, ZK documentation
  4. ^ JSFiddle Dual ListBox
  5. ^ disjointlistbox, Incr Tcl documentation
  6. ^ rich:listShuttle component, JBoss
  7. ^ Shuttle and Reorder, Oracle Browser Look and Feel Guidelines
  8. ^ swaplist package, tcllib package documentation
  9. ^ "Transfer List React component - Material-UI". material-ui.com. Retrieved 2020-11-11.
  10. ^ two sided multi select, jquery plugin Archived 2013-09-21 at the Wayback Machine
  11. ^ "jQuery UI Multiselect". quasipartikel.at. Retrieved 2020-11-11.