@vaadin/combo-box 25.1.2 → 25.2.0-alpha10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (10) hide show
  1. package/custom-elements.json +591 -3
  2. package/package.json +14 -14
  3. package/src/vaadin-combo-box-mixin.js +1 -40
  4. package/src/vaadin-combo-box-scroll-to-index-mixin.d.ts +28 -0
  5. package/src/vaadin-combo-box-scroll-to-index-mixin.js +103 -0
  6. package/src/vaadin-combo-box-scroller-mixin.js +19 -0
  7. package/src/vaadin-combo-box.d.ts +4 -0
  8. package/src/vaadin-combo-box.js +9 -3
  9. package/web-types.json +66 -190
  10. package/web-types.lit.json +66 -73
package/web-types.json CHANGED
@@ -1,23 +1,21 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/web-types",
3
3
  "name": "@vaadin/combo-box",
4
- "version": "25.1.2",
4
+ "version": "25.2.0-alpha10",
5
5
  "description-markup": "markdown",
6
6
  "contributions": {
7
7
  "html": {
8
8
  "elements": [
9
9
  {
10
10
  "name": "vaadin-combo-box",
11
- "description": "`<vaadin-combo-box>` is a web component for choosing a value from a filterable list of options\npresented in a dropdown overlay. The options can be provided as a list of strings or objects\nby setting [`items`](https://cdn.vaadin.com/vaadin-web-components/25.1.2/#/elements/vaadin-combo-box#property-items) property on the element.\n\n```html\n<vaadin-combo-box id=\"combo-box\"></vaadin-combo-box>\n```\n```js\ndocument.querySelector('#combo-box').items = ['apple', 'orange', 'banana'];\n```\n\nWhen the selected `value` is changed, a `value-changed` event is triggered.\n\n### Item rendering\n\nTo customize the content of the `<vaadin-combo-box-item>` elements placed in the dropdown, use\n[`renderer`](https://cdn.vaadin.com/vaadin-web-components/25.1.2/#/elements/vaadin-combo-box#property-renderer) property which accepts a function.\nThe renderer function is called with `root`, `comboBox`, and `model` as arguments.\n\nGenerate DOM content by using `model` object properties if needed, and append it to the `root`\nelement. The `comboBox` reference is provided to access the combo-box element state. Do not\nset combo-box properties in a `renderer` function.\n\n```js\nconst comboBox = document.querySelector('#combo-box');\ncomboBox.items = [{'label': 'Hydrogen', 'value': 'H'}];\ncomboBox.renderer = (root, comboBox, model) => {\n const item = model.item;\n root.innerHTML = `${model.index}: ${item.label} <b>${item.value}</b>`;\n};\n```\n\nRenderer is called on the opening of the combo-box and each time the related model is updated.\nBefore creating new content, it is recommended to check if there is already an existing DOM\nelement in `root` from a previous renderer call for reusing it. Even though combo-box uses\ninfinite scrolling, reducing DOM operations might improve performance.\n\nThe following properties are available in the `model` argument:\n\nProperty | Type | Description\n-----------|------------------|-------------\n`index` | Number | Index of the item in the `items` array\n`item` | String or Object | The item reference\n`selected` | Boolean | True when item is selected\n`focused` | Boolean | True when item is focused\n\n### Lazy Loading with Function Data Provider\n\nIn addition to assigning an array to the items property, you can alternatively use the\n[`dataProvider`](https://cdn.vaadin.com/vaadin-web-components/25.1.2/#/elements/vaadin-combo-box#property-dataProvider) function property.\nThe `<vaadin-combo-box>` calls this function lazily, only when it needs more data\nto be displayed.\n\n__Note that when using function data providers, the total number of items\nneeds to be set manually. The total number of items can be returned\nin the second argument of the data provider callback:__\n\n```js\ncomboBox.dataProvider = async (params, callback) => {\n const API = 'https://demo.vaadin.com/demo-data/1.0/filtered-countries';\n const { filter, page, pageSize } = params;\n const index = page * pageSize;\n\n const res = await fetch(`${API}?index=${index}&count=${pageSize}&filter=${filter}`);\n if (res.ok) {\n const { result, size } = await res.json();\n callback(result, size);\n }\n};\n```\n\n### Styling\n\nThe following custom properties are available for styling:\n\nCustom property | Description | Default\n----------------------------------------|----------------------------|---------\n`--vaadin-field-default-width` | Default width of the field | `12em`\n`--vaadin-combo-box-overlay-width` | Width of the overlay | `auto`\n`--vaadin-combo-box-overlay-max-height` | Max height of the overlay | `65vh`\n\nThe following shadow DOM parts are available for styling:\n\nPart name | Description\n---------------------|----------------\n`label` | The label element\n`input-field` | The element that wraps prefix, value and buttons\n`field-button` | Set on both clear and toggle buttons\n`clear-button` | The clear button\n`error-message` | The error message element\n`helper-text` | The helper text element wrapper\n`required-indicator` | The `required` state indicator element\n`toggle-button` | The toggle button\n`overlay` | The overlay container\n`content` | The overlay content\n`loader` | The loading indicator shown while loading items\n\nThe following state attributes are available for styling:\n\nAttribute | Description\n---------------------|---------------------------------\n`disabled` | Set when the element is disabled\n`has-value` | Set when the element has a value\n`has-label` | Set when the element has a label\n`has-helper` | Set when the element has helper text or slot\n`has-error-message` | Set when the element has an error message\n`has-tooltip` | Set when the element has a slotted tooltip\n`invalid` | Set when the element is invalid\n`focused` | Set when the element is focused\n`focus-ring` | Set when the element is keyboard focused\n`readonly` | Set when the element is readonly\n`opened` | Set when the overlay is opened\n`loading` | Set when loading items from the data provider\n\n### Internal components\n\nIn addition to `<vaadin-combo-box>` itself, the following internal\ncomponents are themable:\n\n- `<vaadin-combo-box-item>` - has the same API as [`<vaadin-item>`](https://cdn.vaadin.com/vaadin-web-components/25.1.2/#/elements/vaadin-item).\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.",
11
+ "description": "`<vaadin-combo-box>` is a web component for choosing a value from a filterable list of options\npresented in a dropdown overlay. The options can be provided as a list of strings or objects\nby setting [`items`](https://cdn.vaadin.com/vaadin-web-components/25.2.0-alpha10/#/elements/vaadin-combo-box#property-items) property on the element.\n\n```html\n<vaadin-combo-box id=\"combo-box\"></vaadin-combo-box>\n```\n```js\ndocument.querySelector('#combo-box').items = ['apple', 'orange', 'banana'];\n```\n\nWhen the selected `value` is changed, a `value-changed` event is triggered.\n\n### Item rendering\n\nTo customize the content of the `<vaadin-combo-box-item>` elements placed in the dropdown, use\n[`renderer`](https://cdn.vaadin.com/vaadin-web-components/25.2.0-alpha10/#/elements/vaadin-combo-box#property-renderer) property which accepts a function.\nThe renderer function is called with `root`, `comboBox`, and `model` as arguments.\n\nGenerate DOM content by using `model` object properties if needed, and append it to the `root`\nelement. The `comboBox` reference is provided to access the combo-box element state. Do not\nset combo-box properties in a `renderer` function.\n\n```js\nconst comboBox = document.querySelector('#combo-box');\ncomboBox.items = [{'label': 'Hydrogen', 'value': 'H'}];\ncomboBox.renderer = (root, comboBox, model) => {\n const item = model.item;\n root.innerHTML = `${model.index}: ${item.label} <b>${item.value}</b>`;\n};\n```\n\nRenderer is called on the opening of the combo-box and each time the related model is updated.\nBefore creating new content, it is recommended to check if there is already an existing DOM\nelement in `root` from a previous renderer call for reusing it. Even though combo-box uses\ninfinite scrolling, reducing DOM operations might improve performance.\n\nThe following properties are available in the `model` argument:\n\nProperty | Type | Description\n-----------|------------------|-------------\n`index` | Number | Index of the item in the `items` array\n`item` | String or Object | The item reference\n`selected` | Boolean | True when item is selected\n`focused` | Boolean | True when item is focused\n\n### Lazy Loading with Function Data Provider\n\nIn addition to assigning an array to the items property, you can alternatively use the\n[`dataProvider`](https://cdn.vaadin.com/vaadin-web-components/25.2.0-alpha10/#/elements/vaadin-combo-box#property-dataProvider) function property.\nThe `<vaadin-combo-box>` calls this function lazily, only when it needs more data\nto be displayed.\n\n__Note that when using function data providers, the total number of items\nneeds to be set manually. The total number of items can be returned\nin the second argument of the data provider callback:__\n\n```js\ncomboBox.dataProvider = async (params, callback) => {\n const API = 'https://demo.vaadin.com/demo-data/1.0/filtered-countries';\n const { filter, page, pageSize } = params;\n const index = page * pageSize;\n\n const res = await fetch(`${API}?index=${index}&count=${pageSize}&filter=${filter}`);\n if (res.ok) {\n const { result, size } = await res.json();\n callback(result, size);\n }\n};\n```\n\n### Styling\n\nThe following custom properties are available for styling:\n\nCustom property | Description | Default\n----------------------------------------|----------------------------|---------\n`--vaadin-field-default-width` | Default width of the field | `12em`\n`--vaadin-combo-box-overlay-width` | Width of the overlay | `auto`\n`--vaadin-combo-box-overlay-max-height` | Max height of the overlay | `65vh`\n\nThe following shadow DOM parts are available for styling:\n\nPart name | Description\n---------------------|----------------\n`label` | The label element\n`input-field` | The element that wraps prefix, value and buttons\n`field-button` | Set on both clear and toggle buttons\n`clear-button` | The clear button\n`error-message` | The error message element\n`helper-text` | The helper text element wrapper\n`required-indicator` | The `required` state indicator element\n`toggle-button` | The toggle button\n`overlay` | The overlay container\n`content` | The overlay content\n`loader` | The loading indicator shown while loading items\n\nThe following state attributes are available for styling:\n\nAttribute | Description\n---------------------|---------------------------------\n`disabled` | Set when the element is disabled\n`has-value` | Set when the element has a value\n`has-label` | Set when the element has a label\n`has-helper` | Set when the element has helper text or slot\n`has-error-message` | Set when the element has an error message\n`has-tooltip` | Set when the element has a slotted tooltip\n`invalid` | Set when the element is invalid\n`focused` | Set when the element is focused\n`focus-ring` | Set when the element is keyboard focused\n`readonly` | Set when the element is readonly\n`opened` | Set when the overlay is opened\n`loading` | Set when loading items from the data provider\n\n### Internal components\n\nIn addition to `<vaadin-combo-box>` itself, the following internal\ncomponents are themable:\n\n- `<vaadin-combo-box-item>` - has the same API as [`<vaadin-item>`](https://cdn.vaadin.com/vaadin-web-components/25.2.0-alpha10/#/elements/vaadin-item).\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.",
12
12
  "attributes": [
13
13
  {
14
14
  "name": "accessible-name",
15
15
  "description": "String used to label the component to screen reader users.",
16
16
  "value": {
17
17
  "type": [
18
- "string",
19
- "null",
20
- "undefined"
18
+ "string"
21
19
  ]
22
20
  }
23
21
  },
@@ -26,9 +24,7 @@
26
24
  "description": "Id of the element used as label of the component to screen reader users.",
27
25
  "value": {
28
26
  "type": [
29
- "string",
30
- "null",
31
- "undefined"
27
+ "string"
32
28
  ]
33
29
  }
34
30
  },
@@ -37,9 +33,7 @@
37
33
  "description": "If `true`, the user can input a value that is not present in the items list.\n`value` property will be set to the input value in this case.\nAlso, when `value` is set programmatically, the input value will be set\nto reflect that value.",
38
34
  "value": {
39
35
  "type": [
40
- "boolean",
41
- "null",
42
- "undefined"
36
+ "boolean"
43
37
  ]
44
38
  }
45
39
  },
@@ -48,9 +42,7 @@
48
42
  "description": "A pattern matched against individual characters the user inputs.\n\nWhen set, the field will prevent:\n- `keydown` events if the entered key doesn't match `/^allowedCharPattern$/`\n- `paste` events if the pasted text doesn't match `/^allowedCharPattern*$/`\n- `drop` events if the dropped text doesn't match `/^allowedCharPattern*$/`\n\nFor example, to allow entering only numbers and minus signs, use:\n`allowedCharPattern = \"[\\\\d-]\"`",
49
43
  "value": {
50
44
  "type": [
51
- "string",
52
- "null",
53
- "undefined"
45
+ "string"
54
46
  ]
55
47
  }
56
48
  },
@@ -59,9 +51,7 @@
59
51
  "description": "Set true to prevent the overlay from opening automatically.",
60
52
  "value": {
61
53
  "type": [
62
- "boolean",
63
- "null",
64
- "undefined"
54
+ "boolean"
65
55
  ]
66
56
  }
67
57
  },
@@ -70,9 +60,7 @@
70
60
  "description": "Specify that this control should have input focus when the page loads.",
71
61
  "value": {
72
62
  "type": [
73
- "boolean",
74
- "null",
75
- "undefined"
63
+ "boolean"
76
64
  ]
77
65
  }
78
66
  },
