Aller au contenu

Dropdowns and select widgets

Status: Placeholder — to be developed. Last reviewed: —

Scope

Conventions for <select> widgets and search-as-you-type dropdowns: when to use SearchSelect, how to sort and filter the option list, placeholder copy, empty-state behaviour, multi-select rules.

This complements search-sort-filter.md (which covers list-page filters); this file covers form-field selects and standalone widgets.

Sources to mine when writing this

  • apps/core/widgets.py — SearchSelect widget.
  • static/js/components/form-search-select.js — JS behaviour.
  • static/js/components/typeahead-list.js — recently factored shared component (commit fba0935).
  • Recent commits: fba0935 (TypeaheadList factoring), bb988c6 (consistency sweep) — each surfaces an implicit rule.
  • The "sort dropdown values" lesson from the holder rework — option ordering should be deterministic and documented.