Suggestions attach to the existing editor in cem-field or cem-text-field. The field keeps its label, help, validation and form value; the attachment owns the suggestion list.
Suggestions property playground and source · Automated stories
| Input | Behavior |
|---|---|
| profile | listbox (default) provides the custom list; native-datalist delegates the popup to the browser. |
| label | Listbox accessible name; default Suggestions. The projected field owns its visible label and help. |
| filter / filter-by | contains (default), prefix, none. label (default), value, or label value; omit filter-by with none. |
| require-selection / selection-message | Require a committed native row; selection-message localizes the field-owned validity contribution. |
| options-state / options-error | ready, pending, failed; plain-text failure override. Pending/failed results cannot commit old rows. |
| pending-message, failure-message, empty-message, single-message, multiple-message | Localized status text. %count substitutes the eligible count in the multiple message. |
| editor, options, option, group-label slots | One direct native field; inert source options; optional isolated text/cem-ml label templates with native suggestion/group parameters. |
| options / editor-for and revision inputs | Native host integration only. Explicit references need fresh host grants and conflict with equivalent local slots. No URL/JSON input shortcut. |
| disabled, readonly, required, name, value, help, validation | These belong to the field. Attribute presence includes the text false. |
| hidden, class | Standard host visibility and consumer styling membership. |
Audited source examples
These seven legends map the pinned autocomplete examples to the adopted field attachment. Numeric editing is shown without suggestions; numeric selection awaits an additional native profile. Static material parity markers do not establish these interactions.
| Source legend | Current coverage |
|---|---|
| No value | Empty labeled field, ordinary editing without a popup. |
| No value with placeholder | Native number field and placeholder; no suggestion set. |
| Value defined | Initial abc; edits, including empty, survive attachment rerenders. |
| No initial value with placeholder | Explicit data values with emoji labels; commit stores apple. |
| Number, No initial value without placeholder | Native numeric editing only. Suggestion commits of 1/2/3 with word labels remain deferred. |
| Options text as value | Native missing-value fallback collapses ASCII text whitespace. |
| Options Grouping | Group labels and filtering; empty groups hide. |
Five theme modes and field states
Focus an enabled field to compare hover, keyboard preview and the real popup. Touch/pen, device IME, screen-reader interoperability and the full later acceptance matrix remain under verification.