@@ -81,9 +69,7 @@
81
69
  "description": "If true, the input text gets fully selected when the field is focused using click or touch / tap.",
82
70
  "value": {
83
71
  "type": [
84
- "boolean",
85
- "null",
86
- "undefined"
72
+ "boolean"
87
73
  ]
88
74
  }
89
75
  },
@@ -92,9 +78,7 @@
92
78
  "description": "Set to true to display the clear icon which clears the input.\n\nIt is up to the component to choose where to place the clear icon:\nin the Shadow DOM or in the light DOM. In any way, a reference to\nthe clear icon element should be provided via the `clearElement` getter.",
93
79
  "value": {
94
80
  "type": [
95
- "boolean",
96
- "null",
97
- "undefined"
81
+ "boolean"
98
82
  ]
99
83
  }
100
84
  },
@@ -103,9 +87,7 @@
103
87
  "description": "If true, the user cannot interact with this element.",
104
88
  "value": {
105
89
  "type": [
106
- "boolean",
107
- "null",
108
- "undefined"
90
+ "boolean"
109
91
  ]
110
92
  }
111
93
  },
@@ -114,9 +96,7 @@
114
96
  "description": "Error to show when the field is invalid.",
115
97
  "value": {
116
98
  "type": [
117
- "string",
118
- "null",
119
- "undefined"
99
+ "string"
120
100
  ]
121
101
  }
