Design System

Select

plos_select renders a dynamic dropdown with a label, optional hint text, and optional error message.


With label


With label and hint

Choose the journal you are submitting to.

Without label


With label and error

  • Error:

    Select a journal


Label size: large


Label size: medium


Label size: small


Disabled


Usage

{% component "plos_select" label="Journal" name="journal" options=[{"value": "plos-one", "text": "PLOS One"}, {"value": "plos-biology", "text": "PLOS Biology"}] value="plos-one" %}{% endcomponent %}

Parameters:

  • label: label text (required)
  • name: form field name (required)
  • options: list of dicts with value and text keys; selected is optional
  • value: pre-selected option value (default: None)
  • label_size: "large", "medium", or "small" (default: "small")
  • hide_label: hides the label visually while keeping it accessible (default: False)
  • hint: hint text shown below the label (default: None)
  • errors: list of dicts with a message key (default: [])
  • field_id: overrides the generated id attribute (default: "id_{name}")
  • disabled: renders the select as disabled (default: False)