Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

Combobox: portable MyST alternative

Former upstream Pro component: <wa-combobox>. Category: Portable Alternatives · Implementation: MyST + HTML5.

Use this documentation recipe without importing Web Awesome Pro code. The former component is named for compatibility and discovery only; the alternative is not API-equivalent.

Portable example

The HTML5 datalist element supplies browser-managed suggestions without JavaScript. It is not a feature-equivalent replacement for a searchable Web Awesome Pro combobox: free-text input remains possible and screen-reader support varies.

Table 1:Combobox example values

Suggested valueMeaning
DevelopmentLocal integration
StagingPreproduction validation
ProductionLive workloads

Copyable HTML5 pattern

<label for="environment">Deployment environment</label>
<p id="environment-help">Choose a suggestion or enter another environment.</p>
<input id="environment" name="environment" list="environments"
       aria-describedby="environment-help" autocomplete="off">
<datalist id="environments">
  <option value="Development"></option>
  <option value="Staging"></option>
  <option value="Production"></option>
</datalist>

The HTML markup above is a code sample, not an active MyST form or a configured application endpoint.

Accessibility and compatibility

Validate allowed values at the receiving application; <datalist> does not restrict input to listed choices. For richer keyboard, filtering, and announcement behavior, select a separate accessible client-side control.

References: MyST specification, MyST tables, Web Awesome upstream reference.