122
102
  },
@@ -125,9 +105,7 @@
125
105
  "description": "Filtering string the user has typed into the input field.",
126
106
  "value": {
127
107
  "type": [
128
- "string",
129
- "null",
130
- "undefined"
108
+ "string"
131
109
  ]
132
110
  }
133
111
  },
@@ -136,9 +114,7 @@
136
114
  "description": "String used for the helper text.",
137
115
  "value": {
138
116
  "type": [
139
- "string",
140
- "null",
141
- "undefined"
117
+ "string"
142
118
  ]
143
119
  }
144
120
  },
@@ -147,9 +123,7 @@
147
123
  "description": "Set to true when the field is invalid.",
148
124
  "value": {
149
125
  "type": [
150
- "boolean",
151
- "null",
152
- "undefined"
126
+ "boolean"
153
127
  ]
154
128
  }
155
129
  },
@@ -158,9 +132,7 @@
158
132
  "description": "Path for the id of the item. If `items` is an array of objects,\nthe `itemIdPath` is used to compare and identify the same item\nin `selectedItem` and `filteredItems` (items given by the\n`dataProvider` callback).",
159
133
  "value": {
160
134
  "type": [
161
- "string",
162
- "null",
163
- "undefined"
135
+ "string"
164
136
  ]
165
137
  }
