Combobox — A2UI Atomic Catalog

Searchable filterable dropdown that narrows its option list as the user types. Renders with a search icon, chevron, and an open option list for article preview. Native enables browser-level autocomplete.

Surfaces

webmeet-stageapps-script-web

Degraded on

Surface	Note
pdf	Renders as a static select; no interactivity

Fields

Field	Type
label	string. Visible label above the field.	optional
name	string. Field identifier.	required
placeholder	string. Input placeholder text.	optional
options	array of {value, label} pairs.	required
selected	string. Pre-selected option value.	optional
rules	array of strings. e.g. ['required'].	optional

Example payload

{
  "type": "combobox",
  "name": "Combobox",
  "options": [
    {
      "label": "Option A",
      "value": "a"
    },
    {
      "label": "Option B",
      "value": "b"
    },
    {
      "label": "Option C",
      "value": "c"
    }
  ]
}

ARD catalog entry

{
  "identifier": "urn:air:a2uicatalog.ai:atom:combobox",
  "displayName": "Combobox",
  "type": "application/vnd.a2ui.atom+json",
  "url": "https://a2uicatalog.ai/atoms/combobox",
  "capabilities": [
    "web",
    "meet-stage",
    "apps-script-web"
  ],
  "description": "Searchable filterable dropdown that narrows its option list as the user types. Renders with a search icon, chevron, and an open option list for article preview. Native  enables browser-level autocomplete.",
  "representativeQueries": [
    "show a searchable filterable dropdown \u2014 shadcn/Headless UI pattern",
    "searchable filterable dropdown that narrows its option list as the user types. renders with a search",
    "render a combobox"
  ]
}

Deploy your own renderer

The renderer is open source. Deploy your own instance in 4 commands — you own the URL, no dependency on the demo endpoint.

git clone https://github.com/a2uicatalog/a2ui
cd apps-script-surface/gas-schema-renderer
clasp push && clasp deploy

Full deploy guide →