Attributes for configuring KCompositeInput behavior.
| Name | Type | Default | Description |
|---|
| label | string | '' | There will be a label. |
| selectionValue | any | null | The currently active selection item (object or primitive) |
| inputValue | any | '' | Current value of the active selection's input |
| modelValue (v-model) | ICompositeItem[] | [] | The full collection of all entered values per selection |
| dataProvider | ADataProvider | - | Data source for the selection combobox |
| type | string | 'textbox' | Default input type: 'textbox', 'textarea', 'maskedtextbox', 'combobox', 'datepicker', 'datetimepicker', 'hourpicker'. Can be overridden per-selection via inputConfig. |
| selectionSide | string | 'left' | Side where the selection combobox is rendered: 'left' or 'right' |
| inputType | string | 'text' | Default HTML input type for 'textbox' variant. Can be overridden per-selection via inputConfig. |
| mask | string | '' | Default mask pattern for 'maskedtextbox' variant. Can be overridden per-selection via inputConfig. |
| labelField | string | 'label' | Field name to display in the selection combobox |
| valueField | string | 'value' | Field name to use as internal value/key for selection |
| placeholder | string | 'Select...' | Placeholder for the selection combobox |
| inputPlaceholder | string | '' | Default placeholder for the main input. Can be overridden per-selection via inputConfig. |
| searchbox | boolean | false | Enable live filtering for selection side |
| showClear | boolean | false | Default show clear button for the main input. Can be overridden per-selection via inputConfig. |
| teleportTo | string | - | Target element for dropdown teleportation |
| inputConfigField | string | 'inputConfig' | Field name on selection items that contains the per-item ICompositeInputConfig object |
| validateAll | boolean | false | When false (default), only the active selection's input is validated. When true, all items in the collection are validated. |
| validation | 'success' | 'warning' | 'error' | null | null | Global semantic validation state. Per-selection inputConfig.validation takes priority. |
| validationText | string | '' | Global validation message. Per-selection inputConfig.validationText takes priority. |
Each item in the selection dataProvider can optionally include an inputConfig field to customize the input component rendered when that item is selected.
| Property | Type | Description |
|---|
| type | CompositeInputType | Input component type to render for this selection |
| inputType | string | HTML input type for textbox ('text', 'email', 'tel', etc.) |
| mask | string | Mask pattern for maskedtextbox |
| placeholder | string | Input placeholder text |
| showClear | boolean | Show clear button |
| inputDataProvider | ADataProvider | For combobox type: separate data source for the secondary input |
| inputLabelField | string | For combobox type: label field for the secondary combobox |
| inputValueField | string | For combobox type: value field for the secondary combobox |
| inputSearchbox | boolean | For combobox type: enable searchbox in the secondary combobox |
| validation | string | Per-selection validation state ('success', 'warning', 'error') |
| validationText | string | Per-selection validation message |
Events
| Name | Payload | Description |
|---|
| update:selectionValue | any | Fired when a different selection item is picked |
| update:inputValue | any | Fired when the active input value changes |
| update:modelValue | ICompositeItem[] | Fired when any value in the collection is updated (for v-model binding) |