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.
Full examples and variation matrix · Automated stories
| Input | Behavior |
|---|---|
| profile | listbox (default): custom text-input list. native-datalist: browser-owned choices for text/search/tel/url/single-email/number; omit filtering, selection-proof and label-template controls. |
| 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. |