166
138
  },
@@ -169,9 +141,7 @@
169
141
  "description": "Path for label of the item. If `items` is an array of objects, the\n`itemLabelPath` is used to fetch the displayed string label for each\nitem.\n\nThe item label is also used for matching items when processing user\ninput, i.e., for filtering and selecting items.",
170
142
  "value": {
171
143
  "type": [
172
- "string",
173
- "null",
174
- "undefined"
144
+ "string"
175
145
  ]
176
146
  }
177
147
  },
@@ -180,9 +150,7 @@
180
150
  "description": "Path for the value of the item. If `items` is an array of objects, the\n`itemValuePath:` is used to fetch the string value for the selected\nitem.\n\nThe item value is used in the `value` property of the combo box,\nto provide the form value.",
181
151
  "value": {
182
152
  "type": [
183
- "string",
184
- "null",
185
- "undefined"
153
+ "string"
186
154
  ]
187
155
  }
188
156
  },
@@ -191,9 +159,7 @@
191
159
  "description": "The label text for the input node.\nWhen no light dom defined via [slot=label], this value will be used.",
192
160
  "value": {
193
161
  "type": [
194
- "string",
195
- "null",
196
- "undefined"
162
+ "string"
197
163
  ]
198
164
  }
199
165
  },
@@ -202,9 +168,7 @@
202
168
  "description": "When set to `true`, \"loading\" attribute is added to host and the overlay element.",
