@vaadin/select 25.1.0-beta1 → 25.1.0-beta3

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.
@@ -181,14 +181,6 @@
181
181
  "name": "requestContentUpdate",
182
182
  "description": "Requests an update for the content of the select.\nWhile performing the update, it invokes the renderer passed in the `renderer` property.\n\nIt is not guaranteed that the update happens immediately (synchronously) after it is requested."
183
183
  },
184
- {
185
- "kind": "field",
186
- "name": "slotName",
187
- "type": {
188
- "text": "string"
189
- },
190
- "default": "'sr-label'"
191
- },
192
184
  {
193
185
  "kind": "field",
194
186
  "name": "value",
@@ -362,261 +354,6 @@
362
354
  }
363
355
  ]
364
356
  },
365
- {
366
- "kind": "javascript-module",
367
- "path": "src/vaadin-select-item.js",
368
- "declarations": [
369
- {
370
- "kind": "class",
371
- "description": "An element used internally by `<vaadin-select>`. Not intended to be used separately.",
372
- "name": "SelectItem",
373
- "members": [
374
- {
375
- "kind": "field",
376
- "name": "selected",
377
- "privacy": "public",
378
- "type": {
379
- "text": "boolean"
380
- },
381
- "description": "If true, the item is in selected state.",
382
- "attribute": "selected",
383
- "inheritedFrom": {
384
- "name": "ItemMixin",
385
- "package": "@vaadin/item/src/vaadin-item-mixin.js"
386
- }
387
- },
388
- {
389
- "kind": "field",
390
- "name": "value",
391
- "return": {
392
- "type": {
393
- "text": "string"
394
- }
395
- },
396
- "parameters": [
397
- {
398
- "name": "value",
399
- "type": {
400
- "text": "string"
401
- }
402
- }
403
- ],
404
- "inheritedFrom": {
405
- "name": "ItemMixin",
406
- "package": "@vaadin/item/src/vaadin-item-mixin.js"
407
- }
408
- }
409
- ],
410
- "attributes": [
411
- {
412
- "name": "role",
413
- "type": {
414
- "text": "string"
415
- },
416
- "description": "Use property instead of setting an attribute in `ready()`\nfor cloning the selected item attached to the value button:\nin this case, `role` attribute is removed synchronously, and\nusing `ready()` would incorrectly restore the attribute.",
417
- "fieldName": "role"
418
- },
419
- {
420
- "name": "selected",
421
- "type": {
422
- "text": "boolean"
423
- },
424
- "description": "If true, the item is in selected state.",
425
- "fieldName": "selected",
426
- "inheritedFrom": {
427
- "name": "ItemMixin",
428
- "package": "@vaadin/item/src/vaadin-item-mixin.js"
429
- }
430
- }
431
- ],
432
- "mixins": [
433
- {
434
- "name": "ItemMixin",
435
- "package": "@vaadin/item/src/vaadin-item-mixin.js"
436
- },
437
- {
438
- "name": "ThemableMixin",
439
- "package": "@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js"
440
- },
441
- {
442
- "name": "DirMixin",
443
- "package": "@vaadin/component-base/src/dir-mixin.js"
444
- },
445
- {
446
- "name": "PolylitMixin",
447
- "package": "@vaadin/component-base/src/polylit-mixin.js"
448
- },
449
- {
450
- "name": "LumoInjectionMixin",
451
- "package": "@vaadin/vaadin-themable-mixin/lumo-injection-mixin.js"
452
- }
453
- ],
454
- "superclass": {
455
- "name": "LitElement",
456
- "package": "lit"
457
- },
458
- "tagName": "vaadin-select-item",
459
- "customElement": true,
460
- "events": []
461
- }
462
- ],
463
- "exports": [
464
- {
465
- "kind": "js",
466
- "name": "SelectItem",
467
- "declaration": {
468
- "name": "SelectItem",
469
- "module": "src/vaadin-select-item.js"
470
- }
471
- }
472
- ]
473
- },
474
- {
475
- "kind": "javascript-module",
476
- "path": "src/vaadin-select-list-box.js",
477
- "declarations": [
478
- {
479
- "kind": "class",
480
- "description": "An element used internally by `<vaadin-select>`. Not intended to be used separately.",
481
- "name": "SelectListBox",
482
- "members": [
483
- {
484
- "kind": "field",
485
- "name": "disabled",
486
- "privacy": "public",
487
- "type": {
488
- "text": "boolean"
489
- },
490
- "description": "If true, the user cannot interact with this element.\nWhen the element is disabled, the selected item is\nnot updated when `selected` property is changed.",
491
- "attribute": "disabled",
492
- "inheritedFrom": {
493
- "name": "ListMixin",
494
- "package": "@vaadin/a11y-base/src/list-mixin.js"
495
- }
496
- },
497
- {
498
- "kind": "field",
499
- "name": "items",
500
- "privacy": "public",
501
- "type": {
502
- "text": "!Array<!Element> | undefined"
503
- },
504
- "description": "A read-only list of items from which a selection can be made.\nIt is populated from the elements passed to the light DOM,\nand updated dynamically when adding or removing items.",
505
- "attribute": "items",
506
- "inheritedFrom": {
507
- "name": "ListMixin",
508
- "package": "@vaadin/a11y-base/src/list-mixin.js"
509
- }
510
- },
511
- {
512
- "kind": "field",
513
- "name": "orientation",
514
- "privacy": "public",
515
- "type": {
516
- "text": "!ListOrientation"
517
- },
518
- "description": "Define how items are disposed in the dom.\nPossible values are: `horizontal|vertical`.\nIt also changes navigation keys from left/right to up/down.",
519
- "attribute": "orientation",
520
- "inheritedFrom": {
521
- "name": "ListMixin",
522
- "package": "@vaadin/a11y-base/src/list-mixin.js"
523
- }
524
- },
525
- {
526
- "kind": "field",
527
- "name": "selected",
528
- "privacy": "public",
529
- "type": {
530
- "text": "number"
531
- },
532
- "description": "The index of the item selected in the items array.\nNote: Not updated when used in `multiple` selection mode.",
533
- "attribute": "selected",
534
- "inheritedFrom": {
535
- "name": "ListMixin",
536
- "package": "@vaadin/a11y-base/src/list-mixin.js"
537
- }
538
- }
539
- ],
540
- "attributes": [
541
- {
542
- "name": "disabled",
543
- "type": {
544
- "text": "boolean"
545
- },
546
- "description": "If true, the user cannot interact with this element.\nWhen the element is disabled, the selected item is\nnot updated when `selected` property is changed.",
547
- "fieldName": "disabled",
548
- "inheritedFrom": {
549
- "name": "ListMixin",
550
- "package": "@vaadin/a11y-base/src/list-mixin.js"
551
- }
552
- },
553
- {
554
- "name": "orientation",
555
- "type": {
556
- "text": "!ListOrientation"
557
- },
558
- "description": "Define how items are disposed in the dom.\nPossible values are: `horizontal|vertical`.\nIt also changes navigation keys from left/right to up/down.",
559
- "fieldName": "orientation",
560
- "inheritedFrom": {
561
- "name": "ListMixin",
562
- "package": "@vaadin/a11y-base/src/list-mixin.js"
563
- }
564
- },
565
- {
566
- "name": "selected",
567
- "type": {
568
- "text": "number"
569
- },
570
- "description": "The index of the item selected in the items array.\nNote: Not updated when used in `multiple` selection mode.",
571
- "fieldName": "selected",
572
- "inheritedFrom": {
573
- "name": "ListMixin",
574
- "package": "@vaadin/a11y-base/src/list-mixin.js"
575
- }
576
- }
577
- ],
578
- "mixins": [
579
- {
580
- "name": "ListMixin",
581
- "package": "@vaadin/a11y-base/src/list-mixin.js"
582
- },
583
- {
584
- "name": "ThemableMixin",
585
- "package": "@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js"
586
- },
587
- {
588
- "name": "DirMixin",
589
- "package": "@vaadin/component-base/src/dir-mixin.js"
590
- },
591
- {
592
- "name": "PolylitMixin",
593
- "package": "@vaadin/component-base/src/polylit-mixin.js"
594
- },
595
- {
596
- "name": "LumoInjectionMixin",
597
- "package": "@vaadin/vaadin-themable-mixin/lumo-injection-mixin.js"
598
- }
599
- ],
600
- "superclass": {
601
- "name": "LitElement",
602
- "package": "lit"
603
- },
604
- "tagName": "vaadin-select-list-box",
605
- "customElement": true,
606
- "events": []
607
- }
608
- ],
609
- "exports": [
610
- {
611
- "kind": "js",
612
- "name": "SelectListBox",
613
- "declaration": {
614
- "name": "SelectListBox",
615
- "module": "src/vaadin-select-list-box.js"
616
- }
617
- }
618
- ]
619
- },
620
357
  {
621
358
  "kind": "javascript-module",
622
359
  "path": "src/vaadin-select-overlay-mixin.js",
@@ -1135,512 +872,72 @@
1135
872
  },
