desy-html 16.0.4 → 17.0.1

package/src/templates/components/combobox/params.combobox.yaml

@@ -0,0 +1,102 @@
+params:
+- name: id
+  type: string
+  required: true
+  description: Unique ID for the combobox component.
+- name: name
+  type: string
+  required: true
+  description: Name property for the hidden input (used in form submission).
+- name: items
+  type: array
+  required: true
+  description: Array of option items for the combobox listbox.
+  params:
+  - name: text
+    type: string
+    required: true
+    description: Text for the option item. Also used as the submitted value.
+  - name: id
+    type: string
+    required: false
+    description: Custom ID for the option item. Auto-generated if not provided.
+  - name: selected
+    type: boolean
+    required: false
+    description: If true, sets the option as pre-selected.
+  - name: classes
+    type: string
+    required: false
+    description: Classes to add to the option item.
+  - name: attributes
+    type: object
+    required: false
+    description: HTML attributes (for example data attributes) to add to the option.
+- name: multiselect
+  type: boolean
+  required: false
+  description: If true, enables multiple selection (like the multiselectable listbox). Selected options are marked with a checkmark and the listbox stays open while selecting; selecting an already-selected option deselects it. Submits one hidden input per selection (all sharing the same `name`).
+- name: autocomplete
+  type: string
+  required: false
+  description: Autocomplete mode. Either "list" or "both". Use "list" to filter the options without inline autocomplete in the text field. Defaults to "both".
+- name: defaultValue
+  type: string
+  required: false
+  description: Pre-filled value for the combobox input.
+- name: placeholder
+  type: string
+  required: false
+  description: Placeholder text for the combobox input.
+- name: noResultsText
+  type: string
+  required: false
+  description: Text shown when no options match the filter. Defaults to "No hay resultados".
+- name: toggleButtonLabel
+  type: string
+  required: false
+  description: Aria-label for the toggle button that opens/closes the listbox. Defaults to the label text.
+- name: label
+  type: object
+  required: true
+  description: Label text or HTML by specifying value for either text or html keys.
+  isComponent: true
+- name: hint
+  type: object
+  required: false
+  description: Options for the hint component.
+  isComponent: true
+- name: errorMessage
+  type: object
+  required: false
+  description: Options for the error message component. The error message component will not display if you use a falsy value for `errorMessage`, for example `false` or `null`.
+  isComponent: true
+- name: formGroup
+  type: object
+  required: false
+  description: Options for the form-group wrapper.
+  params:
+  - name: classes
+    type: string
+    required: false
+    description: Classes to add to the form group (e.g. to show error state for the whole group).
+- name: disabled
+  type: boolean
+  required: false
+  description: If true, the combobox input will be disabled.
+- name: classes
+  type: string
+  required: false
+  description: Classes to add to the combobox input element.
+- name: classesContainer
+  type: string
+  required: false
+  description: Classes to add to the combobox container.
+- name: attributes
+  type: object
+  required: false
+  description: HTML attributes (for example data attributes) to add to the wrapper.
+- name: describedBy
+  type: string
+  required: false
+  description: One or more element IDs to add to the `aria-describedby` attribute, used to provide additional descriptive information for screenreader users.