203
169
  "value": {
204
170
  "type": [
205
- "boolean",
206
- "null",
207
- "undefined"
171
+ "boolean"
208
172
  ]
209
173
  }
210
174
  },
@@ -213,9 +177,7 @@
213
177
  "description": "Set to true to enable manual validation mode. This mode disables automatic\nconstraint validation, allowing you to control the validation process yourself.\nYou can still trigger constraint validation manually with the `validate()` method\nor use `checkValidity()` to assess the component's validity without affecting\nthe invalid state. In manual validation mode, you can also manipulate\nthe `invalid` property directly through your application logic without conflicts\nwith the component's internal validation.",
214
178
  "value": {
215
179
  "type": [
216
- "boolean",
217
- "null",
218
- "undefined"
180
+ "boolean"
219
181
  ]
220
182
  }
221
183
  },
@@ -224,9 +186,7 @@
224
186
  "description": "The name of this field.",
225
187
  "value": {
226
188
  "type": [
227
- "string",
228
- "null",
229
- "undefined"
189
+ "string"
230
190
  ]
231
191
  }
232
192
  },
@@ -235,9 +195,7 @@
235
195
  "description": "True if the dropdown is open, false otherwise.",
236
196
  "value": {
237
197
  "type": [
238
- "boolean",
239
- "null",
240
- "undefined"
198
+ "boolean"
241
199
  ]
242
200
  }
243
201
  },
@@ -246,9 +204,7 @@
246
204
  "description": "Number of items fetched at a time from the dataprovider.",
247
205
  "value": {
248
206
  "type": [
249
- "number",
250
- "null",
251
- "undefined"
207
+ "number"
252
208
  ]
253
209
  }
254
210
  },
@@ -257,9 +213,7 @@
257
213
  "description": "A regular expression that the value is checked against.\nThe pattern must match the entire value, not just some subset.",
258
214
  "value": {
259
215
  "type": [
260
- "string",
261
- "null",
262
- "undefined"
216
+ "string"
263
217
  ]
264
218
  }
265
219
  },
@@ -268,9 +222,7 @@
268
222
  "description": "A hint to the user of what can be entered in the field.",
269
223
  "value": {
270
224
  "type": [
271
- "string",
272
- "null",
273
- "undefined"
225
+ "string"
274
226
  ]
275
227
  }
276
228
  },
@@ -279,9 +231,7 @@
279
231
  "description": "When present, it specifies that the field is read-only.",
280
232
  "value": {
281
233
  "type": [
282
- "boolean",
283
- "null",
284
- "undefined"
234
+ "boolean"
285
235
  ]
286
236
  }
287
237
  },
@@ -290,9 +240,7 @@
290
240
  "description": "Specifies that the user must fill in a value.",
291
241
  "value": {
292
242
  "type": [
293
- "boolean",
294
- "null",
295
- "undefined"
243
+ "boolean"
296
244
  ]
297
245
  }
298
246
  },
@@ -301,9 +249,7 @@
301
249
  "description": "Total number of items.",
302
250
  "value": {
303
251
  "type": [
304
- "number",
305
- "null",
306
- "undefined"
252
+ "number"
307
253
  ]
308
254
  }
309
255
  },
@@ -323,9 +269,7 @@
323
269
  "description": "The text usually displayed in a tooltip popup when the mouse is over the field.",
324
270
  "value": {
325
271
  "type": [
326
- "string",
327
- "null",
328
- "undefined"
272
+ "string"
329
273
  ]
330
274
  }
331
275
  },
@@ -334,9 +278,7 @@
334
278
  "description": "The value of the field.",
335
279
  "value": {
336
280
  "type": [
337
- "string",
338
- "null",
339
- "undefined"
281
+ "string"
340
282
  ]
341
283
  }