1136
873
  {
1137
874
  "kind": "javascript-module",
1138
- "path": "src/vaadin-select-overlay.js",
875
+ "path": "src/vaadin-select.js",
1139
876
  "declarations": [
1140
877
  {
1141
878
  "kind": "class",
1142
- "description": "An element used internally by `<vaadin-select>`. Not intended to be used separately.",
1143
- "name": "SelectOverlay",
879
+ "description": "`<vaadin-select>` is a Web Component for selecting values from a list of items.\n\n### Items\n\nUse the `items` property to define possible options for the select:\n\n```html\n<vaadin-select id=\"select\"></vaadin-select>\n```\n```js\nconst select = document.querySelector('#select');\nselect.items = [\n { label: 'Most recent first', value: 'recent' },\n { component: 'hr' },\n { label: 'Rating: low to high', value: 'rating-asc', className: 'asc' },\n { label: 'Rating: high to low', value: 'rating-desc', className: 'desc' },\n { component: 'hr' },\n { label: 'Price: low to high', value: 'price-asc', disabled: true },\n { label: 'Price: high to low', value: 'price-desc', disabled: true }\n];\n```\n\n### Rendering\n\nAlternatively, the content of the select can be populated by using the renderer callback function.\n\nThe renderer function provides `root`, `select` arguments.\nGenerate DOM content, append it to the `root` element and control the state\nof the host element by accessing `select`.\n\n```js\nconst select = document.querySelector('#select');\nselect.renderer = function(root, select) {\n const listBox = document.createElement('vaadin-list-box');\n // append 3 <vaadin-item> elements\n ['Jose', 'Manolo', 'Pedro'].forEach(function(name) {\n const item = document.createElement('vaadin-item');\n item.textContent = name;\n item.setAttribute('label', name)\n listBox.appendChild(item);\n });\n\n // update the content\n root.appendChild(listBox);\n};\n```\n\nRenderer is called on initialization of new select and on its opening.\nDOM generated during the renderer call can be reused\nin the next renderer call and will be provided with the `root` argument.\nOn first call it will be empty.\n\n* Hint: By setting the `label` property of inner vaadin-items you will\nbe able to change the visual representation of the selected value in the input part.\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-select-overlay-width` | Width of the overlay |\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 toggle button\n`field-button` | Set on the toggle 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`backdrop` | Backdrop of the overlay\n`overlay` | The overlay container\n`content` | The overlay content\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`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`phone` | Set when the overlay is shown in phone mode\n\n### Internal components\n\nIn addition to `<vaadin-select>` itself, the following internal\ncomponents are themable:\n\n- `<vaadin-select-value-button>` - has the same API as [`<vaadin-button>`](#/elements/vaadin-button).\n- `<vaadin-select-list-box>` - has the same API as [`<vaadin-list-box>`](#/elements/vaadin-list-box).\n- `<vaadin-select-item>` - has the same API as [`<vaadin-item>`](#/elements/vaadin-item).\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.",
880
+ "name": "Select",
1144
881
  "members": [
1145
- {
1146
- "kind": "method",
1147
- "name": "close",
1148
- "parameters": [
1149
- {
1150
- "name": "sourceEvent",
1151
- "type": {
1152
- "text": "Event="
1153
- }
1154
- }
1155
- ],
1156
- "inheritedFrom": {
1157
- "name": "OverlayMixin",
1158
- "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
1159
- }
1160
- },
1161
882
  {
1162
883
  "kind": "field",
1163
- "name": "hidden",
884
+ "name": "accessibleName",
1164
885
  "privacy": "public",
1165
886
  "type": {
1166
- "text": "boolean"
887
+ "text": "string"
1167
888
  },
1168
- "description": "When set to true, the overlay is hidden. This also closes the overlay\nimmediately in case there is a closing animation in progress.",
1169
- "attribute": "hidden",
889
+ "description": "String used to label the component to screen reader users.",
890
+ "attribute": "accessible-name",
1170
891
  "inheritedFrom": {
1171
- "name": "OverlayMixin",
1172
- "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
892
+ "name": "FieldMixin",
893
+ "package": "@vaadin/field-base/src/field-mixin.js"
1173
894
  }
1174
895
  },
1175
896
  {
1176
897
  "kind": "field",
1177
- "name": "horizontalAlign",
898
+ "name": "accessibleNameRef",
1178
899
  "privacy": "public",
1179
900
  "type": {
1180
901
  "text": "string"
1181
902
  },
1182
- "description": "When `positionTarget` is set, this property defines whether to align the overlay's\nleft or right side to the target element by default.\nPossible values are `start` and `end`.\nRTL is taken into account when interpreting the value.\nThe overlay is automatically flipped to the opposite side when it doesn't fit into\nthe default side defined by this property.",
1183
- "attribute": "horizontal-align",
903
+ "description": "Id of the element used as label of the component to screen reader users.",
904
+ "attribute": "accessible-name-ref",
1184
905
  "inheritedFrom": {
1185
- "name": "PositionMixin",
1186
- "package": "@vaadin/overlay/src/vaadin-overlay-position-mixin.js"
906
+ "name": "FieldMixin",
907
+ "package": "@vaadin/field-base/src/field-mixin.js"
908
+ }
909
+ },
910
+ {
911
+ "kind": "method",
912
+ "name": "checkValidity",
913
+ "description": "Returns true if the current value satisfies all constraints (if any)",
914
+ "return": {
915
+ "type": {
916
+ "text": "boolean"
917
+ }
918
+ },
919
+ "inheritedFrom": {
920
+ "name": "SelectBaseMixin",
921
+ "module": "src/vaadin-select-base-mixin.js"
1187
922
  }
1188
923
  },
1189
924
  {
1190
925
  "kind": "field",
1191
- "name": "model",
926
+ "name": "errorMessage",
1192
927
  "privacy": "public",
1193
928
  "type": {
1194
- "text": "object"
929
+ "text": "string"
1195
930
  },
1196
- "description": "Object with properties that is passed to `renderer` function",
1197
- "attribute": "model",
931
+ "description": "Error to show when the field is invalid.",
932
+ "attribute": "error-message",
1198
933
  "inheritedFrom": {
1199
- "name": "OverlayMixin",
1200
- "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
934
+ "name": "FieldMixin",
935
+ "package": "@vaadin/field-base/src/field-mixin.js"
1201
936
  }
1202
937
  },
1203
938
  {
1204
939
  "kind": "field",
1205
- "name": "modeless",
1206
- "privacy": "public",
1207
- "type": {
1208
- "text": "boolean"
1209
- },
1210
- "description": "When true the overlay won't disable the main content, showing\nit doesn't change the functionality of the user interface.",
1211
- "attribute": "modeless",
1212
- "inheritedFrom": {
1213
- "name": "OverlayMixin",
1214
- "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
1215
- }
1216
- },
1217
- {
1218
- "kind": "field",
1219
- "name": "noHorizontalOverlap",
1220
- "privacy": "public",
1221
- "type": {
1222
- "text": "boolean"
1223
- },
1224
- "description": "When `positionTarget` is set, this property defines whether the overlay should overlap\nthe target element in the x-axis, or be positioned right next to it.",
1225
- "attribute": "no-horizontal-overlap",
1226
- "inheritedFrom": {
1227
- "name": "PositionMixin",
1228
- "package": "@vaadin/overlay/src/vaadin-overlay-position-mixin.js"
1229
- }
1230
- },
1231
- {
1232
- "kind": "field",
1233
- "name": "noVerticalOverlap",
1234
- "privacy": "public",
1235
- "type": {
1236
- "text": "boolean"
1237
- },
1238
- "description": "When `positionTarget` is set, this property defines whether the overlay should overlap\nthe target element in the y-axis, or be positioned right above/below it.",
1239
- "attribute": "no-vertical-overlap",
1240
- "inheritedFrom": {
1241
- "name": "PositionMixin",
1242
- "package": "@vaadin/overlay/src/vaadin-overlay-position-mixin.js"
1243
- }
1244
- },
1245
- {
1246
- "kind": "field",
1247
- "name": "opened",
1248
- "privacy": "public",
1249
- "type": {
1250
- "text": "boolean"
1251
- },
1252
- "description": "When true, the overlay is visible and attached to body.",
1253
- "attribute": "opened",
1254
- "inheritedFrom": {
1255
- "name": "OverlayMixin",
1256
- "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
1257
- }
1258
- },
1259
- {
1260
- "kind": "field",
1261
- "name": "owner",
1262
- "privacy": "public",
1263
- "type": {
1264
- "text": "HTMLElement"
1265
- },
1266
- "description": "Owner element passed with renderer function",
1267
- "attribute": "owner",
1268
- "inheritedFrom": {
1269
- "name": "OverlayMixin",
1270
- "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
1271
- }
1272
- },
1273
- {
1274
- "kind": "field",
1275
- "name": "positionTarget",
1276
- "privacy": "public",
1277
- "type": {
1278
- "text": "object"
1279
- },
1280
- "description": "The element next to which this overlay should be aligned.\nThe position of the overlay relative to the positionTarget can be adjusted\nwith properties `horizontalAlign`, `verticalAlign`, `noHorizontalOverlap`\nand `noVerticalOverlap`.",
1281
- "attribute": "position-target",
1282
- "inheritedFrom": {
1283
- "name": "PositionMixin",
1284
- "package": "@vaadin/overlay/src/vaadin-overlay-position-mixin.js"
1285
- }
1286
- },
1287
- {
1288
- "kind": "field",
1289
- "name": "renderer",
1290
- "privacy": "public",
1291
- "type": {
1292
- "text": "OverlayRenderer | null | undefined"
1293
- },
1294
- "description": "Custom function for rendering the content of the overlay.\nReceives three arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `owner` The host element of the renderer function.\n- `model` The object with the properties related with rendering.",
1295
- "attribute": "renderer",
1296
- "inheritedFrom": {
1297
- "name": "OverlayMixin",
1298
- "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
1299
- }
1300
- },
1301
- {
1302
- "kind": "method",
1303
- "name": "requestContentUpdate",
1304
- "description": "Requests an update for the content of the overlay.\nWhile performing the update, it invokes the renderer passed in the `renderer` property.\n\nIt is not guaranteed that the update happens immediately (synchronously) after it is requested.",
1305
- "inheritedFrom": {
1306
- "name": "OverlayMixin",
1307
- "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
1308
- }
1309
- },
1310
- {
1311
- "kind": "field",
1312
- "name": "requiredVerticalSpace",
1313
- "privacy": "public",
1314
- "type": {
1315
- "text": "number"
1316
- },
1317
- "description": "If the overlay content has no intrinsic height, this property can be used to set\nthe minimum vertical space (in pixels) required by the overlay. Setting a value to\nthe property effectively disables the content measurement in favor of using this\nfixed value for determining the open direction.",
1318
- "attribute": "required-vertical-space",
1319
- "inheritedFrom": {
1320
- "name": "PositionMixin",
1321
- "package": "@vaadin/overlay/src/vaadin-overlay-position-mixin.js"
1322
- }
1323
- },
1324
- {
1325
- "kind": "method",
1326
- "name": "setBounds",
1327
- "parameters": [
1328
- {
1329
- "name": "bounds",
1330
- "type": {
1331
- "text": "!OverlayBoundsParam"
1332
- }
1333
- },
1334
- {
1335
- "name": "absolute",
1336
- "default": "true",
1337
- "type": {
1338
- "text": "boolean"
1339
- }
1340
- }
1341
- ],
1342
- "description": "Updates the coordinates of the overlay.",
1343
- "inheritedFrom": {
1344
- "name": "OverlayMixin",
1345
- "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
1346
- }
1347
- },
1348
- {
1349
- "kind": "field",
1350
- "name": "verticalAlign",
1351
- "privacy": "public",
1352
- "type": {
1353
- "text": "string"
1354
- },
1355
- "description": "When `positionTarget` is set, this property defines whether to align the overlay's\ntop or bottom side to the target element by default.\nPossible values are `top` and `bottom`.\nThe overlay is automatically flipped to the opposite side when it doesn't fit into\nthe default side defined by this property.",
1356
- "attribute": "vertical-align",
1357
- "inheritedFrom": {
1358
- "name": "PositionMixin",
1359
- "package": "@vaadin/overlay/src/vaadin-overlay-position-mixin.js"
1360
- }
1361
- },
1362
- {
1363
- "kind": "field",
1364
- "name": "withBackdrop",
1365
- "privacy": "public",
1366
- "type": {
1367
- "text": "boolean"
1368
- },
1369
- "description": "When true the overlay has backdrop on top of content when opened.",
1370
- "attribute": "with-backdrop",
1371
- "inheritedFrom": {
1372
- "name": "OverlayMixin",
1373
- "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
1374
- }
1375
- }
1376
- ],
1377
- "mixins": [
1378
- {
1379
- "name": "SelectOverlayMixin",
1380
- "module": "src/vaadin-select-overlay-mixin.js"
1381
- },
1382
- {
1383
- "name": "ThemableMixin",
1384
- "package": "@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js"
1385
- },
1386
- {
1387
- "name": "PolylitMixin",
1388
- "package": "@vaadin/component-base/src/polylit-mixin.js"
1389
- },
1390
- {
1391
- "name": "LumoInjectionMixin",
1392
- "package": "@vaadin/vaadin-themable-mixin/lumo-injection-mixin.js"
1393
- }
1394
- ],
1395
- "superclass": {
1396
- "name": "LitElement",
1397
- "package": "lit"
1398
- },
1399
- "tagName": "vaadin-select-overlay",
1400
- "customElement": true,
1401
- "attributes": [
1402
- {
1403
- "name": "hidden",
1404
- "type": {
1405
- "text": "boolean"
1406
- },
1407
- "description": "When set to true, the overlay is hidden. This also closes the overlay\nimmediately in case there is a closing animation in progress.",
1408
- "fieldName": "hidden",
1409
- "inheritedFrom": {
1410
- "name": "OverlayMixin",
1411
- "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
1412
- }
1413
- },
1414
- {
1415
- "name": "horizontal-align",
1416
- "type": {
1417
- "text": "string"
1418
- },
1419
- "description": "When `positionTarget` is set, this property defines whether to align the overlay's\nleft or right side to the target element by default.\nPossible values are `start` and `end`.\nRTL is taken into account when interpreting the value.\nThe overlay is automatically flipped to the opposite side when it doesn't fit into\nthe default side defined by this property.",
1420
- "fieldName": "horizontalAlign",
1421
- "inheritedFrom": {
1422
- "name": "PositionMixin",
1423
- "package": "@vaadin/overlay/src/vaadin-overlay-position-mixin.js"
1424
- }
1425
- },
1426
- {
1427
- "name": "modeless",
1428
- "type": {
1429
- "text": "boolean"
1430
- },
1431
- "description": "When true the overlay won't disable the main content, showing\nit doesn't change the functionality of the user interface.",
1432
- "fieldName": "modeless",
1433
- "inheritedFrom": {
1434
- "name": "OverlayMixin",
1435
- "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
1436
- }
1437
- },
1438
- {
1439
- "name": "no-horizontal-overlap",
1440
- "type": {
1441
- "text": "boolean"
1442
- },
1443
- "description": "When `positionTarget` is set, this property defines whether the overlay should overlap\nthe target element in the x-axis, or be positioned right next to it.",
1444
- "fieldName": "noHorizontalOverlap",
1445
- "inheritedFrom": {
1446
- "name": "PositionMixin",
1447
- "package": "@vaadin/overlay/src/vaadin-overlay-position-mixin.js"
1448
- }
1449
- },
1450
- {
1451
- "name": "no-vertical-overlap",
1452
- "type": {
1453
- "text": "boolean"
1454
- },
1455
- "description": "When `positionTarget` is set, this property defines whether the overlay should overlap\nthe target element in the y-axis, or be positioned right above/below it.",
1456
- "fieldName": "noVerticalOverlap",
1457
- "inheritedFrom": {
1458
- "name": "PositionMixin",
1459
- "package": "@vaadin/overlay/src/vaadin-overlay-position-mixin.js"
1460
- }
1461
- },
1462
- {
1463
- "name": "opened",
1464
- "type": {
1465
- "text": "boolean"
1466
- },
1467
- "description": "When true, the overlay is visible and attached to body.",
1468
- "fieldName": "opened",
1469
- "inheritedFrom": {
1470
- "name": "OverlayMixin",
1471
- "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
1472
- }
1473
- },
1474
- {
1475
- "name": "owner",
1476
- "type": {
1477
- "text": "HTMLElement"
1478
- },
1479
- "description": "Owner element passed with renderer function",
1480
- "fieldName": "owner",
1481
- "inheritedFrom": {
1482
- "name": "OverlayMixin",
1483
- "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
1484
- }
1485
- },
1486
- {
1487
- "name": "renderer",
1488
- "type": {
1489
- "text": "OverlayRenderer | null | undefined"
1490
- },
1491
- "description": "Custom function for rendering the content of the overlay.\nReceives three arguments:\n\n- `root` The root container DOM element. Append your content to it.\n- `owner` The host element of the renderer function.\n- `model` The object with the properties related with rendering.",
1492
- "fieldName": "renderer",
1493
- "inheritedFrom": {
1494
- "name": "OverlayMixin",
1495
- "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
1496
- }
1497
- },
1498
- {
1499
- "name": "required-vertical-space",
1500
- "type": {
1501
- "text": "number"
1502
- },
1503
- "description": "If the overlay content has no intrinsic height, this property can be used to set\nthe minimum vertical space (in pixels) required by the overlay. Setting a value to\nthe property effectively disables the content measurement in favor of using this\nfixed value for determining the open direction.",
1504
- "fieldName": "requiredVerticalSpace",
1505
- "inheritedFrom": {
1506
- "name": "PositionMixin",
1507
- "package": "@vaadin/overlay/src/vaadin-overlay-position-mixin.js"
1508
- }
1509
- },
1510
- {
1511
- "name": "vertical-align",
1512
- "type": {
1513
- "text": "string"
1514
- },
1515
- "description": "When `positionTarget` is set, this property defines whether to align the overlay's\ntop or bottom side to the target element by default.\nPossible values are `top` and `bottom`.\nThe overlay is automatically flipped to the opposite side when it doesn't fit into\nthe default side defined by this property.",
1516
- "fieldName": "verticalAlign",
1517
- "inheritedFrom": {
1518
- "name": "PositionMixin",
1519
- "package": "@vaadin/overlay/src/vaadin-overlay-position-mixin.js"
1520
- }
1521
- },
1522
- {
1523
- "name": "with-backdrop",
1524
- "type": {
1525
- "text": "boolean"
1526
- },
1527
- "description": "When true the overlay has backdrop on top of content when opened.",
1528
- "fieldName": "withBackdrop",
1529
- "inheritedFrom": {
1530
- "name": "OverlayMixin",
1531
- "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
1532
- }
1533
- }
1534
- ],
1535
- "events": [
1536
- {
1537
- "name": "vaadin-overlay-closed",
1538
- "type": {
1539
- "text": "CustomEvent"
1540
- },
1541
- "inheritedFrom": {
1542
- "name": "OverlayMixin",
1543
- "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
1544
- }
1545
- },
1546
- {
1547
- "name": "vaadin-overlay-closing",
1548
- "type": {
1549
- "text": "CustomEvent"
1550
- },
1551
- "inheritedFrom": {
1552
- "name": "OverlayMixin",
1553
- "package": "@vaadin/overlay/src/vaadin-overlay-mixin.js"
1554
- }
1555
- }
1556
- ]
1557
- }
1558
- ],
1559
- "exports": [
1560
- {
1561
- "kind": "js",
1562
- "name": "SelectOverlay",
1563
- "declaration": {
1564
- "name": "SelectOverlay",
1565
- "module": "src/vaadin-select-overlay.js"
1566
- }
1567
- }
1568
- ]
1569
- },
1570
- {
1571
- "kind": "javascript-module",
1572
- "path": "src/vaadin-select-value-button.js",
1573
- "declarations": [],
1574
- "exports": []
1575
- },
1576
- {
1577
- "kind": "javascript-module",
1578
- "path": "src/vaadin-select.js",
1579
- "declarations": [
1580
- {
1581
- "kind": "class",
1582
- "description": "`<vaadin-select>` is a Web Component for selecting values from a list of items.\n\n### Items\n\nUse the `items` property to define possible options for the select:\n\n```html\n<vaadin-select id=\"select\"></vaadin-select>\n```\n```js\nconst select = document.querySelector('#select');\nselect.items = [\n { label: 'Most recent first', value: 'recent' },\n { component: 'hr' },\n { label: 'Rating: low to high', value: 'rating-asc', className: 'asc' },\n { label: 'Rating: high to low', value: 'rating-desc', className: 'desc' },\n { component: 'hr' },\n { label: 'Price: low to high', value: 'price-asc', disabled: true },\n { label: 'Price: high to low', value: 'price-desc', disabled: true }\n];\n```\n\n### Rendering\n\nAlternatively, the content of the select can be populated by using the renderer callback function.\n\nThe renderer function provides `root`, `select` arguments.\nGenerate DOM content, append it to the `root` element and control the state\nof the host element by accessing `select`.\n\n```js\nconst select = document.querySelector('#select');\nselect.renderer = function(root, select) {\n const listBox = document.createElement('vaadin-list-box');\n // append 3 <vaadin-item> elements\n ['Jose', 'Manolo', 'Pedro'].forEach(function(name) {\n const item = document.createElement('vaadin-item');\n item.textContent = name;\n item.setAttribute('label', name)\n listBox.appendChild(item);\n });\n\n // update the content\n root.appendChild(listBox);\n};\n```\n\nRenderer is called on initialization of new select and on its opening.\nDOM generated during the renderer call can be reused\nin the next renderer call and will be provided with the `root` argument.\nOn first call it will be empty.\n\n* Hint: By setting the `label` property of inner vaadin-items you will\nbe able to change the visual representation of the selected value in the input part.\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-select-overlay-width` | Width of the overlay |\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 toggle button\n`field-button` | Set on the toggle 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`backdrop` | Backdrop of the overlay\n`overlay` | The overlay container\n`content` | The overlay content\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`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`phone` | Set when the overlay is shown in phone mode\n\n### Internal components\n\nIn addition to `<vaadin-select>` itself, the following internal\ncomponents are themable:\n\n- `<vaadin-select-value-button>` - has the same API as [`<vaadin-button>`](#/elements/vaadin-button).\n- `<vaadin-select-list-box>` - has the same API as [`<vaadin-list-box>`](#/elements/vaadin-list-box).\n- `<vaadin-select-item>` - has the same API as [`<vaadin-item>`](#/elements/vaadin-item).\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.",
1583
- "name": "Select",
1584
- "members": [
1585
- {
1586
- "kind": "field",
1587
- "name": "accessibleName",
1588
- "privacy": "public",
1589
- "type": {
1590
- "text": "string"
1591
- },
1592
- "description": "String used to label the component to screen reader users.",
1593
- "attribute": "accessible-name",
1594
- "inheritedFrom": {
1595
- "name": "FieldMixin",
1596
- "package": "@vaadin/field-base/src/field-mixin.js"
1597
- }
1598
- },
1599
- {
1600
- "kind": "field",
1601
- "name": "accessibleNameRef",
1602
- "privacy": "public",
1603
- "type": {
1604
- "text": "string"
1605
- },
1606
- "description": "Id of the element used as label of the component to screen reader users.",
1607
- "attribute": "accessible-name-ref",
1608
- "inheritedFrom": {
1609
- "name": "FieldMixin",
1610
- "package": "@vaadin/field-base/src/field-mixin.js"
1611
- }
1612
- },
1613
- {
1614
- "kind": "method",
1615
- "name": "checkValidity",
1616
- "description": "Returns true if the current value satisfies all constraints (if any)",
1617
- "return": {
1618
- "type": {
1619
- "text": "boolean"
1620
- }
1621
- },
1622
- "inheritedFrom": {
1623
- "name": "SelectBaseMixin",
1624
- "module": "src/vaadin-select-base-mixin.js"
1625
- }
1626
- },
1627
- {
1628
- "kind": "field",
1629
- "name": "errorMessage",
1630
- "privacy": "public",
1631
- "type": {
1632
- "text": "string"
1633
- },
1634
- "description": "Error to show when the field is invalid.",
1635
- "attribute": "error-message",
1636
- "inheritedFrom": {
1637
- "name": "FieldMixin",
1638
- "package": "@vaadin/field-base/src/field-mixin.js"
1639
- }
1640
- },
1641
- {
1642
- "kind": "field",
1643
- "name": "helperText",
940
+ "name": "helperText",
1644
941
  "privacy": "public",
1645
942
  "type": {
1646
943
  "text": "string"
@@ -1773,18 +1070,6 @@
1773
1070
  "module": "src/vaadin-select-base-mixin.js"
1774
1071
  }
1775
1072
  },
1776
- {
1777
- "kind": "field",
1778
- "name": "slotName",
1779
- "type": {
1780
- "text": "string"
1781
- },
1782
- "default": "'sr-label'",
1783
- "inheritedFrom": {
1784
- "name": "SelectBaseMixin",
1785
- "module": "src/vaadin-select-base-mixin.js"
1786
- }
1787
- },
1788
1073
  {
1789
1074
  "kind": "field",
1790
1075
  "name": "value",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vaadin/select",
3
- "version": "25.1.0-beta1",
3
+ "version": "25.1.0-beta3",
4
4
  "publishConfig": {
5
5
  "access": "public"
6
6
  },
@@ -37,30 +37,30 @@
37
37
  ],
38
38
  "dependencies": {
39
39
  "@open-wc/dedupe-mixin": "^1.3.0",
40
- "@vaadin/a11y-base": "25.1.0-beta1",
41
- "@vaadin/button": "25.1.0-beta1",
42
- "@vaadin/component-base": "25.1.0-beta1",
43
- "@vaadin/field-base": "25.1.0-beta1",
44
- "@vaadin/input-container": "25.1.0-beta1",
45
- "@vaadin/item": "25.1.0-beta1",
46
- "@vaadin/list-box": "25.1.0-beta1",
47
- "@vaadin/lit-renderer": "25.1.0-beta1",
48
- "@vaadin/overlay": "25.1.0-beta1",
49
- "@vaadin/vaadin-themable-mixin": "25.1.0-beta1",
40
+ "@vaadin/a11y-base": "25.1.0-beta3",
41
+ "@vaadin/button": "25.1.0-beta3",
42
+ "@vaadin/component-base": "25.1.0-beta3",
43
+ "@vaadin/field-base": "25.1.0-beta3",
44
+ "@vaadin/input-container": "25.1.0-beta3",
45
+ "@vaadin/item": "25.1.0-beta3",
46
+ "@vaadin/list-box": "25.1.0-beta3",
47
+ "@vaadin/lit-renderer": "25.1.0-beta3",
48
+ "@vaadin/overlay": "25.1.0-beta3",
49
+ "@vaadin/vaadin-themable-mixin": "25.1.0-beta3",
50
50
  "lit": "^3.0.0"
51
51
  },
52
52
  "devDependencies": {
53
- "@vaadin/aura": "25.1.0-beta1",
54
- "@vaadin/chai-plugins": "25.1.0-beta1",
55
- "@vaadin/test-runner-commands": "25.1.0-beta1",
53
+ "@vaadin/aura": "25.1.0-beta3",
54
+ "@vaadin/chai-plugins": "25.1.0-beta3",
55
+ "@vaadin/test-runner-commands": "25.1.0-beta3",
56
56
  "@vaadin/testing-helpers": "^2.0.0",
57
- "@vaadin/vaadin-lumo-styles": "25.1.0-beta1",
58
- "sinon": "^21.0.0"
57
+ "@vaadin/vaadin-lumo-styles": "25.1.0-beta3",
58
+ "sinon": "^21.0.2"
59
59
  },
60
60
  "customElements": "custom-elements.json",
61
61
  "web-types": [
62
62
  "web-types.json",
63
63
  "web-types.lit.json"
64
64
  ],
65
- "gitHead": "0ccf77c385fc6a92ac2a6344ce8804b94956226d"
65
+ "gitHead": "4251850231a42298fda23b83928da588831cdb5d"
66
66
  }
@@ -48,8 +48,6 @@ export declare class SelectBaseMixinClass {
48
48
  *
49
49
  * Note: each item is rendered by default as the internal `<vaadin-select-item>` that is an extension of `<vaadin-item>`.
50
50
  * To render the item with a custom component, provide a tag name by the `component` property.
51
- *
52
- * @type {!Array<!SelectItem>}
53
51
  */
54
52
  items: SelectItem[] | null | undefined;
55
53
 
@@ -53,7 +53,6 @@ export const SelectBaseMixin = (superClass) =>
53
53
 
54
54
  /**
55
55
  * Set when the select is open
56
- * @type {boolean}
57
56
  */
58
57
  opened: {
59
58
  type: Boolean,
@@ -86,7 +85,6 @@ export const SelectBaseMixin = (superClass) =>
86
85
  * Hint: If you do not want to select any item by default, you can either set all
87
86
  * the values of inner vaadin-items, or set the vaadin-select value to
88
87
  * an inexistent value in the items list.
89
- * @type {string}
90
88
  */
91
89
  value: {
92
90
  type: String,
@@ -116,7 +114,6 @@ export const SelectBaseMixin = (superClass) =>
116
114
 
117
115
  /**
118
116
  * When present, it specifies that the element is read-only.
119
- * @type {boolean}
120
117
  */
121
118
  readonly: {
122
119
  type: Boolean,
package/web-types.json CHANGED
@@ -1,14 +1,14 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/web-types",
3
3
  "name": "@vaadin/select",
4
- "version": "25.1.0-beta1",
4
+ "version": "25.1.0-beta3",
5
5
  "description-markup": "markdown",
6
6
  "contributions": {
7
7
  "html": {
8
8
  "elements": [
9
9
  {
10
10
  "name": "vaadin-select",
11
- "description": "`<vaadin-select>` is a Web Component for selecting values from a list of items.\n\n### Items\n\nUse the `items` property to define possible options for the select:\n\n```html\n<vaadin-select id=\"select\"></vaadin-select>\n```\n```js\nconst select = document.querySelector('#select');\nselect.items = [\n { label: 'Most recent first', value: 'recent' },\n { component: 'hr' },\n { label: 'Rating: low to high', value: 'rating-asc', className: 'asc' },\n { label: 'Rating: high to low', value: 'rating-desc', className: 'desc' },\n { component: 'hr' },\n { label: 'Price: low to high', value: 'price-asc', disabled: true },\n { label: 'Price: high to low', value: 'price-desc', disabled: true }\n];\n```\n\n### Rendering\n\nAlternatively, the content of the select can be populated by using the renderer callback function.\n\nThe renderer function provides `root`, `select` arguments.\nGenerate DOM content, append it to the `root` element and control the state\nof the host element by accessing `select`.\n\n```js\nconst select = document.querySelector('#select');\nselect.renderer = function(root, select) {\n const listBox = document.createElement('vaadin-list-box');\n // append 3 <vaadin-item> elements\n ['Jose', 'Manolo', 'Pedro'].forEach(function(name) {\n const item = document.createElement('vaadin-item');\n item.textContent = name;\n item.setAttribute('label', name)\n listBox.appendChild(item);\n });\n\n // update the content\n root.appendChild(listBox);\n};\n```\n\nRenderer is called on initialization of new select and on its opening.\nDOM generated during the renderer call can be reused\nin the next renderer call and will be provided with the `root` argument.\nOn first call it will be empty.\n\n* Hint: By setting the `label` property of inner vaadin-items you will\nbe able to change the visual representation of the selected value in the input part.\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-select-overlay-width` | Width of the overlay |\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 toggle button\n`field-button` | Set on the toggle 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`backdrop` | Backdrop of the overlay\n`overlay` | The overlay container\n`content` | The overlay content\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`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`phone` | Set when the overlay is shown in phone mode\n\n### Internal components\n\nIn addition to `<vaadin-select>` itself, the following internal\ncomponents are themable:\n\n- `<vaadin-select-value-button>` - has the same API as [`<vaadin-button>`](https://cdn.vaadin.com/vaadin-web-components/25.1.0-beta1/#/elements/vaadin-button).\n- `<vaadin-select-list-box>` - has the same API as [`<vaadin-list-box>`](https://cdn.vaadin.com/vaadin-web-components/25.1.0-beta1/#/elements/vaadin-list-box).\n- `<vaadin-select-item>` - has the same API as [`<vaadin-item>`](https://cdn.vaadin.com/vaadin-web-components/25.1.0-beta1/#/elements/vaadin-item).\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.",
11
+ "description": "`<vaadin-select>` is a Web Component for selecting values from a list of items.\n\n### Items\n\nUse the `items` property to define possible options for the select:\n\n```html\n<vaadin-select id=\"select\"></vaadin-select>\n```\n```js\nconst select = document.querySelector('#select');\nselect.items = [\n { label: 'Most recent first', value: 'recent' },\n { component: 'hr' },\n { label: 'Rating: low to high', value: 'rating-asc', className: 'asc' },\n { label: 'Rating: high to low', value: 'rating-desc', className: 'desc' },\n { component: 'hr' },\n { label: 'Price: low to high', value: 'price-asc', disabled: true },\n { label: 'Price: high to low', value: 'price-desc', disabled: true }\n];\n```\n\n### Rendering\n\nAlternatively, the content of the select can be populated by using the renderer callback function.\n\nThe renderer function provides `root`, `select` arguments.\nGenerate DOM content, append it to the `root` element and control the state\nof the host element by accessing `select`.\n\n```js\nconst select = document.querySelector('#select');\nselect.renderer = function(root, select) {\n const listBox = document.createElement('vaadin-list-box');\n // append 3 <vaadin-item> elements\n ['Jose', 'Manolo', 'Pedro'].forEach(function(name) {\n const item = document.createElement('vaadin-item');\n item.textContent = name;\n item.setAttribute('label', name)\n listBox.appendChild(item);\n });\n\n // update the content\n root.appendChild(listBox);\n};\n```\n\nRenderer is called on initialization of new select and on its opening.\nDOM generated during the renderer call can be reused\nin the next renderer call and will be provided with the `root` argument.\nOn first call it will be empty.\n\n* Hint: By setting the `label` property of inner vaadin-items you will\nbe able to change the visual representation of the selected value in the input part.\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-select-overlay-width` | Width of the overlay |\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 toggle button\n`field-button` | Set on the toggle 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`backdrop` | Backdrop of the overlay\n`overlay` | The overlay container\n`content` | The overlay content\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`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`phone` | Set when the overlay is shown in phone mode\n\n### Internal components\n\nIn addition to `<vaadin-select>` itself, the following internal\ncomponents are themable:\n\n- `<vaadin-select-value-button>` - has the same API as [`<vaadin-button>`](https://cdn.vaadin.com/vaadin-web-components/25.1.0-beta3/#/elements/vaadin-button).\n- `<vaadin-select-list-box>` - has the same API as [`<vaadin-list-box>`](https://cdn.vaadin.com/vaadin-web-components/25.1.0-beta3/#/elements/vaadin-list-box).\n- `<vaadin-select-item>` - has the same API as [`<vaadin-item>`](https://cdn.vaadin.com/vaadin-web-components/25.1.0-beta3/#/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",
@@ -136,7 +136,9 @@
136
136
  "description": "Set when the select is open",
137
137
  "value": {
138
138
  "type": [
139
- "boolean"
139
+ "boolean",
140
+ "null",
141
+ "undefined"
140
142
  ]
141
143
  }
142
144
  },
@@ -156,7 +158,9 @@
156
158
  "description": "When present, it specifies that the element is read-only.",
157
159
  "value": {
158
160
  "type": [
159
- "boolean"
161
+ "boolean",
162
+ "null",
163
+ "undefined"
160
164
  ]
161
165
  }
162
166
  },
@@ -187,7 +191,9 @@
187
191
  "description": "The `value` property of the selected item, or an empty string\nif no item is selected.\nOn change or initialization, the component finds the item which matches the\nvalue and displays it.\nIf no value is provided to the component, it selects the first item without\nvalue or empty value.\nHint: If you do not want to select any item by default, you can either set all\nthe values of inner vaadin-items, or set the vaadin-select value to\nan inexistent value in the items list.",
188
192
  "value": {
189
193
  "type": [
190
- "string"
194
+ "string",
195
+ "null",
196
+ "undefined"
191
197
  ]
192
198
  }
193
199
  }
@@ -329,7 +335,9 @@
329
335
  "description": "Set when the select is open",
330
336
  "value": {
331
337
  "type": [
332
- "boolean"
338
+ "boolean",
339
+ "null",
340
+ "undefined"
333
341
  ]
334
342
  }
335
343
  },
@@ -349,7 +357,9 @@
349
357
  "description": "When present, it specifies that the element is read-only.",
350
358
  "value": {
351
359
  "type": [
352
- "boolean"
360
+ "boolean",
361
+ "null",
362
+ "undefined"
353
363
  ]
354
364
  }
355
365
  },
@@ -379,7 +389,9 @@
379
389
  "description": "The `value` property of the selected item, or an empty string\nif no item is selected.\nOn change or initialization, the component finds the item which matches the\nvalue and displays it.\nIf no value is provided to the component, it selects the first item without\nvalue or empty value.\nHint: If you do not want to select any item by default, you can either set all\nthe values of inner vaadin-items, or set the vaadin-select value to\nan inexistent value in the items list.",
380
390
  "value": {
381
391
  "type": [
382
- "string"
392
+ "string",
393
+ "null",
394
+ "undefined"
383
395
  ]
384
396
  }
385
397
  }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/web-types",
3
3
  "name": "@vaadin/select",
4
- "version": "25.1.0-beta1",
4
+ "version": "25.1.0-beta3",
5
5
  "description-markup": "markdown",
6
6
  "framework": "lit",
7
7
  "framework-config": {
@@ -16,7 +16,7 @@
16
16
  "elements": [
17
17
  {
18
18
  "name": "vaadin-select",
19
- "description": "`<vaadin-select>` is a Web Component for selecting values from a list of items.\n\n### Items\n\nUse the `items` property to define possible options for the select:\n\n```html\n<vaadin-select id=\"select\"></vaadin-select>\n```\n```js\nconst select = document.querySelector('#select');\nselect.items = [\n { label: 'Most recent first', value: 'recent' },\n { component: 'hr' },\n { label: 'Rating: low to high', value: 'rating-asc', className: 'asc' },\n { label: 'Rating: high to low', value: 'rating-desc', className: 'desc' },\n { component: 'hr' },\n { label: 'Price: low to high', value: 'price-asc', disabled: true },\n { label: 'Price: high to low', value: 'price-desc', disabled: true }\n];\n```\n\n### Rendering\n\nAlternatively, the content of the select can be populated by using the renderer callback function.\n\nThe renderer function provides `root`, `select` arguments.\nGenerate DOM content, append it to the `root` element and control the state\nof the host element by accessing `select`.\n\n```js\nconst select = document.querySelector('#select');\nselect.renderer = function(root, select) {\n const listBox = document.createElement('vaadin-list-box');\n // append 3 <vaadin-item> elements\n ['Jose', 'Manolo', 'Pedro'].forEach(function(name) {\n const item = document.createElement('vaadin-item');\n item.textContent = name;\n item.setAttribute('label', name)\n listBox.appendChild(item);\n });\n\n // update the content\n root.appendChild(listBox);\n};\n```\n\nRenderer is called on initialization of new select and on its opening.\nDOM generated during the renderer call can be reused\nin the next renderer call and will be provided with the `root` argument.\nOn first call it will be empty.\n\n* Hint: By setting the `label` property of inner vaadin-items you will\nbe able to change the visual representation of the selected value in the input part.\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-select-overlay-width` | Width of the overlay |\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 toggle button\n`field-button` | Set on the toggle 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`backdrop` | Backdrop of the overlay\n`overlay` | The overlay container\n`content` | The overlay content\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`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`phone` | Set when the overlay is shown in phone mode\n\n### Internal components\n\nIn addition to `<vaadin-select>` itself, the following internal\ncomponents are themable:\n\n- `<vaadin-select-value-button>` - has the same API as [`<vaadin-button>`](https://cdn.vaadin.com/vaadin-web-components/25.1.0-beta1/#/elements/vaadin-button).\n- `<vaadin-select-list-box>` - has the same API as [`<vaadin-list-box>`](https://cdn.vaadin.com/vaadin-web-components/25.1.0-beta1/#/elements/vaadin-list-box).\n- `<vaadin-select-item>` - has the same API as [`<vaadin-item>`](https://cdn.vaadin.com/vaadin-web-components/25.1.0-beta1/#/elements/vaadin-item).\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.",
19
+ "description": "`<vaadin-select>` is a Web Component for selecting values from a list of items.\n\n### Items\n\nUse the `items` property to define possible options for the select:\n\n```html\n<vaadin-select id=\"select\"></vaadin-select>\n```\n```js\nconst select = document.querySelector('#select');\nselect.items = [\n { label: 'Most recent first', value: 'recent' },\n { component: 'hr' },\n { label: 'Rating: low to high', value: 'rating-asc', className: 'asc' },\n { label: 'Rating: high to low', value: 'rating-desc', className: 'desc' },\n { component: 'hr' },\n { label: 'Price: low to high', value: 'price-asc', disabled: true },\n { label: 'Price: high to low', value: 'price-desc', disabled: true }\n];\n```\n\n### Rendering\n\nAlternatively, the content of the select can be populated by using the renderer callback function.\n\nThe renderer function provides `root`, `select` arguments.\nGenerate DOM content, append it to the `root` element and control the state\nof the host element by accessing `select`.\n\n```js\nconst select = document.querySelector('#select');\nselect.renderer = function(root, select) {\n const listBox = document.createElement('vaadin-list-box');\n // append 3 <vaadin-item> elements\n ['Jose', 'Manolo', 'Pedro'].forEach(function(name) {\n const item = document.createElement('vaadin-item');\n item.textContent = name;\n item.setAttribute('label', name)\n listBox.appendChild(item);\n });\n\n // update the content\n root.appendChild(listBox);\n};\n```\n\nRenderer is called on initialization of new select and on its opening.\nDOM generated during the renderer call can be reused\nin the next renderer call and will be provided with the `root` argument.\nOn first call it will be empty.\n\n* Hint: By setting the `label` property of inner vaadin-items you will\nbe able to change the visual representation of the selected value in the input part.\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-select-overlay-width` | Width of the overlay |\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 toggle button\n`field-button` | Set on the toggle 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`backdrop` | Backdrop of the overlay\n`overlay` | The overlay container\n`content` | The overlay content\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`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`phone` | Set when the overlay is shown in phone mode\n\n### Internal components\n\nIn addition to `<vaadin-select>` itself, the following internal\ncomponents are themable:\n\n- `<vaadin-select-value-button>` - has the same API as [`<vaadin-button>`](https://cdn.vaadin.com/vaadin-web-components/25.1.0-beta3/#/elements/vaadin-button).\n- `<vaadin-select-list-box>` - has the same API as [`<vaadin-list-box>`](https://cdn.vaadin.com/vaadin-web-components/25.1.0-beta3/#/elements/vaadin-list-box).\n- `<vaadin-select-item>` - has the same API as [`<vaadin-item>`](https://cdn.vaadin.com/vaadin-web-components/25.1.0-beta3/#/elements/vaadin-item).\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.",
20
20
  "extension": true,
21
21
  "attributes": [
22
22
  {