@warp-ds/elements 2.10.0-next.2 → 2.10.0-next.4
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.
- package/dist/custom-elements.json +149 -69
- package/dist/docs/combobox/accessibility.md +71 -0
- package/dist/docs/combobox/api.md +60 -30
- package/dist/docs/combobox/combobox.md +203 -30
- package/dist/docs/combobox/examples.md +44 -0
- package/dist/docs/combobox/usage.md +28 -0
- package/dist/docs/icon/accessibility.md +5 -0
- package/dist/docs/icon/api.md +37 -0
- package/dist/docs/icon/examples.md +45 -0
- package/dist/docs/icon/icon.md +107 -0
- package/dist/docs/icon/usage.md +11 -0
- package/dist/docs/link/api.md +18 -22
- package/dist/docs/link/examples.md +75 -0
- package/dist/docs/link/link.md +111 -22
- package/dist/docs/link/usage.md +18 -0
- package/dist/index.d.ts +443 -171
- package/dist/packages/affix/affix.js +3 -3
- package/dist/packages/affix/affix.js.map +3 -3
- package/dist/packages/alert/alert.js +1 -1
- package/dist/packages/alert/alert.js.map +3 -3
- package/dist/packages/attention/attention.js.map +3 -3
- package/dist/packages/button/button.js.map +2 -2
- package/dist/packages/checkbox/checkbox.d.ts +40 -11
- package/dist/packages/checkbox/checkbox.js.map +2 -2
- package/dist/packages/checkbox-group/checkbox-group.d.ts +30 -5
- package/dist/packages/checkbox-group/checkbox-group.js.map +2 -2
- package/dist/packages/combobox/combobox.a11y.test.js +24 -0
- package/dist/packages/combobox/combobox.d.ts +65 -45
- package/dist/packages/combobox/combobox.hydration.test.js +39 -1
- package/dist/packages/combobox/combobox.js +13 -13
- package/dist/packages/combobox/combobox.js.map +3 -3
- package/dist/packages/combobox/combobox.stories.js +28 -15
- package/dist/packages/combobox/combobox.test.js +110 -0
- package/dist/packages/datepicker/datepicker.js.map +3 -3
- package/dist/packages/expandable/expandable.js +2 -2
- package/dist/packages/expandable/expandable.js.map +3 -3
- package/dist/packages/icon/icon.d.ts +13 -3
- package/dist/packages/icon/icon.js +2 -2
- package/dist/packages/icon/icon.js.map +3 -3
- package/dist/packages/icon/icon.react.stories.d.ts +1 -1
- package/dist/packages/icon/react.d.ts +2 -2
- package/dist/packages/link/link.d.ts +15 -16
- package/dist/packages/link/link.js.map +2 -2
- package/dist/packages/modal/modal.d.ts +1 -0
- package/dist/packages/modal/modal.js +4 -4
- package/dist/packages/modal/modal.js.map +2 -2
- package/dist/packages/modal-header/modal-header.js +1 -1
- package/dist/packages/modal-header/modal-header.js.map +3 -3
- package/dist/packages/pagination/pagination.js.map +3 -3
- package/dist/packages/pill/pill.js.map +3 -3
- package/dist/packages/select/select.js.map +3 -3
- package/dist/packages/step/step.js +1 -1
- package/dist/packages/step/step.js.map +3 -3
- package/dist/packages/toast/toast.js +3 -3
- package/dist/packages/toast/toast.js.map +3 -3
- package/dist/packages/toast/toast.stories.d.ts +1 -5
- package/dist/packages/toast/toast.stories.js +0 -17
- package/dist/web-types.json +129 -72
- package/package.json +1 -1
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
{
|
|
10
10
|
"kind": "class",
|
|
11
11
|
"description": "",
|
|
12
|
-
"name": "
|
|
12
|
+
"name": "WarpIcon",
|
|
13
13
|
"members": [
|
|
14
14
|
{
|
|
15
15
|
"kind": "field",
|
|
@@ -27,7 +27,8 @@
|
|
|
27
27
|
"type": {
|
|
28
28
|
"text": "'small' | 'medium' | 'large' | string"
|
|
29
29
|
},
|
|
30
|
-
"description": "Size: small, medium, large or pixel value (e.g. \"32px\")",
|
|
30
|
+
"description": "Size: small, medium, large or pixel value (e.g. \"32px\").",
|
|
31
|
+
"default": "\"medium\"",
|
|
31
32
|
"attribute": "size",
|
|
32
33
|
"reflects": true
|
|
33
34
|
},
|
|
@@ -37,7 +38,7 @@
|
|
|
37
38
|
"type": {
|
|
38
39
|
"text": "string"
|
|
39
40
|
},
|
|
40
|
-
"description": "Locale used
|
|
41
|
+
"description": "Locale used for `<title>` text.\n\nReads the `lang` attribute from `<html>`, falls back to 'en'.",
|
|
41
42
|
"attribute": "locale",
|
|
42
43
|
"reflects": true
|
|
43
44
|
},
|
|
@@ -96,7 +97,8 @@
|
|
|
96
97
|
"type": {
|
|
97
98
|
"text": "'small' | 'medium' | 'large' | string"
|
|
98
99
|
},
|
|
99
|
-
"description": "Size: small, medium, large or pixel value (e.g. \"32px\")",
|
|
100
|
+
"description": "Size: small, medium, large or pixel value (e.g. \"32px\").",
|
|
101
|
+
"default": "\"medium\"",
|
|
100
102
|
"fieldName": "size"
|
|
101
103
|
},
|
|
102
104
|
{
|
|
@@ -104,7 +106,7 @@
|
|
|
104
106
|
"type": {
|
|
105
107
|
"text": "string"
|
|
106
108
|
},
|
|
107
|
-
"description": "Locale used
|
|
109
|
+
"description": "Locale used for `<title>` text.\n\nReads the `lang` attribute from `<html>`, falls back to 'en'.",
|
|
108
110
|
"fieldName": "locale"
|
|
109
111
|
}
|
|
110
112
|
],
|
|
@@ -116,9 +118,23 @@
|
|
|
116
118
|
"customElement": true,
|
|
117
119
|
"modulePath": "packages/icon/icon.ts",
|
|
118
120
|
"definitionPath": "packages/icon/icon.ts"
|
|
121
|
+
},
|
|
122
|
+
{
|
|
123
|
+
"kind": "variable",
|
|
124
|
+
"name": "WIcon",
|
|
125
|
+
"default": "WarpIcon",
|
|
126
|
+
"deprecated": "Exported for backwards compatibility. Use WarpIcon."
|
|
119
127
|
}
|
|
120
128
|
],
|
|
121
129
|
"exports": [
|
|
130
|
+
{
|
|
131
|
+
"kind": "js",
|
|
132
|
+
"name": "WarpIcon",
|
|
133
|
+
"declaration": {
|
|
134
|
+
"name": "WarpIcon",
|
|
135
|
+
"module": "packages/icon/icon.ts"
|
|
136
|
+
}
|
|
137
|
+
},
|
|
122
138
|
{
|
|
123
139
|
"kind": "js",
|
|
124
140
|
"name": "WIcon",
|
|
@@ -131,7 +147,7 @@
|
|
|
131
147
|
"kind": "custom-element-definition",
|
|
132
148
|
"name": "w-icon",
|
|
133
149
|
"declaration": {
|
|
134
|
-
"name": "
|
|
150
|
+
"name": "WarpIcon",
|
|
135
151
|
"module": "packages/icon/icon.ts"
|
|
136
152
|
}
|
|
137
153
|
}
|
|
@@ -942,15 +958,6 @@
|
|
|
942
958
|
"description": "Buttons are used to perform actions, with different visuals for different needs.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/buttons-link--docs)",
|
|
943
959
|
"name": "WarpLink",
|
|
944
960
|
"members": [
|
|
945
|
-
{
|
|
946
|
-
"kind": "field",
|
|
947
|
-
"name": "shadowRootOptions",
|
|
948
|
-
"type": {
|
|
949
|
-
"text": "object"
|
|
950
|
-
},
|
|
951
|
-
"static": true,
|
|
952
|
-
"default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }"
|
|
953
|
-
},
|
|
954
961
|
{
|
|
955
962
|
"kind": "field",
|
|
956
963
|
"name": "autofocus",
|
|
@@ -958,6 +965,7 @@
|
|
|
958
965
|
"text": "boolean"
|
|
959
966
|
},
|
|
960
967
|
"default": "false",
|
|
968
|
+
"description": "Focus the link after it is rendered",
|
|
961
969
|
"attribute": "autofocus",
|
|
962
970
|
"reflects": true
|
|
963
971
|
},
|
|
@@ -967,6 +975,7 @@
|
|
|
967
975
|
"type": {
|
|
968
976
|
"text": "ButtonVariant"
|
|
969
977
|
},
|
|
978
|
+
"description": "Visual style for the link/button.",
|
|
970
979
|
"attribute": "variant",
|
|
971
980
|
"reflects": true,
|
|
972
981
|
"parsedType": {
|
|
@@ -980,6 +989,7 @@
|
|
|
980
989
|
"text": "boolean"
|
|
981
990
|
},
|
|
982
991
|
"default": "false",
|
|
992
|
+
"description": "Render a smaller version",
|
|
983
993
|
"attribute": "small",
|
|
984
994
|
"reflects": true
|
|
985
995
|
},
|
|
@@ -989,6 +999,7 @@
|
|
|
989
999
|
"type": {
|
|
990
1000
|
"text": "string"
|
|
991
1001
|
},
|
|
1002
|
+
"description": "The URL the link points to",
|
|
992
1003
|
"attribute": "href",
|
|
993
1004
|
"reflects": true
|
|
994
1005
|
},
|
|
@@ -999,6 +1010,7 @@
|
|
|
999
1010
|
"text": "boolean"
|
|
1000
1011
|
},
|
|
1001
1012
|
"default": "false",
|
|
1013
|
+
"description": "Applies disabled styling, but you need to disable clicks on your own.\n\nThe component renders an `<a>` element; `disabled` affects styling, but does not inherently prevent navigation. If you need to fully disable interaction, omit `href` and/or prevent default click behavior.",
|
|
1002
1014
|
"attribute": "disabled",
|
|
1003
1015
|
"reflects": true
|
|
1004
1016
|
},
|
|
@@ -1008,6 +1020,7 @@
|
|
|
1008
1020
|
"type": {
|
|
1009
1021
|
"text": "string"
|
|
1010
1022
|
},
|
|
1023
|
+
"description": "Where to display the linked URL (e.g. `_blank`)",
|
|
1011
1024
|
"attribute": "target",
|
|
1012
1025
|
"reflects": true
|
|
1013
1026
|
},
|
|
@@ -1017,6 +1030,7 @@
|
|
|
1017
1030
|
"type": {
|
|
1018
1031
|
"text": "string"
|
|
1019
1032
|
},
|
|
1033
|
+
"description": "Relationship of the linked URL.\n\nIf `target=\"_blank\"` and `rel` is not provided, the component uses `noopener`.",
|
|
1020
1034
|
"attribute": "rel",
|
|
1021
1035
|
"reflects": true
|
|
1022
1036
|
},
|
|
@@ -1027,6 +1041,7 @@
|
|
|
1027
1041
|
"text": "boolean"
|
|
1028
1042
|
},
|
|
1029
1043
|
"default": "false",
|
|
1044
|
+
"description": "Makes the link take up the full width of its parent",
|
|
1030
1045
|
"attribute": "full-width",
|
|
1031
1046
|
"reflects": true
|
|
1032
1047
|
}
|
|
@@ -1038,6 +1053,7 @@
|
|
|
1038
1053
|
"text": "boolean"
|
|
1039
1054
|
},
|
|
1040
1055
|
"default": "false",
|
|
1056
|
+
"description": "Focus the link after it is rendered",
|
|
1041
1057
|
"fieldName": "autofocus"
|
|
1042
1058
|
},
|
|
1043
1059
|
{
|
|
@@ -1045,6 +1061,7 @@
|
|
|
1045
1061
|
"type": {
|
|
1046
1062
|
"text": "ButtonVariant"
|
|
1047
1063
|
},
|
|
1064
|
+
"description": "Visual style for the link/button.",
|
|
1048
1065
|
"fieldName": "variant",
|
|
1049
1066
|
"parsedType": {
|
|
1050
1067
|
"text": "'negative' | 'primary' | 'secondary' | 'negativeQuiet' | 'utility' | 'quiet' | 'utilityQuiet' | 'overlay' | 'overlayInverted' | 'overlayQuiet' | 'overlayInvertedQuiet'"
|
|
@@ -1056,6 +1073,7 @@
|
|
|
1056
1073
|
"text": "boolean"
|
|
1057
1074
|
},
|
|
1058
1075
|
"default": "false",
|
|
1076
|
+
"description": "Render a smaller version",
|
|
1059
1077
|
"fieldName": "small"
|
|
1060
1078
|
},
|
|
1061
1079
|
{
|
|
@@ -1063,6 +1081,7 @@
|
|
|
1063
1081
|
"type": {
|
|
1064
1082
|
"text": "string"
|
|
1065
1083
|
},
|
|
1084
|
+
"description": "The URL the link points to",
|
|
1066
1085
|
"fieldName": "href"
|
|
1067
1086
|
},
|
|
1068
1087
|
{
|
|
@@ -1071,6 +1090,7 @@
|
|
|
1071
1090
|
"text": "boolean"
|
|
1072
1091
|
},
|
|
1073
1092
|
"default": "false",
|
|
1093
|
+
"description": "Applies disabled styling, but you need to disable clicks on your own.\n\nThe component renders an `<a>` element; `disabled` affects styling, but does not inherently prevent navigation. If you need to fully disable interaction, omit `href` and/or prevent default click behavior.",
|
|
1074
1094
|
"fieldName": "disabled"
|
|
1075
1095
|
},
|
|
1076
1096
|
{
|
|
@@ -1078,6 +1098,7 @@
|
|
|
1078
1098
|
"type": {
|
|
1079
1099
|
"text": "string"
|
|
1080
1100
|
},
|
|
1101
|
+
"description": "Where to display the linked URL (e.g. `_blank`)",
|
|
1081
1102
|
"fieldName": "target"
|
|
1082
1103
|
},
|
|
1083
1104
|
{
|
|
@@ -1085,6 +1106,7 @@
|
|
|
1085
1106
|
"type": {
|
|
1086
1107
|
"text": "string"
|
|
1087
1108
|
},
|
|
1109
|
+
"description": "Relationship of the linked URL.\n\nIf `target=\"_blank\"` and `rel` is not provided, the component uses `noopener`.",
|
|
1088
1110
|
"fieldName": "rel"
|
|
1089
1111
|
},
|
|
1090
1112
|
{
|
|
@@ -1093,6 +1115,7 @@
|
|
|
1093
1115
|
"text": "boolean"
|
|
1094
1116
|
},
|
|
1095
1117
|
"default": "false",
|
|
1118
|
+
"description": "Makes the link take up the full width of its parent",
|
|
1096
1119
|
"fieldName": "fullWidth"
|
|
1097
1120
|
}
|
|
1098
1121
|
],
|
|
@@ -2365,7 +2388,7 @@
|
|
|
2365
2388
|
{
|
|
2366
2389
|
"kind": "field",
|
|
2367
2390
|
"name": "name",
|
|
2368
|
-
"description": "The name of the checkbox, submitted
|
|
2391
|
+
"description": "The name of the checkbox.\n\nWhen the checkbox is checked and belongs to a form, this name is submitted with the checkbox value. If the checkbox is inside a `w-checkbox-group` with a name, the group name is used when the checkbox does not have its own name.",
|
|
2369
2392
|
"type": {
|
|
2370
2393
|
"text": "string | undefined"
|
|
2371
2394
|
},
|
|
@@ -2387,7 +2410,7 @@
|
|
|
2387
2410
|
"text": "string | null"
|
|
2388
2411
|
},
|
|
2389
2412
|
"default": "null",
|
|
2390
|
-
"description": "The value
|
|
2413
|
+
"description": "The value submitted when the checkbox is checked.\n\nIf no value attribute is set, the checkbox defaults to `on`. Unchecked and disabled checkboxes do not submit a value.",
|
|
2391
2414
|
"attribute": "value",
|
|
2392
2415
|
"reflects": true
|
|
2393
2416
|
},
|
|
@@ -2398,7 +2421,7 @@
|
|
|
2398
2421
|
"text": "boolean"
|
|
2399
2422
|
},
|
|
2400
2423
|
"default": "false",
|
|
2401
|
-
"description": "
|
|
2424
|
+
"description": "Whether the checkbox is visually indeterminate.\n\nUse this for parent options that represent a mixed set of child selections. Clicking the checkbox clears the indeterminate state and sets the checkbox to checked.",
|
|
2402
2425
|
"attribute": "indeterminate",
|
|
2403
2426
|
"reflects": true
|
|
2404
2427
|
},
|
|
@@ -2409,7 +2432,7 @@
|
|
|
2409
2432
|
"text": "boolean"
|
|
2410
2433
|
},
|
|
2411
2434
|
"default": "false",
|
|
2412
|
-
"description": "
|
|
2435
|
+
"description": "Whether the checkbox is checked.\n\nChecked checkboxes submit their value with form data. The property is reflected to the `checked` attribute.",
|
|
2413
2436
|
"attribute": "checked",
|
|
2414
2437
|
"reflects": true
|
|
2415
2438
|
},
|
|
@@ -2420,7 +2443,7 @@
|
|
|
2420
2443
|
"text": "boolean"
|
|
2421
2444
|
},
|
|
2422
2445
|
"default": "false",
|
|
2423
|
-
"description": "
|
|
2446
|
+
"description": "Whether the checkbox is disabled.\n\nDisabled checkboxes cannot be focused, changed, or submitted with form data.",
|
|
2424
2447
|
"attribute": "disabled",
|
|
2425
2448
|
"reflects": true
|
|
2426
2449
|
},
|
|
@@ -2431,7 +2454,7 @@
|
|
|
2431
2454
|
"text": "boolean"
|
|
2432
2455
|
},
|
|
2433
2456
|
"default": "false",
|
|
2434
|
-
"description": "
|
|
2457
|
+
"description": "Whether the checkbox must be checked before form submission.\n\nA required checkbox is invalid until it is checked. For requiring at least one option in a set, use `required` on `w-checkbox-group`.",
|
|
2435
2458
|
"attribute": "required",
|
|
2436
2459
|
"reflects": true
|
|
2437
2460
|
},
|
|
@@ -2442,10 +2465,28 @@
|
|
|
2442
2465
|
"text": "boolean"
|
|
2443
2466
|
},
|
|
2444
2467
|
"default": "false",
|
|
2445
|
-
"description": "
|
|
2468
|
+
"description": "Whether the checkbox is visually invalid.\n\nUse this to show an externally managed validation error. Required validation also sets the invalid state after the user interacts with the checkbox or tries to submit the form.",
|
|
2446
2469
|
"attribute": "invalid",
|
|
2447
2470
|
"reflects": true
|
|
2448
2471
|
},
|
|
2472
|
+
{
|
|
2473
|
+
"kind": "field",
|
|
2474
|
+
"name": "_groupInvalid",
|
|
2475
|
+
"type": {
|
|
2476
|
+
"text": "boolean | undefined"
|
|
2477
|
+
},
|
|
2478
|
+
"privacy": "private",
|
|
2479
|
+
"description": "Internal invalid state managed by parent checkbox-group.\nNon-reflecting to avoid DOM changes during hydration."
|
|
2480
|
+
},
|
|
2481
|
+
{
|
|
2482
|
+
"kind": "field",
|
|
2483
|
+
"name": "_groupName",
|
|
2484
|
+
"type": {
|
|
2485
|
+
"text": "string | undefined"
|
|
2486
|
+
},
|
|
2487
|
+
"privacy": "private",
|
|
2488
|
+
"description": "Internal name managed by parent checkbox-group.\nNon-reflecting to avoid DOM changes during hydration."
|
|
2489
|
+
},
|
|
2449
2490
|
{
|
|
2450
2491
|
"kind": "field",
|
|
2451
2492
|
"name": "#defaultChecked",
|
|
@@ -2596,7 +2637,7 @@
|
|
|
2596
2637
|
"attributes": [
|
|
2597
2638
|
{
|
|
2598
2639
|
"name": "name",
|
|
2599
|
-
"description": "The name of the checkbox, submitted
|
|
2640
|
+
"description": "The name of the checkbox.\n\nWhen the checkbox is checked and belongs to a form, this name is submitted with the checkbox value. If the checkbox is inside a `w-checkbox-group` with a name, the group name is used when the checkbox does not have its own name.",
|
|
2600
2641
|
"type": {
|
|
2601
2642
|
"text": "string | undefined"
|
|
2602
2643
|
},
|
|
@@ -2608,7 +2649,7 @@
|
|
|
2608
2649
|
"text": "string | null"
|
|
2609
2650
|
},
|
|
2610
2651
|
"default": "null",
|
|
2611
|
-
"description": "The value
|
|
2652
|
+
"description": "The value submitted when the checkbox is checked.\n\nIf no value attribute is set, the checkbox defaults to `on`. Unchecked and disabled checkboxes do not submit a value.",
|
|
2612
2653
|
"fieldName": "value"
|
|
2613
2654
|
},
|
|
2614
2655
|
{
|
|
@@ -2617,7 +2658,7 @@
|
|
|
2617
2658
|
"text": "boolean"
|
|
2618
2659
|
},
|
|
2619
2660
|
"default": "false",
|
|
2620
|
-
"description": "
|
|
2661
|
+
"description": "Whether the checkbox is visually indeterminate.\n\nUse this for parent options that represent a mixed set of child selections. Clicking the checkbox clears the indeterminate state and sets the checkbox to checked.",
|
|
2621
2662
|
"fieldName": "indeterminate"
|
|
2622
2663
|
},
|
|
2623
2664
|
{
|
|
@@ -2626,7 +2667,7 @@
|
|
|
2626
2667
|
"text": "boolean"
|
|
2627
2668
|
},
|
|
2628
2669
|
"default": "false",
|
|
2629
|
-
"description": "
|
|
2670
|
+
"description": "Whether the checkbox is checked.\n\nChecked checkboxes submit their value with form data. The property is reflected to the `checked` attribute.",
|
|
2630
2671
|
"fieldName": "checked"
|
|
2631
2672
|
},
|
|
2632
2673
|
{
|
|
@@ -2635,7 +2676,7 @@
|
|
|
2635
2676
|
"text": "boolean"
|
|
2636
2677
|
},
|
|
2637
2678
|
"default": "false",
|
|
2638
|
-
"description": "
|
|
2679
|
+
"description": "Whether the checkbox is disabled.\n\nDisabled checkboxes cannot be focused, changed, or submitted with form data.",
|
|
2639
2680
|
"fieldName": "disabled"
|
|
2640
2681
|
},
|
|
2641
2682
|
{
|
|
@@ -2644,7 +2685,7 @@
|
|
|
2644
2685
|
"text": "boolean"
|
|
2645
2686
|
},
|
|
2646
2687
|
"default": "false",
|
|
2647
|
-
"description": "
|
|
2688
|
+
"description": "Whether the checkbox must be checked before form submission.\n\nA required checkbox is invalid until it is checked. For requiring at least one option in a set, use `required` on `w-checkbox-group`.",
|
|
2648
2689
|
"fieldName": "required"
|
|
2649
2690
|
},
|
|
2650
2691
|
{
|
|
@@ -2653,7 +2694,7 @@
|
|
|
2653
2694
|
"text": "boolean"
|
|
2654
2695
|
},
|
|
2655
2696
|
"default": "false",
|
|
2656
|
-
"description": "
|
|
2697
|
+
"description": "Whether the checkbox is visually invalid.\n\nUse this to show an externally managed validation error. Required validation also sets the invalid state after the user interacts with the checkbox or tries to submit the form.",
|
|
2657
2698
|
"fieldName": "invalid"
|
|
2658
2699
|
}
|
|
2659
2700
|
],
|
|
@@ -2667,6 +2708,10 @@
|
|
|
2667
2708
|
"name": "LitElement",
|
|
2668
2709
|
"package": "lit"
|
|
2669
2710
|
},
|
|
2711
|
+
"parent": {
|
|
2712
|
+
"name": "w-checkbox-group",
|
|
2713
|
+
"description": ""
|
|
2714
|
+
},
|
|
2670
2715
|
"tagName": "w-checkbox",
|
|
2671
2716
|
"customElement": true,
|
|
2672
2717
|
"modulePath": "packages/checkbox/checkbox.ts",
|
|
@@ -2716,7 +2761,7 @@
|
|
|
2716
2761
|
"type": {
|
|
2717
2762
|
"text": "string"
|
|
2718
2763
|
},
|
|
2719
|
-
"description": "The group label displayed above the checkboxes.",
|
|
2764
|
+
"description": "The group label displayed above the checkboxes.\n\nUse this to describe the shared question or topic for the checkbox options. The label is connected to the internal group for assistive technologies.",
|
|
2720
2765
|
"attribute": "label",
|
|
2721
2766
|
"reflects": true
|
|
2722
2767
|
},
|
|
@@ -2726,7 +2771,7 @@
|
|
|
2726
2771
|
"type": {
|
|
2727
2772
|
"text": "string"
|
|
2728
2773
|
},
|
|
2729
|
-
"description": "The name applied to child checkboxes when they do not provide one.",
|
|
2774
|
+
"description": "The name applied to child checkboxes when they do not provide one.\n\nUse this when the grouped checkboxes should submit values under the same form field name. Individual checkboxes can still override the group name with their own `name`.",
|
|
2730
2775
|
"attribute": "name",
|
|
2731
2776
|
"reflects": true
|
|
2732
2777
|
},
|
|
@@ -2737,7 +2782,7 @@
|
|
|
2737
2782
|
"text": "boolean"
|
|
2738
2783
|
},
|
|
2739
2784
|
"default": "false",
|
|
2740
|
-
"description": "Whether to show optional text next to the label.",
|
|
2785
|
+
"description": "Whether to show optional text next to the label.\n\nUse this to indicate that selecting an option from the group is not required.",
|
|
2741
2786
|
"attribute": "optional",
|
|
2742
2787
|
"reflects": true
|
|
2743
2788
|
},
|
|
@@ -2747,6 +2792,7 @@
|
|
|
2747
2792
|
"type": {
|
|
2748
2793
|
"text": "string"
|
|
2749
2794
|
},
|
|
2795
|
+
"description": "Help text displayed below the checkbox group.\n\nUse this for supporting guidance or validation feedback. When required validation fails, the group replaces this text with the localized required message.",
|
|
2750
2796
|
"attribute": "help-text",
|
|
2751
2797
|
"reflects": true
|
|
2752
2798
|
},
|
|
@@ -2757,7 +2803,7 @@
|
|
|
2757
2803
|
"text": "boolean"
|
|
2758
2804
|
},
|
|
2759
2805
|
"default": "false",
|
|
2760
|
-
"description": "
|
|
2806
|
+
"description": "Whether at least one checkbox in the group must be selected.\n\nRequired validation is managed by the group. The individual checkboxes provide the submitted form values.",
|
|
2761
2807
|
"attribute": "required",
|
|
2762
2808
|
"reflects": true
|
|
2763
2809
|
},
|
|
@@ -2768,7 +2814,7 @@
|
|
|
2768
2814
|
"text": "boolean"
|
|
2769
2815
|
},
|
|
2770
2816
|
"default": "false",
|
|
2771
|
-
"description": "
|
|
2817
|
+
"description": "Whether the checkbox group is visually invalid.\n\nUse this to show an externally managed validation error for the group. The invalid state is also shared with child checkboxes for consistent styling and accessibility state.",
|
|
2772
2818
|
"attribute": "invalid",
|
|
2773
2819
|
"reflects": true
|
|
2774
2820
|
},
|
|
@@ -3029,7 +3075,7 @@
|
|
|
3029
3075
|
"type": {
|
|
3030
3076
|
"text": "string"
|
|
3031
3077
|
},
|
|
3032
|
-
"description": "The group label displayed above the checkboxes.",
|
|
3078
|
+
"description": "The group label displayed above the checkboxes.\n\nUse this to describe the shared question or topic for the checkbox options. The label is connected to the internal group for assistive technologies.",
|
|
3033
3079
|
"fieldName": "label"
|
|
3034
3080
|
},
|
|
3035
3081
|
{
|
|
@@ -3037,7 +3083,7 @@
|
|
|
3037
3083
|
"type": {
|
|
3038
3084
|
"text": "string"
|
|
3039
3085
|
},
|
|
3040
|
-
"description": "The name applied to child checkboxes when they do not provide one.",
|
|
3086
|
+
"description": "The name applied to child checkboxes when they do not provide one.\n\nUse this when the grouped checkboxes should submit values under the same form field name. Individual checkboxes can still override the group name with their own `name`.",
|
|
3041
3087
|
"fieldName": "name"
|
|
3042
3088
|
},
|
|
3043
3089
|
{
|
|
@@ -3046,7 +3092,7 @@
|
|
|
3046
3092
|
"text": "boolean"
|
|
3047
3093
|
},
|
|
3048
3094
|
"default": "false",
|
|
3049
|
-
"description": "Whether to show optional text next to the label.",
|
|
3095
|
+
"description": "Whether to show optional text next to the label.\n\nUse this to indicate that selecting an option from the group is not required.",
|
|
3050
3096
|
"fieldName": "optional"
|
|
3051
3097
|
},
|
|
3052
3098
|
{
|
|
@@ -3054,6 +3100,7 @@
|
|
|
3054
3100
|
"type": {
|
|
3055
3101
|
"text": "string"
|
|
3056
3102
|
},
|
|
3103
|
+
"description": "Help text displayed below the checkbox group.\n\nUse this for supporting guidance or validation feedback. When required validation fails, the group replaces this text with the localized required message.",
|
|
3057
3104
|
"fieldName": "helpText"
|
|
3058
3105
|
},
|
|
3059
3106
|
{
|
|
@@ -3062,7 +3109,7 @@
|
|
|
3062
3109
|
"text": "boolean"
|
|
3063
3110
|
},
|
|
3064
3111
|
"default": "false",
|
|
3065
|
-
"description": "
|
|
3112
|
+
"description": "Whether at least one checkbox in the group must be selected.\n\nRequired validation is managed by the group. The individual checkboxes provide the submitted form values.",
|
|
3066
3113
|
"fieldName": "required"
|
|
3067
3114
|
},
|
|
3068
3115
|
{
|
|
@@ -3071,7 +3118,7 @@
|
|
|
3071
3118
|
"text": "boolean"
|
|
3072
3119
|
},
|
|
3073
3120
|
"default": "false",
|
|
3074
|
-
"description": "
|
|
3121
|
+
"description": "Whether the checkbox group is visually invalid.\n\nUse this to show an externally managed validation error for the group. The invalid state is also shared with child checkboxes for consistent styling and accessibility state.",
|
|
3075
3122
|
"fieldName": "invalid"
|
|
3076
3123
|
}
|
|
3077
3124
|
],
|
|
@@ -3126,7 +3173,7 @@
|
|
|
3126
3173
|
"text": "ComboboxOption[]"
|
|
3127
3174
|
},
|
|
3128
3175
|
"default": "[]",
|
|
3129
|
-
"description": "The available options to select from",
|
|
3176
|
+
"description": "The available options to select from.\n\nUse this for framework usage, application state, or remote search results. When `options` contains entries, it is used instead of child `<option>` elements.",
|
|
3130
3177
|
"attribute": "options"
|
|
3131
3178
|
},
|
|
3132
3179
|
{
|
|
@@ -3136,7 +3183,7 @@
|
|
|
3136
3183
|
"text": "string | undefined"
|
|
3137
3184
|
},
|
|
3138
3185
|
"default": "''",
|
|
3139
|
-
"description": "
|
|
3186
|
+
"description": "The label displayed above the input.\n\nUse this to give the combobox a visible and accessible name.",
|
|
3140
3187
|
"attribute": "label",
|
|
3141
3188
|
"reflects": true
|
|
3142
3189
|
},
|
|
@@ -3147,7 +3194,7 @@
|
|
|
3147
3194
|
"text": "string | undefined"
|
|
3148
3195
|
},
|
|
3149
3196
|
"default": "''",
|
|
3150
|
-
"description": "
|
|
3197
|
+
"description": "Placeholder text displayed when the input is empty.\n\nUse this as a short hint for the expected input. Do not use placeholder text as a replacement for a label.",
|
|
3151
3198
|
"attribute": "placeholder",
|
|
3152
3199
|
"reflects": true
|
|
3153
3200
|
},
|
|
@@ -3158,7 +3205,7 @@
|
|
|
3158
3205
|
"text": "string"
|
|
3159
3206
|
},
|
|
3160
3207
|
"default": "''",
|
|
3161
|
-
"description": "The
|
|
3208
|
+
"description": "The selected or typed value.\n\nWhen an option is selected, this is set to the option value. The displayed text may differ when the option has a separate label.",
|
|
3162
3209
|
"attribute": "value",
|
|
3163
3210
|
"reflects": true
|
|
3164
3211
|
},
|
|
@@ -3169,7 +3216,7 @@
|
|
|
3169
3216
|
"text": "boolean"
|
|
3170
3217
|
},
|
|
3171
3218
|
"default": "false",
|
|
3172
|
-
"description": "Whether the
|
|
3219
|
+
"description": "Whether the option list opens when the input receives focus.\n\nUse this when users should see available options before they start typing.",
|
|
3173
3220
|
"attribute": "open-on-focus",
|
|
3174
3221
|
"reflects": true
|
|
3175
3222
|
},
|
|
@@ -3180,7 +3227,7 @@
|
|
|
3180
3227
|
"text": "boolean"
|
|
3181
3228
|
},
|
|
3182
3229
|
"default": "true",
|
|
3183
|
-
"description": "
|
|
3230
|
+
"description": "Whether the active option is selected when the input loses focus.\n\nWhen enabled, the combobox selects the keyboard-highlighted option, or an option whose value exactly matches the current input value, on blur.",
|
|
3184
3231
|
"attribute": "select-on-blur",
|
|
3185
3232
|
"reflects": true
|
|
3186
3233
|
},
|
|
@@ -3191,7 +3238,7 @@
|
|
|
3191
3238
|
"text": "boolean"
|
|
3192
3239
|
},
|
|
3193
3240
|
"default": "false",
|
|
3194
|
-
"description": "Whether
|
|
3241
|
+
"description": "Whether matching text segments in options are highlighted.\n\nUse this to visually emphasize the part of each option that matches the current input value.",
|
|
3195
3242
|
"attribute": "match-text-segments",
|
|
3196
3243
|
"reflects": true
|
|
3197
3244
|
},
|
|
@@ -3202,7 +3249,7 @@
|
|
|
3202
3249
|
"text": "boolean"
|
|
3203
3250
|
},
|
|
3204
3251
|
"default": "false",
|
|
3205
|
-
"description": "
|
|
3252
|
+
"description": "Whether built-in client-side filtering is disabled.\n\nUse this for remote search or externally filtered results. When disabled, all entries in `options` are rendered as provided.",
|
|
3206
3253
|
"attribute": "disable-static-filtering",
|
|
3207
3254
|
"reflects": true
|
|
3208
3255
|
},
|
|
@@ -3213,7 +3260,7 @@
|
|
|
3213
3260
|
"text": "boolean"
|
|
3214
3261
|
},
|
|
3215
3262
|
"default": "false",
|
|
3216
|
-
"description": "
|
|
3263
|
+
"description": "Whether the combobox is visually invalid.\n\nUse this to show an externally managed validation error. Pair it with `help-text` to explain how to fix the error.",
|
|
3217
3264
|
"attribute": "invalid",
|
|
3218
3265
|
"reflects": true
|
|
3219
3266
|
},
|
|
@@ -3224,7 +3271,7 @@
|
|
|
3224
3271
|
"text": "string | undefined"
|
|
3225
3272
|
},
|
|
3226
3273
|
"default": "''",
|
|
3227
|
-
"description": "
|
|
3274
|
+
"description": "Help text displayed below the input.\n\nUse this for supporting guidance or validation feedback.",
|
|
3228
3275
|
"attribute": "help-text",
|
|
3229
3276
|
"reflects": true
|
|
3230
3277
|
},
|
|
@@ -3235,7 +3282,7 @@
|
|
|
3235
3282
|
"text": "boolean"
|
|
3236
3283
|
},
|
|
3237
3284
|
"default": "false",
|
|
3238
|
-
"description": "Whether the
|
|
3285
|
+
"description": "Whether the combobox is disabled.\n\nDisabled comboboxes cannot be focused, changed, or submitted with form data.",
|
|
3239
3286
|
"attribute": "disabled",
|
|
3240
3287
|
"reflects": true
|
|
3241
3288
|
},
|
|
@@ -3246,7 +3293,7 @@
|
|
|
3246
3293
|
"text": "boolean"
|
|
3247
3294
|
},
|
|
3248
3295
|
"default": "false",
|
|
3249
|
-
"description": "Whether the
|
|
3296
|
+
"description": "Whether the combobox is required before form submission.\n\nUse this when the user must provide a value before submitting the form.",
|
|
3250
3297
|
"attribute": "required",
|
|
3251
3298
|
"reflects": true
|
|
3252
3299
|
},
|
|
@@ -3257,7 +3304,7 @@
|
|
|
3257
3304
|
"text": "boolean"
|
|
3258
3305
|
},
|
|
3259
3306
|
"default": "false",
|
|
3260
|
-
"description": "Whether to show optional text",
|
|
3307
|
+
"description": "Whether to show optional text next to the label.\n\nUse this to indicate that the combobox is not required.",
|
|
3261
3308
|
"attribute": "optional",
|
|
3262
3309
|
"reflects": true
|
|
3263
3310
|
},
|
|
@@ -3268,7 +3315,7 @@
|
|
|
3268
3315
|
"text": "string | undefined"
|
|
3269
3316
|
},
|
|
3270
3317
|
"default": "''",
|
|
3271
|
-
"description": "
|
|
3318
|
+
"description": "The name submitted with the combobox value.\n\nUse this when the combobox belongs to a form and its value should be included in form data.",
|
|
3272
3319
|
"attribute": "name",
|
|
3273
3320
|
"reflects": true
|
|
3274
3321
|
},
|
|
@@ -3279,7 +3326,7 @@
|
|
|
3279
3326
|
"text": "string | undefined"
|
|
3280
3327
|
},
|
|
3281
3328
|
"default": "'off'",
|
|
3282
|
-
"description": "
|
|
3329
|
+
"description": "The autocomplete attribute passed to the internal input.\n\nDefaults to `off`. Set this when browser autocomplete should be enabled or scoped to a specific autocomplete token.",
|
|
3283
3330
|
"attribute": "autocomplete",
|
|
3284
3331
|
"reflects": true
|
|
3285
3332
|
},
|
|
@@ -3292,6 +3339,14 @@
|
|
|
3292
3339
|
},
|
|
3293
3340
|
"default": "null"
|
|
3294
3341
|
},
|
|
3342
|
+
{
|
|
3343
|
+
"kind": "field",
|
|
3344
|
+
"name": "#lightDomObserver",
|
|
3345
|
+
"privacy": "private",
|
|
3346
|
+
"type": {
|
|
3347
|
+
"text": "MutationObserver | undefined"
|
|
3348
|
+
}
|
|
3349
|
+
},
|
|
3295
3350
|
{
|
|
3296
3351
|
"kind": "method",
|
|
3297
3352
|
"name": "resetFormControl",
|
|
@@ -3322,6 +3377,12 @@
|
|
|
3322
3377
|
"privacy": "private",
|
|
3323
3378
|
"readonly": true
|
|
3324
3379
|
},
|
|
3380
|
+
{
|
|
3381
|
+
"kind": "field",
|
|
3382
|
+
"name": "_sourceOptions",
|
|
3383
|
+
"privacy": "private",
|
|
3384
|
+
"readonly": true
|
|
3385
|
+
},
|
|
3325
3386
|
{
|
|
3326
3387
|
"kind": "field",
|
|
3327
3388
|
"name": "_navigationLabelOrDisplayValue",
|
|
@@ -3361,6 +3422,16 @@
|
|
|
3361
3422
|
],
|
|
3362
3423
|
"description": "Generate options with unique IDs and match information"
|
|
3363
3424
|
},
|
|
3425
|
+
{
|
|
3426
|
+
"kind": "method",
|
|
3427
|
+
"name": "#getOptionNodes",
|
|
3428
|
+
"privacy": "private"
|
|
3429
|
+
},
|
|
3430
|
+
{
|
|
3431
|
+
"kind": "method",
|
|
3432
|
+
"name": "#syncOptionsFromLightDom",
|
|
3433
|
+
"privacy": "private"
|
|
3434
|
+
},
|
|
3364
3435
|
{
|
|
3365
3436
|
"kind": "method",
|
|
3366
3437
|
"name": "_getAriaText",
|
|
@@ -3539,7 +3610,7 @@
|
|
|
3539
3610
|
"text": "ComboboxOption[]"
|
|
3540
3611
|
},
|
|
3541
3612
|
"default": "[]",
|
|
3542
|
-
"description": "The available options to select from",
|
|
3613
|
+
"description": "The available options to select from.\n\nUse this for framework usage, application state, or remote search results. When `options` contains entries, it is used instead of child `<option>` elements.",
|
|
3543
3614
|
"fieldName": "options"
|
|
3544
3615
|
},
|
|
3545
3616
|
{
|
|
@@ -3548,7 +3619,7 @@
|
|
|
3548
3619
|
"text": "string | undefined"
|
|
3549
3620
|
},
|
|
3550
3621
|
"default": "''",
|
|
3551
|
-
"description": "
|
|
3622
|
+
"description": "The label displayed above the input.\n\nUse this to give the combobox a visible and accessible name.",
|
|
3552
3623
|
"fieldName": "label"
|
|
3553
3624
|
},
|
|
3554
3625
|
{
|
|
@@ -3557,7 +3628,7 @@
|
|
|
3557
3628
|
"text": "string | undefined"
|
|
3558
3629
|
},
|
|
3559
3630
|
"default": "''",
|
|
3560
|
-
"description": "
|
|
3631
|
+
"description": "Placeholder text displayed when the input is empty.\n\nUse this as a short hint for the expected input. Do not use placeholder text as a replacement for a label.",
|
|
3561
3632
|
"fieldName": "placeholder"
|
|
3562
3633
|
},
|
|
3563
3634
|
{
|
|
@@ -3566,7 +3637,7 @@
|
|
|
3566
3637
|
"text": "string"
|
|
3567
3638
|
},
|
|
3568
3639
|
"default": "''",
|
|
3569
|
-
"description": "The
|
|
3640
|
+
"description": "The selected or typed value.\n\nWhen an option is selected, this is set to the option value. The displayed text may differ when the option has a separate label.",
|
|
3570
3641
|
"fieldName": "value"
|
|
3571
3642
|
},
|
|
3572
3643
|
{
|
|
@@ -3575,7 +3646,7 @@
|
|
|
3575
3646
|
"text": "boolean"
|
|
3576
3647
|
},
|
|
3577
3648
|
"default": "false",
|
|
3578
|
-
"description": "Whether the
|
|
3649
|
+
"description": "Whether the option list opens when the input receives focus.\n\nUse this when users should see available options before they start typing.",
|
|
3579
3650
|
"fieldName": "openOnFocus"
|
|
3580
3651
|
},
|
|
3581
3652
|
{
|
|
@@ -3584,7 +3655,7 @@
|
|
|
3584
3655
|
"text": "boolean"
|
|
3585
3656
|
},
|
|
3586
3657
|
"default": "true",
|
|
3587
|
-
"description": "
|
|
3658
|
+
"description": "Whether the active option is selected when the input loses focus.\n\nWhen enabled, the combobox selects the keyboard-highlighted option, or an option whose value exactly matches the current input value, on blur.",
|
|
3588
3659
|
"fieldName": "selectOnBlur"
|
|
3589
3660
|
},
|
|
3590
3661
|
{
|
|
@@ -3593,7 +3664,7 @@
|
|
|
3593
3664
|
"text": "boolean"
|
|
3594
3665
|
},
|
|
3595
3666
|
"default": "false",
|
|
3596
|
-
"description": "Whether
|
|
3667
|
+
"description": "Whether matching text segments in options are highlighted.\n\nUse this to visually emphasize the part of each option that matches the current input value.",
|
|
3597
3668
|
"fieldName": "matchTextSegments"
|
|
3598
3669
|
},
|
|
3599
3670
|
{
|
|
@@ -3602,7 +3673,7 @@
|
|
|
3602
3673
|
"text": "boolean"
|
|
3603
3674
|
},
|
|
3604
3675
|
"default": "false",
|
|
3605
|
-
"description": "
|
|
3676
|
+
"description": "Whether built-in client-side filtering is disabled.\n\nUse this for remote search or externally filtered results. When disabled, all entries in `options` are rendered as provided.",
|
|
3606
3677
|
"fieldName": "disableStaticFiltering"
|
|
3607
3678
|
},
|
|
3608
3679
|
{
|
|
@@ -3611,7 +3682,7 @@
|
|
|
3611
3682
|
"text": "boolean"
|
|
3612
3683
|
},
|
|
3613
3684
|
"default": "false",
|
|
3614
|
-
"description": "
|
|
3685
|
+
"description": "Whether the combobox is visually invalid.\n\nUse this to show an externally managed validation error. Pair it with `help-text` to explain how to fix the error.",
|
|
3615
3686
|
"fieldName": "invalid"
|
|
3616
3687
|
},
|
|
3617
3688
|
{
|
|
@@ -3620,7 +3691,7 @@
|
|
|
3620
3691
|
"text": "string | undefined"
|
|
3621
3692
|
},
|
|
3622
3693
|
"default": "''",
|
|
3623
|
-
"description": "
|
|
3694
|
+
"description": "Help text displayed below the input.\n\nUse this for supporting guidance or validation feedback.",
|
|
3624
3695
|
"fieldName": "helpText"
|
|
3625
3696
|
},
|
|
3626
3697
|
{
|
|
@@ -3629,7 +3700,7 @@
|
|
|
3629
3700
|
"text": "boolean"
|
|
3630
3701
|
},
|
|
3631
3702
|
"default": "false",
|
|
3632
|
-
"description": "Whether the
|
|
3703
|
+
"description": "Whether the combobox is disabled.\n\nDisabled comboboxes cannot be focused, changed, or submitted with form data.",
|
|
3633
3704
|
"fieldName": "disabled"
|
|
3634
3705
|
},
|
|
3635
3706
|
{
|
|
@@ -3638,7 +3709,7 @@
|
|
|
3638
3709
|
"text": "boolean"
|
|
3639
3710
|
},
|
|
3640
3711
|
"default": "false",
|
|
3641
|
-
"description": "Whether the
|
|
3712
|
+
"description": "Whether the combobox is required before form submission.\n\nUse this when the user must provide a value before submitting the form.",
|
|
3642
3713
|
"fieldName": "required"
|
|
3643
3714
|
},
|
|
3644
3715
|
{
|
|
@@ -3647,7 +3718,7 @@
|
|
|
3647
3718
|
"text": "boolean"
|
|
3648
3719
|
},
|
|
3649
3720
|
"default": "false",
|
|
3650
|
-
"description": "Whether to show optional text",
|
|
3721
|
+
"description": "Whether to show optional text next to the label.\n\nUse this to indicate that the combobox is not required.",
|
|
3651
3722
|
"fieldName": "optional"
|
|
3652
3723
|
},
|
|
3653
3724
|
{
|
|
@@ -3656,7 +3727,7 @@
|
|
|
3656
3727
|
"text": "string | undefined"
|
|
3657
3728
|
},
|
|
3658
3729
|
"default": "''",
|
|
3659
|
-
"description": "
|
|
3730
|
+
"description": "The name submitted with the combobox value.\n\nUse this when the combobox belongs to a form and its value should be included in form data.",
|
|
3660
3731
|
"fieldName": "name"
|
|
3661
3732
|
},
|
|
3662
3733
|
{
|
|
@@ -3665,7 +3736,7 @@
|
|
|
3665
3736
|
"text": "string | undefined"
|
|
3666
3737
|
},
|
|
3667
3738
|
"default": "'off'",
|
|
3668
|
-
"description": "
|
|
3739
|
+
"description": "The autocomplete attribute passed to the internal input.\n\nDefaults to `off`. Set this when browser autocomplete should be enabled or scoped to a specific autocomplete token.",
|
|
3669
3740
|
"fieldName": "autocomplete"
|
|
3670
3741
|
}
|
|
3671
3742
|
],
|
|
@@ -4426,6 +4497,15 @@
|
|
|
4426
4497
|
},
|
|
4427
4498
|
"privacy": "private"
|
|
4428
4499
|
},
|
|
4500
|
+
{
|
|
4501
|
+
"kind": "field",
|
|
4502
|
+
"name": "_isClosing",
|
|
4503
|
+
"type": {
|
|
4504
|
+
"text": "boolean"
|
|
4505
|
+
},
|
|
4506
|
+
"privacy": "private",
|
|
4507
|
+
"default": "false"
|
|
4508
|
+
},
|
|
4429
4509
|
{
|
|
4430
4510
|
"kind": "method",
|
|
4431
4511
|
"name": "open",
|