342
284
  }
@@ -348,9 +290,7 @@
348
290
  "description": "String used to label the component to screen reader users.",
349
291
  "value": {
350
292
  "type": [
351
- "string",
352
- "null",
353
- "undefined"
293
+ "string"
354
294
  ]
355
295
  }
356
296
  },
@@ -359,9 +299,7 @@
359
299
  "description": "Id of the element used as label of the component to screen reader users.",
360
300
  "value": {
361
301
  "type": [
362
- "string",
363
- "null",
364
- "undefined"
302
+ "string"
365
303
  ]
366
304
  }
367
305
  },
@@ -370,9 +308,7 @@
370
308
  "description": "If `true`, the user can input a value that is not present in the items list.\n`value` property will be set to the input value in this case.\nAlso, when `value` is set programmatically, the input value will be set\nto reflect that value.",
371
309
  "value": {
372
310
  "type": [
373
- "boolean",
374
- "null",
375
- "undefined"
311
+ "boolean"
376
312
  ]
377
313
  }
378
314
  },
@@ -381,9 +317,7 @@
381
317
  "description": "A pattern matched against individual characters the user inputs.\n\nWhen set, the field will prevent:\n- `keydown` events if the entered key doesn't match `/^allowedCharPattern$/`\n- `paste` events if the pasted text doesn't match `/^allowedCharPattern*$/`\n- `drop` events if the dropped text doesn't match `/^allowedCharPattern*$/`\n\nFor example, to allow entering only numbers and minus signs, use:\n`allowedCharPattern = \"[\\\\d-]\"`",
382
318
  "value": {
383
319
  "type": [
384
- "string",
385
- "null",
386
- "undefined"
320
+ "string"
387
321
  ]
388
322
  }
389
323
  },
@@ -392,9 +326,7 @@
392
326
  "description": "Specify that this control should have input focus when the page loads.",
393
327
  "value": {
394
328
  "type": [
395
- "boolean",
396
- "null",
397
- "undefined"
329
+ "boolean"
398
330
  ]
399
331
  }
400
332
  },
@@ -403,9 +335,7 @@
403
335
  "description": "Set true to prevent the overlay from opening automatically.",
404
336
  "value": {
405
337
  "type": [
406
- "boolean",
407
- "null",
408
- "undefined"
338
+ "boolean"
409
339
  ]
410
340
  }
411
341
  },
@@ -414,9 +344,7 @@
414
344
  "description": "If true, the input text gets fully selected when the field is focused using click or touch / tap.",
415
345
  "value": {
416
346
  "type": [
417
- "boolean",
418
- "null",
419
- "undefined"
347
+ "boolean"
420
348
  ]
421
349
  }
422
350
  },
@@ -425,9 +353,7 @@
425
353
  "description": "Set to true to display the clear icon which clears the input.\n\nIt is up to the component to choose where to place the clear icon:\nin the Shadow DOM or in the light DOM. In any way, a reference to\nthe clear icon element should be provided via the `clearElement` getter.",
426
354
  "value": {
427
355
  "type": [
428
- "boolean",
429
- "null",
430
- "undefined"
356
+ "boolean"
431
357
  ]
432
358
  }
433
359
  },
@@ -446,9 +372,7 @@
446
372
  "description": "If true, the user cannot interact with this element.",
447
373
  "value": {
448
374
  "type": [
449
- "boolean",
450
- "null",
451
- "undefined"
375
+ "boolean"
452
376
  ]
453
377
  }
454
378
  },
@@ -457,9 +381,7 @@
457
381
  "description": "Error to show when the field is invalid.",
458
382
  "value": {
459
383
  "type": [
460
- "string",
461
- "null",
462
- "undefined"
384
+ "string"
463
385
  ]
464
386
  }
465
387
  },
@@ -468,9 +390,7 @@
468
390
  "description": "Filtering string the user has typed into the input field.",
469
391
  "value": {
470
392
  "type": [
471
- "string",
472
- "null",
473
- "undefined"
393
+ "string"
474
394
  ]
475
395
  }
476
396
  },
@@ -479,7 +399,7 @@
479
399
  "description": "A subset of items, filtered based on the user input. Filtered items\ncan be assigned directly to omit the internal filtering functionality.\nThe items can be of either `String` or `Object` type.",
480
400
  "value": {
481
401
  "type": [
482
- "Array.<ComboBoxItem",
402
+ "Array<ComboBoxItem",
483
403
  "string>",
484
404
  "undefined"
485
405
  ]
@@ -490,9 +410,7 @@
490
410
  "description": "String used for the helper text.",
491
411
  "value": {
492
412
  "type": [
493
- "string",
494
- "null",
495
- "undefined"
413
+ "string"
496
414
  ]
497
415
  }
498
416
  },
@@ -501,9 +419,7 @@
501
419
  "description": "Set to true when the field is invalid.",
502
420
  "value": {
503
421
  "type": [
504
- "boolean",
505
- "null",
506
- "undefined"
422
+ "boolean"
507
423
  ]
508
424
  }
509
425
  },
@@ -512,9 +428,7 @@
512
428
  "description": "A function used to generate CSS class names for dropdown\nitems based on the item. The return value should be the\ngenerated class name as a string, or multiple class names\nseparated by whitespace characters.",
513
429
  "value": {
514
430
  "type": [
515
- "Object",
516
- "null",
517
- "undefined"
431
+ "object"
518
432
  ]
519
433
  }
520
434
  },
@@ -523,9 +437,7 @@
523
437
  "description": "Path for the id of the item. If `items` is an array of objects,\nthe `itemIdPath` is used to compare and identify the same item\nin `selectedItem` and `filteredItems` (items given by the\n`dataProvider` callback).",
524
438
  "value": {
525
439
  "type": [
526
- "string",
527
- "null",
528
- "undefined"
440
+ "string"
529
441
  ]
530
442
  }
531
443
  },
@@ -534,9 +446,7 @@
534
446
  "description": "A function that is used to generate the label for dropdown\nitems based on the item. Receives one argument:\n- `item` The item to generate the label for.",
535
447
  "value": {
536
448
  "type": [
537
- "Object",
538
- "null",
539
- "undefined"
449
+ "object"
540
450
  ]
541
451
  }
542
452
  },
@@ -545,9 +455,7 @@
545
455
  "description": "Path for label of the item. If `items` is an array of objects, the\n`itemLabelPath` is used to fetch the displayed string label for each\nitem.\n\nThe item label is also used for matching items when processing user\ninput, i.e., for filtering and selecting items.",
546
456
  "value": {
547
457
  "type": [
548
- "string",
549
- "null",
550
- "undefined"
458
+ "string"
551
459
  ]
552
460
  }
553
461
  },
@@ -556,7 +464,7 @@
556
464
  "description": "A full set of items to filter the visible options from.\nThe items can be of either `String` or `Object` type.",
557
465
  "value": {
558
466
  "type": [
559
- "Array.<ComboBoxItem",
467
+ "Array<ComboBoxItem",
560
468
  "string>",
561
469
  "undefined"
562
470
  ]
@@ -567,9 +475,7 @@
567
475
  "description": "Path for the value of the item. If `items` is an array of objects, the\n`itemValuePath:` is used to fetch the string value for the selected\nitem.\n\nThe item value is used in the `value` property of the combo box,\nto provide the form value.",
568
476
  "value": {
569
477
  "type": [
570
- "string",
571
- "null",
572
- "undefined"
478
+ "string"
573
479
  ]
574
480
  }
575
481
  },
@@ -578,9 +484,7 @@
578
484
  "description": "The label text for the input node.\nWhen no light dom defined via [slot=label], this value will be used.",
579
485
  "value": {
580
486
  "type": [
581
- "string",
582
- "null",
583
- "undefined"
487
+ "string"
584
488
  ]
585
489
  }
586
490
  },
@@ -589,9 +493,7 @@
589
493
  "description": "When set to `true`, \"loading\" attribute is added to host and the overlay element.",
590
494
  "value": {
591
495
  "type": [
592
- "boolean",
593
- "null",
594
- "undefined"
496
+ "boolean"
595
497
  ]
596
498
  }
597
499
  },
@@ -600,9 +502,7 @@
600
502
  "description": "Set to true to enable manual validation mode. This mode disables automatic\nconstraint validation, allowing you to control the validation process yourself.\nYou can still trigger constraint validation manually with the `validate()` method\nor use `checkValidity()` to assess the component's validity without affecting\nthe invalid state. In manual validation mode, you can also manipulate\nthe `invalid` property directly through your application logic without conflicts\nwith the component's internal validation.",
601
503
  "value": {
602
504
  "type": [
603
- "boolean",
604
- "null",
605
- "undefined"
505
+ "boolean"
606
506
  ]
607
507
  }
608
508
  },
@@ -611,9 +511,7 @@
611
511
  "description": "The name of this field.",
612
512
  "value": {
613
513
  "type": [
614
- "string",
615
- "null",
616
- "undefined"
514
+ "string"
617
515
  ]
618
516
  }
619
517
  },
@@ -622,9 +520,7 @@
622
520
  "description": "True if the dropdown is open, false otherwise.",
623
521
  "value": {
624
522
  "type": [
625
- "boolean",
626
- "null",
627
- "undefined"
523
+ "boolean"
628
524
  ]
629
525
  }
630
526
  },
@@ -633,9 +529,7 @@
633
529
  "description": "Number of items fetched at a time from the dataprovider.",
634
530
  "value": {
635
531
  "type": [
636
- "number",
637
- "null",
638
- "undefined"
532
+ "number"
639
533
  ]
640
534
  }
641
535
  },
@@ -644,9 +538,7 @@
644
538
  "description": "A regular expression that the value is checked against.\nThe pattern must match the entire value, not just some subset.",
645
539
  "value": {
646
540
  "type": [
647
- "string",
648
- "null",
649
- "undefined"
541
+ "string"
650
542
  ]
651
543
  }
652
544
  },
@@ -655,9 +547,7 @@
655
547
  "description": "A hint to the user of what can be entered in the field.",
656
548
  "value": {
657
549
  "type": [
658
- "string",
659
- "null",
660
- "undefined"
550
+ "string"
661
551
  ]
662
552
  }
663
553
  },
@@ -666,9 +556,7 @@
666
556
  "description": "When present, it specifies that the field is read-only.",
667
557
  "value": {
668
558
  "type": [
669
- "boolean",
670
- "null",
671
- "undefined"
559
+ "boolean"
672
560
  ]
673
561
  }
674
562
  },
@@ -687,9 +575,7 @@
687
575
  "description": "Specifies that the user must fill in a value.",
688
576
  "value": {
689
577
  "type": [
690
- "boolean",
691
- "null",
692
- "undefined"
578
+ "boolean"
693
579
  ]
694
580
  }
695
581
  },
@@ -709,9 +595,7 @@
709
595
  "description": "Total number of items.",
710
596
  "value": {
711
597
  "type": [
712
- "number",
713
- "null",
714
- "undefined"
598
+ "number"
715
599
  ]
716
600
  }
717
601
  },
@@ -720,9 +604,7 @@
720
604
  "description": "The text usually displayed in a tooltip popup when the mouse is over the field.",
721
605
  "value": {
722
606
  "type": [
723
- "string",
724
- "null",
725
- "undefined"
607
+ "string"
726
608
  ]
727
609
  }
728
610
  },
@@ -731,9 +613,7 @@
731
613
  "description": "The value of the field.",
732
614
  "value": {
733
615
  "type": [
734
- "string",
735
- "null",
736
- "undefined"
616
+ "string"
737
617
  ]
738
618
  }
739
619
  }
@@ -751,10 +631,6 @@
751
631
  "name": "filter-changed",
752
632
  "description": "Fired when the `filter` property changes."
753
633
  },
754
- {
755
- "name": "input",
756
- "description": "Fired when the value is changed by the user: on every typing keystroke,\nand the value is cleared using the clear button."
757
- },
758
634
  {
759
635
  "name": "invalid-changed",
760
636
  "description": "Fired when the `invalid` property changes."
@@ -765,7 +641,7 @@
765
641
  },
766
642
  {
767
643
  "name": "selected-item-changed",
768
- "description": "Fired when selected item changes."
644
+ "description": "Fired when the `selectedItem` property changes."
769
645
  },
770
646
  {
771
647
  "name": "vaadin-combo-box-dropdown-closed",
@@ -781,7 +657,7 @@
781
657
  },
782
658
  {
783
659
  "name": "value-changed",
784
- "description": "Fired when the value changes."
660
+ "description": "Fired when the `value` property changes."
785
661
  }
786
662
  ]
787
663
  }