@momentum-design/components 0.23.0 → 0.23.2
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/browser/index.js +60 -46
- package/dist/browser/index.js.map +3 -3
- package/dist/components/formfieldwrapper/formfieldwrapper.component.d.ts +7 -0
- package/dist/components/formfieldwrapper/formfieldwrapper.component.js +19 -0
- package/dist/components/formfieldwrapper/formfieldwrapper.styles.js +4 -0
- package/dist/components/input/input.component.d.ts +0 -5
- package/dist/components/input/input.component.js +1 -10
- package/dist/components/input/input.styles.js +1 -0
- package/dist/custom-elements.json +1199 -1055
- package/dist/react/index.d.ts +3 -3
- package/dist/react/index.js +3 -3
- package/package.json +1 -1
@@ -2,6 +2,250 @@
|
|
2
2
|
"schemaVersion": "1.0.0",
|
3
3
|
"readme": "",
|
4
4
|
"modules": [
|
5
|
+
{
|
6
|
+
"kind": "javascript-module",
|
7
|
+
"path": "components/avatar/avatar.component.js",
|
8
|
+
"declarations": [
|
9
|
+
{
|
10
|
+
"kind": "class",
|
11
|
+
"description": "The `mdc-avatar` component is used to represent a person or a space.\nAn avatar can be an icon, initials, counter and photo.\n\nTo set the photo of an avatar,\nyou need to set \"src\" attribute.\n\nWhile the avatar image is loading, as a placeholder,\nwe will show the initials text.\nIf the initials are not specified then,\nwe will show `user-regular` icon as a placeholder.\n\nBy default, if there are no attributes specified,\nthen the default avatar will be an icon with `user-regular` name.\n\nThe avatar component is non clickable and non interactive/focusable component.\nIf the avatar is typing, then the loading indicator will be displayed.\nIf the counter type avatar is set to a negative number, then we will display 0.\nThe presence indicator will be hidden when the counter property is set.",
|
12
|
+
"name": "Avatar",
|
13
|
+
"cssProperties": [
|
14
|
+
{
|
15
|
+
"description": "Allows customization of the default background color.",
|
16
|
+
"name": "--mdc-avatar-default-background-color"
|
17
|
+
},
|
18
|
+
{
|
19
|
+
"description": "Allows customization of the default foreground color.",
|
20
|
+
"name": "--mdc-avatar-default-foreground-color"
|
21
|
+
},
|
22
|
+
{
|
23
|
+
"description": "Allows customization of the loading indicator background color.",
|
24
|
+
"name": "--mdc-avatar-loading-indicator-background-color"
|
25
|
+
},
|
26
|
+
{
|
27
|
+
"description": "Allows customization of the loading indicator foreground color.",
|
28
|
+
"name": "--mdc-avatar-loading-indicator-foreground-color"
|
29
|
+
},
|
30
|
+
{
|
31
|
+
"description": "Allows customization of the loading overlay background color.",
|
32
|
+
"name": "--mdc-avatar-loading-overlay-background-color"
|
33
|
+
}
|
34
|
+
],
|
35
|
+
"members": [
|
36
|
+
{
|
37
|
+
"kind": "field",
|
38
|
+
"name": "src",
|
39
|
+
"type": {
|
40
|
+
"text": "string | undefined"
|
41
|
+
},
|
42
|
+
"description": "The src is the url which will be used to display the avatar.\nWhen the src is loading, we will display the initials as a placeholder.",
|
43
|
+
"attribute": "src",
|
44
|
+
"inheritedFrom": {
|
45
|
+
"name": "AvatarComponentMixin",
|
46
|
+
"module": "utils/mixins/AvatarComponentMixin.js"
|
47
|
+
}
|
48
|
+
},
|
49
|
+
{
|
50
|
+
"kind": "field",
|
51
|
+
"name": "initials",
|
52
|
+
"type": {
|
53
|
+
"text": "string | undefined"
|
54
|
+
},
|
55
|
+
"description": "The initials to be displayed for the avatar.",
|
56
|
+
"attribute": "initials",
|
57
|
+
"inheritedFrom": {
|
58
|
+
"name": "AvatarComponentMixin",
|
59
|
+
"module": "utils/mixins/AvatarComponentMixin.js"
|
60
|
+
}
|
61
|
+
},
|
62
|
+
{
|
63
|
+
"kind": "field",
|
64
|
+
"name": "presence",
|
65
|
+
"type": {
|
66
|
+
"text": "PresenceType | undefined"
|
67
|
+
},
|
68
|
+
"description": "The presence is the status which can be used to display the\nactivity state of a user or a space within an avatar component.\n\nAcceptable values include:\n- `active`\n- `away`\n- `away-calling`\n- `busy`\n- `dnd`\n- `meeting`\n- `on-call`\n- `on-device`\n- `on-mobile`\n- `pause`\n- `pto`\n- `presenting`\n- `quiet`\n- `scheduled`",
|
69
|
+
"attribute": "presence",
|
70
|
+
"inheritedFrom": {
|
71
|
+
"name": "AvatarComponentMixin",
|
72
|
+
"module": "utils/mixins/AvatarComponentMixin.js"
|
73
|
+
}
|
74
|
+
},
|
75
|
+
{
|
76
|
+
"kind": "field",
|
77
|
+
"name": "size",
|
78
|
+
"type": {
|
79
|
+
"text": "AvatarSize"
|
80
|
+
},
|
81
|
+
"description": "Acceptable values include (size in px unit):\n- 24\n- 32\n- 48\n- 64\n- 72\n- 88\n- 124",
|
82
|
+
"default": "32",
|
83
|
+
"attribute": "size",
|
84
|
+
"reflects": true,
|
85
|
+
"inheritedFrom": {
|
86
|
+
"name": "AvatarComponentMixin",
|
87
|
+
"module": "utils/mixins/AvatarComponentMixin.js"
|
88
|
+
}
|
89
|
+
},
|
90
|
+
{
|
91
|
+
"kind": "field",
|
92
|
+
"name": "counter",
|
93
|
+
"type": {
|
94
|
+
"text": "number | undefined"
|
95
|
+
},
|
96
|
+
"description": "The counter is the number which can be displayed on the avatar.\nThe maximum number is 99 and if the given number is greater than 99,\nthen the avatar will be displayed as `99+`.\nIf the given number is a negative number,\nthen the avatar will be displayed as `0`.",
|
97
|
+
"attribute": "counter",
|
98
|
+
"inheritedFrom": {
|
99
|
+
"name": "AvatarComponentMixin",
|
100
|
+
"module": "utils/mixins/AvatarComponentMixin.js"
|
101
|
+
}
|
102
|
+
},
|
103
|
+
{
|
104
|
+
"kind": "field",
|
105
|
+
"name": "isTyping",
|
106
|
+
"type": {
|
107
|
+
"text": "boolean"
|
108
|
+
},
|
109
|
+
"default": "false",
|
110
|
+
"description": "Represents the typing indicator when the user is typing.",
|
111
|
+
"attribute": "is-typing",
|
112
|
+
"inheritedFrom": {
|
113
|
+
"name": "AvatarComponentMixin",
|
114
|
+
"module": "utils/mixins/AvatarComponentMixin.js"
|
115
|
+
}
|
116
|
+
},
|
117
|
+
{
|
118
|
+
"kind": "field",
|
119
|
+
"name": "iconName",
|
120
|
+
"type": {
|
121
|
+
"text": "IconNames | undefined"
|
122
|
+
},
|
123
|
+
"description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
|
124
|
+
"attribute": "icon-name",
|
125
|
+
"inheritedFrom": {
|
126
|
+
"name": "IconNameMixin",
|
127
|
+
"module": "utils/mixins/IconNameMixin.js"
|
128
|
+
}
|
129
|
+
}
|
130
|
+
],
|
131
|
+
"mixins": [
|
132
|
+
{
|
133
|
+
"name": "AvatarComponentMixin",
|
134
|
+
"module": "/src/utils/mixins/AvatarComponentMixin"
|
135
|
+
},
|
136
|
+
{
|
137
|
+
"name": "IconNameMixin",
|
138
|
+
"module": "/src/utils/mixins/IconNameMixin"
|
139
|
+
}
|
140
|
+
],
|
141
|
+
"superclass": {
|
142
|
+
"name": "Component",
|
143
|
+
"module": "/src/models"
|
144
|
+
},
|
145
|
+
"tagName": "mdc-avatar",
|
146
|
+
"jsDoc": "/**\n * The `mdc-avatar` component is used to represent a person or a space.\n * An avatar can be an icon, initials, counter and photo.\n *\n * To set the photo of an avatar,\n * you need to set \"src\" attribute.\n *\n * While the avatar image is loading, as a placeholder,\n * we will show the initials text.\n * If the initials are not specified then,\n * we will show `user-regular` icon as a placeholder.\n *\n * By default, if there are no attributes specified,\n * then the default avatar will be an icon with `user-regular` name.\n *\n * The avatar component is non clickable and non interactive/focusable component.\n * If the avatar is typing, then the loading indicator will be displayed.\n * If the counter type avatar is set to a negative number, then we will display 0.\n * The presence indicator will be hidden when the counter property is set.\n *\n * @dependency mdc-icon\n * @dependency mdc-presence\n * @dependency mdc-text\n *\n * @tagname mdc-avatar\n *\n * @cssproperty --mdc-avatar-default-background-color - Allows customization of the default background color.\n * @cssproperty --mdc-avatar-default-foreground-color - Allows customization of the default foreground color.\n * @cssproperty --mdc-avatar-loading-indicator-background-color -\n * Allows customization of the loading indicator background color.\n * @cssproperty --mdc-avatar-loading-indicator-foreground-color -\n * Allows customization of the loading indicator foreground color.\n * @cssproperty --mdc-avatar-loading-overlay-background-color -\n * Allows customization of the loading overlay background color.\n */",
|
147
|
+
"customElement": true,
|
148
|
+
"attributes": [
|
149
|
+
{
|
150
|
+
"name": "src",
|
151
|
+
"type": {
|
152
|
+
"text": "string | undefined"
|
153
|
+
},
|
154
|
+
"description": "The src is the url which will be used to display the avatar.\nWhen the src is loading, we will display the initials as a placeholder.",
|
155
|
+
"fieldName": "src",
|
156
|
+
"inheritedFrom": {
|
157
|
+
"name": "AvatarComponentMixin",
|
158
|
+
"module": "src/utils/mixins/AvatarComponentMixin.ts"
|
159
|
+
}
|
160
|
+
},
|
161
|
+
{
|
162
|
+
"name": "initials",
|
163
|
+
"type": {
|
164
|
+
"text": "string | undefined"
|
165
|
+
},
|
166
|
+
"description": "The initials to be displayed for the avatar.",
|
167
|
+
"fieldName": "initials",
|
168
|
+
"inheritedFrom": {
|
169
|
+
"name": "AvatarComponentMixin",
|
170
|
+
"module": "src/utils/mixins/AvatarComponentMixin.ts"
|
171
|
+
}
|
172
|
+
},
|
173
|
+
{
|
174
|
+
"name": "presence",
|
175
|
+
"type": {
|
176
|
+
"text": "PresenceType | undefined"
|
177
|
+
},
|
178
|
+
"description": "The presence is the status which can be used to display the\nactivity state of a user or a space within an avatar component.\n\nAcceptable values include:\n- `active`\n- `away`\n- `away-calling`\n- `busy`\n- `dnd`\n- `meeting`\n- `on-call`\n- `on-device`\n- `on-mobile`\n- `pause`\n- `pto`\n- `presenting`\n- `quiet`\n- `scheduled`",
|
179
|
+
"fieldName": "presence",
|
180
|
+
"inheritedFrom": {
|
181
|
+
"name": "AvatarComponentMixin",
|
182
|
+
"module": "src/utils/mixins/AvatarComponentMixin.ts"
|
183
|
+
}
|
184
|
+
},
|
185
|
+
{
|
186
|
+
"name": "size",
|
187
|
+
"type": {
|
188
|
+
"text": "AvatarSize"
|
189
|
+
},
|
190
|
+
"description": "Acceptable values include (size in px unit):\n- 24\n- 32\n- 48\n- 64\n- 72\n- 88\n- 124",
|
191
|
+
"default": "32",
|
192
|
+
"fieldName": "size",
|
193
|
+
"inheritedFrom": {
|
194
|
+
"name": "AvatarComponentMixin",
|
195
|
+
"module": "src/utils/mixins/AvatarComponentMixin.ts"
|
196
|
+
}
|
197
|
+
},
|
198
|
+
{
|
199
|
+
"name": "counter",
|
200
|
+
"type": {
|
201
|
+
"text": "number | undefined"
|
202
|
+
},
|
203
|
+
"description": "The counter is the number which can be displayed on the avatar.\nThe maximum number is 99 and if the given number is greater than 99,\nthen the avatar will be displayed as `99+`.\nIf the given number is a negative number,\nthen the avatar will be displayed as `0`.",
|
204
|
+
"fieldName": "counter",
|
205
|
+
"inheritedFrom": {
|
206
|
+
"name": "AvatarComponentMixin",
|
207
|
+
"module": "src/utils/mixins/AvatarComponentMixin.ts"
|
208
|
+
}
|
209
|
+
},
|
210
|
+
{
|
211
|
+
"name": "is-typing",
|
212
|
+
"type": {
|
213
|
+
"text": "boolean"
|
214
|
+
},
|
215
|
+
"default": "false",
|
216
|
+
"description": "Represents the typing indicator when the user is typing.",
|
217
|
+
"fieldName": "isTyping",
|
218
|
+
"inheritedFrom": {
|
219
|
+
"name": "AvatarComponentMixin",
|
220
|
+
"module": "src/utils/mixins/AvatarComponentMixin.ts"
|
221
|
+
}
|
222
|
+
},
|
223
|
+
{
|
224
|
+
"name": "icon-name",
|
225
|
+
"type": {
|
226
|
+
"text": "IconNames | undefined"
|
227
|
+
},
|
228
|
+
"description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
|
229
|
+
"fieldName": "iconName",
|
230
|
+
"inheritedFrom": {
|
231
|
+
"name": "IconNameMixin",
|
232
|
+
"module": "src/utils/mixins/IconNameMixin.ts"
|
233
|
+
}
|
234
|
+
}
|
235
|
+
]
|
236
|
+
}
|
237
|
+
],
|
238
|
+
"exports": [
|
239
|
+
{
|
240
|
+
"kind": "js",
|
241
|
+
"name": "default",
|
242
|
+
"declaration": {
|
243
|
+
"name": "Avatar",
|
244
|
+
"module": "components/avatar/avatar.component.js"
|
245
|
+
}
|
246
|
+
}
|
247
|
+
]
|
248
|
+
},
|
5
249
|
{
|
6
250
|
"kind": "javascript-module",
|
7
251
|
"path": "components/avatarbutton/avatarbutton.component.js",
|
@@ -556,115 +800,218 @@
|
|
556
800
|
},
|
557
801
|
{
|
558
802
|
"kind": "javascript-module",
|
559
|
-
"path": "components/
|
803
|
+
"path": "components/badge/badge.component.js",
|
560
804
|
"declarations": [
|
561
805
|
{
|
562
806
|
"kind": "class",
|
563
|
-
"description": "The `mdc-
|
564
|
-
"name": "
|
807
|
+
"description": "The `mdc-badge` component is a versatile UI element used to\ndisplay dot, icons, counters, success, warning and error type badge.\n\nSupported badge types:\n- `dot`: Displays a dot notification badge with a blue color.\n- `icon`: Displays a badge with a specified icon using the `icon-name` attribute.\n- `counter`: Displays a badge with a counter value. If the counter exceeds the `max-counter`,\nit shows `maxCounter+`. The maximum value of the counter is 999 and anything above that will be set to `999+`.\n- `success`: Displays a success badge with a check circle icon and green color.\n- `warning`: Displays a warning badge with a warning icon and yellow color.\n- `error`: Displays a error badge with a error legacy icon and red color.\n\nFor `icon`, `success`, `warning` and `error` types, the `mdc-icon` component is used to render the icon.\n\nFor the `counter` type, the `mdc-text` component is used to render the counter value.",
|
808
|
+
"name": "Badge",
|
565
809
|
"cssProperties": [
|
566
810
|
{
|
567
|
-
"description": "
|
568
|
-
"name": "--mdc-
|
811
|
+
"description": "The foreground color of the primary badge.",
|
812
|
+
"name": "--mdc-badge-primary-foreground-color"
|
569
813
|
},
|
570
814
|
{
|
571
|
-
"description": "
|
572
|
-
"name": "--mdc-
|
815
|
+
"description": "The background color of the primary badge.",
|
816
|
+
"name": "--mdc-badge-primary-background-color"
|
573
817
|
},
|
574
818
|
{
|
575
|
-
"description": "
|
576
|
-
"name": "--mdc-
|
819
|
+
"description": "The foreground color of the secondary badge.",
|
820
|
+
"name": "--mdc-badge-secondary-foreground-color"
|
577
821
|
},
|
578
822
|
{
|
579
|
-
"description": "
|
580
|
-
"name": "--mdc-
|
823
|
+
"description": "The background color of the secondary badge.",
|
824
|
+
"name": "--mdc-badge-secondary-background-color"
|
581
825
|
},
|
582
826
|
{
|
583
|
-
"description": "
|
584
|
-
"name": "--mdc-
|
827
|
+
"description": "The foreground color of the success badge.",
|
828
|
+
"name": "--mdc-badge-success-foreground-color"
|
829
|
+
},
|
830
|
+
{
|
831
|
+
"description": "The background color of the success badge.",
|
832
|
+
"name": "--mdc-badge-success-background-color"
|
833
|
+
},
|
834
|
+
{
|
835
|
+
"description": "The foreground color of the warning badge.",
|
836
|
+
"name": "--mdc-badge-warning-foreground-color"
|
837
|
+
},
|
838
|
+
{
|
839
|
+
"description": "The background color of the warning badge.",
|
840
|
+
"name": "--mdc-badge-warning-background-color"
|
841
|
+
},
|
842
|
+
{
|
843
|
+
"description": "The foreground color of the error badge.",
|
844
|
+
"name": "--mdc-badge-error-foreground-color"
|
845
|
+
},
|
846
|
+
{
|
847
|
+
"description": "The background color of the error badge.",
|
848
|
+
"name": "--mdc-badge-error-background-color"
|
849
|
+
},
|
850
|
+
{
|
851
|
+
"description": "The background color of the badge overlay.",
|
852
|
+
"name": "--mdc-badge-overlay-background-color"
|
585
853
|
}
|
586
854
|
],
|
587
855
|
"members": [
|
588
856
|
{
|
589
857
|
"kind": "field",
|
590
|
-
"name": "
|
858
|
+
"name": "type",
|
591
859
|
"type": {
|
592
|
-
"text": "
|
860
|
+
"text": "BadgeType | undefined"
|
593
861
|
},
|
594
|
-
"description": "
|
595
|
-
"attribute": "
|
596
|
-
"
|
597
|
-
"name": "AvatarComponentMixin",
|
598
|
-
"module": "utils/mixins/AvatarComponentMixin.js"
|
599
|
-
}
|
862
|
+
"description": "Type of the badge\nCan be `dot` (notification) , `icon`, `counter`, `success`, `warning` or `error`.",
|
863
|
+
"attribute": "type",
|
864
|
+
"reflects": true
|
600
865
|
},
|
601
866
|
{
|
602
867
|
"kind": "field",
|
603
|
-
"name": "
|
868
|
+
"name": "variant",
|
604
869
|
"type": {
|
605
|
-
"text": "
|
870
|
+
"text": "IconVariant"
|
606
871
|
},
|
607
|
-
"description": "
|
608
|
-
"
|
609
|
-
"
|
610
|
-
|
611
|
-
"module": "utils/mixins/AvatarComponentMixin.js"
|
612
|
-
}
|
872
|
+
"description": "Type of the variant can be `primary` or `secondary`.\nIt defines the background and foreground color of the icon.",
|
873
|
+
"default": "primary",
|
874
|
+
"attribute": "variant",
|
875
|
+
"reflects": true
|
613
876
|
},
|
614
877
|
{
|
615
878
|
"kind": "field",
|
616
|
-
"name": "
|
879
|
+
"name": "counter",
|
617
880
|
"type": {
|
618
|
-
"text": "
|
881
|
+
"text": "number | undefined"
|
619
882
|
},
|
620
|
-
"description": "
|
621
|
-
"attribute": "
|
622
|
-
"inheritedFrom": {
|
623
|
-
"name": "AvatarComponentMixin",
|
624
|
-
"module": "utils/mixins/AvatarComponentMixin.js"
|
625
|
-
}
|
883
|
+
"description": "Counter is the number which can be provided in the badge.",
|
884
|
+
"attribute": "counter"
|
626
885
|
},
|
627
886
|
{
|
628
887
|
"kind": "field",
|
629
|
-
"name": "
|
888
|
+
"name": "maxCounter",
|
630
889
|
"type": {
|
631
|
-
"text": "
|
890
|
+
"text": "number"
|
632
891
|
},
|
633
|
-
"description": "
|
634
|
-
"default": "
|
635
|
-
"attribute": "
|
636
|
-
"reflects": true
|
637
|
-
"inheritedFrom": {
|
638
|
-
"name": "AvatarComponentMixin",
|
639
|
-
"module": "utils/mixins/AvatarComponentMixin.js"
|
640
|
-
}
|
892
|
+
"description": "The maximum number can be set up to 999, anything above that will be rendered as _999+_.\nThe max counter can be `9`, `99` or `999`.",
|
893
|
+
"default": "99",
|
894
|
+
"attribute": "max-counter",
|
895
|
+
"reflects": true
|
641
896
|
},
|
642
897
|
{
|
643
898
|
"kind": "field",
|
644
|
-
"name": "
|
899
|
+
"name": "overlay",
|
645
900
|
"type": {
|
646
|
-
"text": "
|
901
|
+
"text": "boolean"
|
647
902
|
},
|
648
|
-
"
|
649
|
-
"
|
650
|
-
"
|
651
|
-
"name": "AvatarComponentMixin",
|
652
|
-
"module": "utils/mixins/AvatarComponentMixin.js"
|
653
|
-
}
|
903
|
+
"default": "false",
|
904
|
+
"description": "Overlay is to add a thin outline to the badge.\nThis will help distinguish between the badge and the button,\nwhere the badge will be layered on top of a button.",
|
905
|
+
"attribute": "overlay"
|
654
906
|
},
|
655
907
|
{
|
656
908
|
"kind": "field",
|
657
|
-
"name": "
|
909
|
+
"name": "ariaLabel",
|
658
910
|
"type": {
|
659
|
-
"text": "
|
911
|
+
"text": "string | null"
|
660
912
|
},
|
661
|
-
"default": "
|
662
|
-
"description": "
|
663
|
-
"attribute": "
|
664
|
-
|
665
|
-
|
666
|
-
|
667
|
-
|
913
|
+
"default": "null",
|
914
|
+
"description": "Aria-label attribute to be set for accessibility",
|
915
|
+
"attribute": "aria-label"
|
916
|
+
},
|
917
|
+
{
|
918
|
+
"kind": "method",
|
919
|
+
"name": "getCounterText",
|
920
|
+
"privacy": "private",
|
921
|
+
"return": {
|
922
|
+
"type": {
|
923
|
+
"text": ""
|
924
|
+
}
|
925
|
+
},
|
926
|
+
"parameters": [
|
927
|
+
{
|
928
|
+
"name": "maxCounter",
|
929
|
+
"type": {
|
930
|
+
"text": "number"
|
931
|
+
},
|
932
|
+
"description": "the maximum limit which can be displayed on the badge"
|
933
|
+
},
|
934
|
+
{
|
935
|
+
"name": "counter",
|
936
|
+
"optional": true,
|
937
|
+
"type": {
|
938
|
+
"text": "number"
|
939
|
+
},
|
940
|
+
"description": "the number to be displayed on the badge"
|
941
|
+
}
|
942
|
+
],
|
943
|
+
"description": "If `type` is set to `counter` and if `counter` is greater than `maxCounter`,\nthen it will return a string the maxCounter value as string.\nOtherwise, it will return a string representation of `counter`.\nIf `counter` is not a number, it will return an empty string."
|
944
|
+
},
|
945
|
+
{
|
946
|
+
"kind": "method",
|
947
|
+
"name": "getBadgeIcon",
|
948
|
+
"privacy": "private",
|
949
|
+
"return": {
|
950
|
+
"type": {
|
951
|
+
"text": ""
|
952
|
+
}
|
953
|
+
},
|
954
|
+
"parameters": [
|
955
|
+
{
|
956
|
+
"name": "iconName",
|
957
|
+
"type": {
|
958
|
+
"text": "string"
|
959
|
+
},
|
960
|
+
"description": "the name of the icon from the icon set"
|
961
|
+
},
|
962
|
+
{
|
963
|
+
"name": "backgroundClassPostfix",
|
964
|
+
"type": {
|
965
|
+
"text": "string"
|
966
|
+
},
|
967
|
+
"description": "postfix for the class to style the badge icon."
|
968
|
+
}
|
969
|
+
],
|
970
|
+
"description": "Method to generate the badge icon."
|
971
|
+
},
|
972
|
+
{
|
973
|
+
"kind": "method",
|
974
|
+
"name": "getBadgeDot",
|
975
|
+
"privacy": "private",
|
976
|
+
"return": {
|
977
|
+
"type": {
|
978
|
+
"text": ""
|
979
|
+
}
|
980
|
+
},
|
981
|
+
"description": "Method to generate the badge dot template."
|
982
|
+
},
|
983
|
+
{
|
984
|
+
"kind": "method",
|
985
|
+
"name": "getBadgeCounterText",
|
986
|
+
"privacy": "private",
|
987
|
+
"return": {
|
988
|
+
"type": {
|
989
|
+
"text": ""
|
990
|
+
}
|
991
|
+
},
|
992
|
+
"description": "Method to generate the badge text and counter template."
|
993
|
+
},
|
994
|
+
{
|
995
|
+
"kind": "method",
|
996
|
+
"name": "setRoleByAriaLabel",
|
997
|
+
"privacy": "private",
|
998
|
+
"return": {
|
999
|
+
"type": {
|
1000
|
+
"text": "void"
|
1001
|
+
}
|
1002
|
+
},
|
1003
|
+
"description": "Method to set the role based on the aria-label provided.\nIf the aria-label is provided, the role of the element will be 'img'.\nOtherwise, the role will be null."
|
1004
|
+
},
|
1005
|
+
{
|
1006
|
+
"kind": "method",
|
1007
|
+
"name": "getBadgeContentBasedOnType",
|
1008
|
+
"privacy": "private",
|
1009
|
+
"return": {
|
1010
|
+
"type": {
|
1011
|
+
"text": ""
|
1012
|
+
}
|
1013
|
+
},
|
1014
|
+
"description": "Generates the badge content based on the badge type.\nUtilizes various helper methods to create the appropriate badge template based on the\ncurrent badge type. Supports 'dot', 'icon', 'counter', 'success', 'warning', and 'error'\ntypes, returning the corresponding template result for each type."
|
668
1015
|
},
|
669
1016
|
{
|
670
1017
|
"kind": "field",
|
@@ -680,97 +1027,58 @@
|
|
680
1027
|
}
|
681
1028
|
}
|
682
1029
|
],
|
683
|
-
"mixins": [
|
684
|
-
{
|
685
|
-
"name": "AvatarComponentMixin",
|
686
|
-
"module": "/src/utils/mixins/AvatarComponentMixin"
|
687
|
-
},
|
688
|
-
{
|
689
|
-
"name": "IconNameMixin",
|
690
|
-
"module": "/src/utils/mixins/IconNameMixin"
|
691
|
-
}
|
692
|
-
],
|
693
|
-
"superclass": {
|
694
|
-
"name": "Component",
|
695
|
-
"module": "/src/models"
|
696
|
-
},
|
697
|
-
"tagName": "mdc-avatar",
|
698
|
-
"jsDoc": "/**\n * The `mdc-avatar` component is used to represent a person or a space.\n * An avatar can be an icon, initials, counter and photo.\n *\n * To set the photo of an avatar,\n * you need to set \"src\" attribute.\n *\n * While the avatar image is loading, as a placeholder,\n * we will show the initials text.\n * If the initials are not specified then,\n * we will show `user-regular` icon as a placeholder.\n *\n * By default, if there are no attributes specified,\n * then the default avatar will be an icon with `user-regular` name.\n *\n * The avatar component is non clickable and non interactive/focusable component.\n * If the avatar is typing, then the loading indicator will be displayed.\n * If the counter type avatar is set to a negative number, then we will display 0.\n * The presence indicator will be hidden when the counter property is set.\n *\n * @dependency mdc-icon\n * @dependency mdc-presence\n * @dependency mdc-text\n *\n * @tagname mdc-avatar\n *\n * @cssproperty --mdc-avatar-default-background-color - Allows customization of the default background color.\n * @cssproperty --mdc-avatar-default-foreground-color - Allows customization of the default foreground color.\n * @cssproperty --mdc-avatar-loading-indicator-background-color -\n * Allows customization of the loading indicator background color.\n * @cssproperty --mdc-avatar-loading-indicator-foreground-color -\n * Allows customization of the loading indicator foreground color.\n * @cssproperty --mdc-avatar-loading-overlay-background-color -\n * Allows customization of the loading overlay background color.\n */",
|
699
|
-
"customElement": true,
|
700
1030
|
"attributes": [
|
701
1031
|
{
|
702
|
-
"name": "
|
1032
|
+
"name": "type",
|
703
1033
|
"type": {
|
704
|
-
"text": "
|
1034
|
+
"text": "BadgeType | undefined"
|
705
1035
|
},
|
706
|
-
"description": "
|
707
|
-
"fieldName": "
|
708
|
-
"inheritedFrom": {
|
709
|
-
"name": "AvatarComponentMixin",
|
710
|
-
"module": "src/utils/mixins/AvatarComponentMixin.ts"
|
711
|
-
}
|
1036
|
+
"description": "Type of the badge\nCan be `dot` (notification) , `icon`, `counter`, `success`, `warning` or `error`.",
|
1037
|
+
"fieldName": "type"
|
712
1038
|
},
|
713
1039
|
{
|
714
|
-
"name": "
|
1040
|
+
"name": "variant",
|
715
1041
|
"type": {
|
716
|
-
"text": "
|
1042
|
+
"text": "IconVariant"
|
717
1043
|
},
|
718
|
-
"description": "
|
719
|
-
"
|
720
|
-
"
|
721
|
-
"name": "AvatarComponentMixin",
|
722
|
-
"module": "src/utils/mixins/AvatarComponentMixin.ts"
|
723
|
-
}
|
1044
|
+
"description": "Type of the variant can be `primary` or `secondary`.\nIt defines the background and foreground color of the icon.",
|
1045
|
+
"default": "primary",
|
1046
|
+
"fieldName": "variant"
|
724
1047
|
},
|
725
1048
|
{
|
726
|
-
"name": "
|
1049
|
+
"name": "counter",
|
727
1050
|
"type": {
|
728
|
-
"text": "
|
1051
|
+
"text": "number | undefined"
|
729
1052
|
},
|
730
|
-
"description": "
|
731
|
-
"fieldName": "
|
732
|
-
"inheritedFrom": {
|
733
|
-
"name": "AvatarComponentMixin",
|
734
|
-
"module": "src/utils/mixins/AvatarComponentMixin.ts"
|
735
|
-
}
|
1053
|
+
"description": "Counter is the number which can be provided in the badge.",
|
1054
|
+
"fieldName": "counter"
|
736
1055
|
},
|
737
1056
|
{
|
738
|
-
"name": "
|
1057
|
+
"name": "max-counter",
|
739
1058
|
"type": {
|
740
|
-
"text": "
|
1059
|
+
"text": "number"
|
741
1060
|
},
|
742
|
-
"description": "
|
743
|
-
"default": "
|
744
|
-
"fieldName": "
|
745
|
-
"inheritedFrom": {
|
746
|
-
"name": "AvatarComponentMixin",
|
747
|
-
"module": "src/utils/mixins/AvatarComponentMixin.ts"
|
748
|
-
}
|
1061
|
+
"description": "The maximum number can be set up to 999, anything above that will be rendered as _999+_.\nThe max counter can be `9`, `99` or `999`.",
|
1062
|
+
"default": "99",
|
1063
|
+
"fieldName": "maxCounter"
|
749
1064
|
},
|
750
1065
|
{
|
751
|
-
"name": "
|
1066
|
+
"name": "overlay",
|
752
1067
|
"type": {
|
753
|
-
"text": "
|
1068
|
+
"text": "boolean"
|
754
1069
|
},
|
755
|
-
"
|
756
|
-
"
|
757
|
-
"
|
758
|
-
"name": "AvatarComponentMixin",
|
759
|
-
"module": "src/utils/mixins/AvatarComponentMixin.ts"
|
760
|
-
}
|
1070
|
+
"default": "false",
|
1071
|
+
"description": "Overlay is to add a thin outline to the badge.\nThis will help distinguish between the badge and the button,\nwhere the badge will be layered on top of a button.",
|
1072
|
+
"fieldName": "overlay"
|
761
1073
|
},
|
762
1074
|
{
|
763
|
-
"name": "
|
1075
|
+
"name": "aria-label",
|
764
1076
|
"type": {
|
765
|
-
"text": "
|
1077
|
+
"text": "string | null"
|
766
1078
|
},
|
767
|
-
"default": "
|
768
|
-
"description": "
|
769
|
-
"fieldName": "
|
770
|
-
"inheritedFrom": {
|
771
|
-
"name": "AvatarComponentMixin",
|
772
|
-
"module": "src/utils/mixins/AvatarComponentMixin.ts"
|
773
|
-
}
|
1079
|
+
"default": "null",
|
1080
|
+
"description": "Aria-label attribute to be set for accessibility",
|
1081
|
+
"fieldName": "ariaLabel"
|
774
1082
|
},
|
775
1083
|
{
|
776
1084
|
"name": "icon-name",
|
@@ -784,7 +1092,20 @@
|
|
784
1092
|
"module": "src/utils/mixins/IconNameMixin.ts"
|
785
1093
|
}
|
786
1094
|
}
|
787
|
-
]
|
1095
|
+
],
|
1096
|
+
"mixins": [
|
1097
|
+
{
|
1098
|
+
"name": "IconNameMixin",
|
1099
|
+
"module": "/src/utils/mixins/IconNameMixin"
|
1100
|
+
}
|
1101
|
+
],
|
1102
|
+
"superclass": {
|
1103
|
+
"name": "Component",
|
1104
|
+
"module": "/src/models"
|
1105
|
+
},
|
1106
|
+
"tagName": "mdc-badge",
|
1107
|
+
"jsDoc": "/**\n * The `mdc-badge` component is a versatile UI element used to\n * display dot, icons, counters, success, warning and error type badge.\n *\n * Supported badge types:\n * - `dot`: Displays a dot notification badge with a blue color.\n * - `icon`: Displays a badge with a specified icon using the `icon-name` attribute.\n * - `counter`: Displays a badge with a counter value. If the counter exceeds the `max-counter`,\n * it shows `maxCounter+`. The maximum value of the counter is 999 and anything above that will be set to `999+`.\n * - `success`: Displays a success badge with a check circle icon and green color.\n * - `warning`: Displays a warning badge with a warning icon and yellow color.\n * - `error`: Displays a error badge with a error legacy icon and red color.\n *\n * For `icon`, `success`, `warning` and `error` types, the `mdc-icon` component is used to render the icon.\n *\n * For the `counter` type, the `mdc-text` component is used to render the counter value.\n *\n * @dependency mdc-icon\n * @dependency mdc-text\n *\n * @tagname mdc-badge\n *\n * @cssproperty --mdc-badge-primary-foreground-color - The foreground color of the primary badge.\n * @cssproperty --mdc-badge-primary-background-color - The background color of the primary badge.\n * @cssproperty --mdc-badge-secondary-foreground-color - The foreground color of the secondary badge.\n * @cssproperty --mdc-badge-secondary-background-color - The background color of the secondary badge.\n * @cssproperty --mdc-badge-success-foreground-color - The foreground color of the success badge.\n * @cssproperty --mdc-badge-success-background-color - The background color of the success badge.\n * @cssproperty --mdc-badge-warning-foreground-color - The foreground color of the warning badge.\n * @cssproperty --mdc-badge-warning-background-color - The background color of the warning badge.\n * @cssproperty --mdc-badge-error-foreground-color - The foreground color of the error badge.\n * @cssproperty --mdc-badge-error-background-color - The background color of the error badge.\n * @cssproperty --mdc-badge-overlay-background-color - The background color of the badge overlay.\n */",
|
1108
|
+
"customElement": true
|
788
1109
|
}
|
789
1110
|
],
|
790
1111
|
"exports": [
|
@@ -792,8 +1113,8 @@
|
|
792
1113
|
"kind": "js",
|
793
1114
|
"name": "default",
|
794
1115
|
"declaration": {
|
795
|
-
"name": "
|
796
|
-
"module": "components/
|
1116
|
+
"name": "Badge",
|
1117
|
+
"module": "components/badge/badge.component.js"
|
797
1118
|
}
|
798
1119
|
}
|
799
1120
|
]
|
@@ -912,783 +1233,462 @@
|
|
912
1233
|
},
|
913
1234
|
"description": "There are 3 variants of button: primary, secondary, tertiary. They are styled differently.\n- **Primary**: Solid background color.\n- **Secondary**: Transparent background with a solid border.\n- **Tertiary**: No background or border, appears as plain text but retains all button functionalities.",
|
914
1235
|
"default": "primary",
|
915
|
-
"attribute": "variant"
|
916
|
-
},
|
917
|
-
{
|
918
|
-
"kind": "field",
|
919
|
-
"name": "size",
|
920
|
-
"type": {
|
921
|
-
"text": "ButtonSize"
|
922
|
-
},
|
923
|
-
"description": "Button sizing is based on the button type.\n- **Pill button**: 40, 32, 28, 24.\n- **Icon button**: 64, 52, 40, 32, 28, 24.\n- Tertiary icon button can also be 20.",
|
924
|
-
"default": "32",
|
925
|
-
"attribute": "size",
|
926
|
-
"reflects": true,
|
927
|
-
"inheritedFrom": {
|
928
|
-
"name": "Buttonsimple",
|
929
|
-
"module": "components/buttonsimple/buttonsimple.component.js"
|
930
|
-
}
|
931
|
-
},
|
932
|
-
{
|
933
|
-
"kind": "field",
|
934
|
-
"name": "color",
|
935
|
-
"type": {
|
936
|
-
"text": "ButtonColor"
|
937
|
-
},
|
938
|
-
"description": "There are 5 colors for button: positive, negative, accent, promotional, default.",
|
939
|
-
"default": "default",
|
940
|
-
"attribute": "color"
|
941
|
-
},
|
942
|
-
{
|
943
|
-
"kind": "field",
|
944
|
-
"name": "role",
|
945
|
-
"description": "This property defines the ARIA role for the element. By default, it is set to 'button'.\nConsumers should override this role when:\n- The element is being used in a context where a different role is more appropriate.\n- Custom behaviors are implemented that require a specific ARIA role for accessibility purposes.",
|
946
|
-
"default": "'button'",
|
947
|
-
"attribute": "role",
|
948
|
-
"reflects": true,
|
949
|
-
"type": {
|
950
|
-
"text": "string"
|
951
|
-
},
|
952
|
-
"inheritedFrom": {
|
953
|
-
"name": "Buttonsimple",
|
954
|
-
"module": "components/buttonsimple/buttonsimple.component.js"
|
955
|
-
}
|
956
|
-
},
|
957
|
-
{
|
958
|
-
"kind": "method",
|
959
|
-
"name": "modifyIconName",
|
960
|
-
"privacy": "private",
|
961
|
-
"parameters": [
|
962
|
-
{
|
963
|
-
"name": "active",
|
964
|
-
"type": {
|
965
|
-
"text": "boolean"
|
966
|
-
},
|
967
|
-
"description": "The active state."
|
968
|
-
}
|
969
|
-
],
|
970
|
-
"description": "Modifies the icon name based on the active state.\nIf the button is active, the icon name is suffixed with '-filled'.\nIf the button is inactive, the icon name is restored to its original value.\nIf '-filled' icon is not available, the icon name remains unchanged."
|
971
|
-
},
|
972
|
-
{
|
973
|
-
"kind": "method",
|
974
|
-
"name": "setVariant",
|
975
|
-
"privacy": "private",
|
976
|
-
"parameters": [
|
977
|
-
{
|
978
|
-
"name": "variant",
|
979
|
-
"type": {
|
980
|
-
"text": "ButtonVariant"
|
981
|
-
},
|
982
|
-
"description": "The variant to set."
|
983
|
-
}
|
984
|
-
],
|
985
|
-
"description": "Sets the variant attribute for the button component.\nIf the provided variant is not included in the BUTTON_VARIANTS,\nit defaults to the value specified in DEFAULTS.VARIANT."
|
986
|
-
},
|
987
|
-
{
|
988
|
-
"kind": "method",
|
989
|
-
"name": "setSize",
|
990
|
-
"privacy": "private",
|
991
|
-
"parameters": [
|
992
|
-
{
|
993
|
-
"name": "size",
|
994
|
-
"type": {
|
995
|
-
"text": "PillButtonSize | IconButtonSize"
|
996
|
-
},
|
997
|
-
"description": "The size to set."
|
998
|
-
}
|
999
|
-
],
|
1000
|
-
"description": "Sets the size attribute for the button component.\nValidates the size based on the button type (icon, pill, or tertiary).\nDefaults to DEFAULTS.SIZE if invalid."
|
1001
|
-
},
|
1002
|
-
{
|
1003
|
-
"kind": "method",
|
1004
|
-
"name": "setColor",
|
1005
|
-
"privacy": "private",
|
1006
|
-
"parameters": [
|
1007
|
-
{
|
1008
|
-
"name": "color",
|
1009
|
-
"type": {
|
1010
|
-
"text": "ButtonColor"
|
1011
|
-
},
|
1012
|
-
"description": "The color to set."
|
1013
|
-
}
|
1014
|
-
],
|
1015
|
-
"description": "Sets the color attribute for the button.\nDefaults to DEFAULTS.COLOR if invalid or for tertiary buttons."
|
1016
|
-
},
|
1017
|
-
{
|
1018
|
-
"kind": "method",
|
1019
|
-
"name": "inferButtonType",
|
1020
|
-
"privacy": "private",
|
1021
|
-
"description": "Infers the type of button based on the presence of slot and/or prefix and postfix icons.",
|
1022
|
-
"parameters": [
|
1023
|
-
{
|
1024
|
-
"description": "default slot of button",
|
1025
|
-
"name": "slot"
|
1026
|
-
}
|
1027
|
-
]
|
1028
|
-
},
|
1029
|
-
{
|
1030
|
-
"kind": "field",
|
1031
|
-
"name": "tabIndex",
|
1032
|
-
"type": {
|
1033
|
-
"text": "number"
|
1034
|
-
},
|
1035
|
-
"default": "0",
|
1036
|
-
"description": "This property specifies the tab order of the element.",
|
1037
|
-
"attribute": "tabIndex",
|
1038
|
-
"reflects": true,
|
1039
|
-
"inheritedFrom": {
|
1040
|
-
"name": "TabIndexMixin",
|
1041
|
-
"module": "utils/mixins/TabIndexMixin.js"
|
1042
|
-
}
|
1043
|
-
},
|
1044
|
-
{
|
1045
|
-
"kind": "field",
|
1046
|
-
"name": "disabled",
|
1047
|
-
"type": {
|
1048
|
-
"text": "boolean"
|
1049
|
-
},
|
1050
|
-
"default": "false",
|
1051
|
-
"description": "Indicates whether the component is disabled.\nWhen the component is disabled for user interaction; it is not focusable or clickable.",
|
1052
|
-
"attribute": "disabled",
|
1053
|
-
"reflects": true,
|
1054
|
-
"inheritedFrom": {
|
1055
|
-
"name": "DisabledMixin",
|
1056
|
-
"module": "utils/mixins/DisabledMixin.js"
|
1057
|
-
}
|
1058
|
-
},
|
1059
|
-
{
|
1060
|
-
"kind": "field",
|
1061
|
-
"name": "active",
|
1062
|
-
"type": {
|
1063
|
-
"text": "boolean"
|
1064
|
-
},
|
1065
|
-
"default": "false",
|
1066
|
-
"description": "The button's active state indicates whether it is currently toggled on (active) or off (inactive).\nWhen the active state is true, the button is considered to be in an active state, meaning it is toggled on.\nConversely, when the active state is false, the button is in an inactive state, indicating it is toggled off.",
|
1067
|
-
"attribute": "active",
|
1068
|
-
"reflects": true,
|
1069
|
-
"inheritedFrom": {
|
1070
|
-
"name": "Buttonsimple",
|
1071
|
-
"module": "components/buttonsimple/buttonsimple.component.js"
|
1072
|
-
}
|
1073
|
-
},
|
1074
|
-
{
|
1075
|
-
"kind": "field",
|
1076
|
-
"name": "softDisabled",
|
1077
|
-
"type": {
|
1078
|
-
"text": "boolean"
|
1079
|
-
},
|
1080
|
-
"default": "false",
|
1081
|
-
"description": "Indicates whether the button is soft disabled.\nWhen set to `true`, the button appears visually disabled but still allows\nfocus, click, and keyboard actions to be passed through.\n\n**Important:** When using soft disabled, consumers must ensure that\nthe button behaves like a disabled button, allowing only focus and\npreventing any interactions (clicks or keyboard actions) from triggering unintended actions.",
|
1082
|
-
"attribute": "soft-disabled",
|
1083
|
-
"inheritedFrom": {
|
1084
|
-
"name": "Buttonsimple",
|
1085
|
-
"module": "components/buttonsimple/buttonsimple.component.js"
|
1086
|
-
}
|
1087
|
-
},
|
1088
|
-
{
|
1089
|
-
"kind": "field",
|
1090
|
-
"name": "type",
|
1091
|
-
"type": {
|
1092
|
-
"text": "ButtonType"
|
1093
|
-
},
|
1094
|
-
"description": "This property defines the type attribute for the button element.\nThe type attribute specifies the behavior of the button when it is clicked.\n- **submit**: The button submits the form data to the server.\n- **reset**: The button resets the form data to its initial state.\n- **button**: The button does nothing when clicked.",
|
1095
|
-
"default": "button",
|
1096
|
-
"attribute": "type",
|
1097
|
-
"reflects": true,
|
1098
|
-
"inheritedFrom": {
|
1099
|
-
"name": "Buttonsimple",
|
1100
|
-
"module": "components/buttonsimple/buttonsimple.component.js"
|
1101
|
-
}
|
1102
|
-
},
|
1103
|
-
{
|
1104
|
-
"kind": "method",
|
1105
|
-
"name": "executeAction",
|
1106
|
-
"privacy": "protected",
|
1107
|
-
"inheritedFrom": {
|
1108
|
-
"name": "Buttonsimple",
|
1109
|
-
"module": "components/buttonsimple/buttonsimple.component.js"
|
1110
|
-
}
|
1111
|
-
},
|
1112
|
-
{
|
1113
|
-
"kind": "method",
|
1114
|
-
"name": "setActive",
|
1115
|
-
"privacy": "protected",
|
1116
|
-
"parameters": [
|
1117
|
-
{
|
1118
|
-
"name": "element",
|
1119
|
-
"type": {
|
1120
|
-
"text": "HTMLElement"
|
1121
|
-
},
|
1122
|
-
"description": "The button element"
|
1123
|
-
},
|
1124
|
-
{
|
1125
|
-
"name": "active",
|
1126
|
-
"type": {
|
1127
|
-
"text": "boolean"
|
1128
|
-
},
|
1129
|
-
"description": "The active state of the element"
|
1130
|
-
}
|
1131
|
-
],
|
1132
|
-
"description": "Sets the aria-pressed attribute based on the active state of the button.",
|
1133
|
-
"inheritedFrom": {
|
1134
|
-
"name": "Buttonsimple",
|
1135
|
-
"module": "components/buttonsimple/buttonsimple.component.js"
|
1136
|
-
}
|
1137
|
-
},
|
1138
|
-
{
|
1139
|
-
"kind": "method",
|
1140
|
-
"name": "setSoftDisabled",
|
1141
|
-
"privacy": "private",
|
1142
|
-
"parameters": [
|
1143
|
-
{
|
1144
|
-
"name": "element",
|
1145
|
-
"type": {
|
1146
|
-
"text": "HTMLElement"
|
1147
|
-
},
|
1148
|
-
"description": "The button element."
|
1149
|
-
},
|
1150
|
-
{
|
1151
|
-
"name": "softDisabled",
|
1152
|
-
"type": {
|
1153
|
-
"text": "boolean"
|
1154
|
-
},
|
1155
|
-
"description": "The soft-disabled state."
|
1156
|
-
}
|
1157
|
-
],
|
1158
|
-
"description": "Sets the soft-disabled attribute for the button.\nWhen soft-disabled, the button looks to be disabled but remains focusable and clickable.\nAlso sets/removes aria-disabled attribute.",
|
1159
|
-
"inheritedFrom": {
|
1160
|
-
"name": "Buttonsimple",
|
1161
|
-
"module": "components/buttonsimple/buttonsimple.component.js"
|
1162
|
-
}
|
1163
|
-
},
|
1164
|
-
{
|
1165
|
-
"kind": "method",
|
1166
|
-
"name": "setDisabled",
|
1167
|
-
"privacy": "private",
|
1168
|
-
"parameters": [
|
1169
|
-
{
|
1170
|
-
"name": "element",
|
1171
|
-
"type": {
|
1172
|
-
"text": "HTMLElement"
|
1173
|
-
},
|
1174
|
-
"description": "The button element."
|
1175
|
-
},
|
1176
|
-
{
|
1177
|
-
"name": "disabled",
|
1178
|
-
"type": {
|
1179
|
-
"text": "boolean"
|
1180
|
-
},
|
1181
|
-
"description": "The disabled state."
|
1182
|
-
}
|
1183
|
-
],
|
1184
|
-
"description": "Sets the disabled attribute for the button.\nWhen disabled, the button is not focusable or clickable, and tabindex is set to -1.\nThe previous tabindex is stored and restored when enabled.\nAlso sets/removes aria-disabled attribute.",
|
1185
|
-
"inheritedFrom": {
|
1186
|
-
"name": "Buttonsimple",
|
1187
|
-
"module": "components/buttonsimple/buttonsimple.component.js"
|
1188
|
-
}
|
1189
|
-
},
|
1190
|
-
{
|
1191
|
-
"kind": "method",
|
1192
|
-
"name": "triggerClickEvent",
|
1193
|
-
"privacy": "private",
|
1194
|
-
"inheritedFrom": {
|
1195
|
-
"name": "Buttonsimple",
|
1196
|
-
"module": "components/buttonsimple/buttonsimple.component.js"
|
1197
|
-
}
|
1198
|
-
},
|
1199
|
-
{
|
1200
|
-
"kind": "method",
|
1201
|
-
"name": "handleKeyDown",
|
1202
|
-
"privacy": "private",
|
1203
|
-
"parameters": [
|
1204
|
-
{
|
1205
|
-
"name": "event",
|
1206
|
-
"type": {
|
1207
|
-
"text": "KeyboardEvent"
|
1208
|
-
},
|
1209
|
-
"description": "The keyboard event."
|
1210
|
-
}
|
1211
|
-
],
|
1212
|
-
"description": "Handles the keydown event on the button.\nIf the key is 'Enter' or 'Space', the button is pressed.\nIf the key is 'Enter', the button is pressed. The native HTML button works in the same way.",
|
1213
|
-
"inheritedFrom": {
|
1214
|
-
"name": "Buttonsimple",
|
1215
|
-
"module": "components/buttonsimple/buttonsimple.component.js"
|
1216
|
-
}
|
1217
|
-
},
|
1218
|
-
{
|
1219
|
-
"kind": "method",
|
1220
|
-
"name": "handleKeyUp",
|
1221
|
-
"privacy": "private",
|
1222
|
-
"parameters": [
|
1223
|
-
{
|
1224
|
-
"name": "event",
|
1225
|
-
"type": {
|
1226
|
-
"text": "KeyboardEvent"
|
1227
|
-
},
|
1228
|
-
"description": "The keyboard event."
|
1229
|
-
}
|
1230
|
-
],
|
1231
|
-
"description": "Handles the keyup event on the button.\nIf the key is 'Enter' or 'Space', the button is clicked.\nIf the key is 'Space', the button is pressed. The native HTML button works in the same way.",
|
1232
|
-
"inheritedFrom": {
|
1233
|
-
"name": "Buttonsimple",
|
1234
|
-
"module": "components/buttonsimple/buttonsimple.component.js"
|
1235
|
-
}
|
1236
|
-
}
|
1237
|
-
],
|
1238
|
-
"attributes": [
|
1239
|
-
{
|
1240
|
-
"name": "prefix-icon",
|
1241
|
-
"type": {
|
1242
|
-
"text": "string | undefined"
|
1243
|
-
},
|
1244
|
-
"description": "The name of the icon to display as a prefix.\nThe icon is displayed on the left side of the button.",
|
1245
|
-
"fieldName": "prefixIcon"
|
1246
|
-
},
|
1247
|
-
{
|
1248
|
-
"name": "postfix-icon",
|
1249
|
-
"type": {
|
1250
|
-
"text": "string | undefined"
|
1251
|
-
},
|
1252
|
-
"description": "The name of the icon to display as a postfix.\nThe icon is displayed on the right side of the button.",
|
1253
|
-
"fieldName": "postfixIcon"
|
1254
|
-
},
|
1255
|
-
{
|
1256
|
-
"name": "variant",
|
1257
|
-
"type": {
|
1258
|
-
"text": "ButtonVariant"
|
1259
|
-
},
|
1260
|
-
"description": "There are 3 variants of button: primary, secondary, tertiary. They are styled differently.\n- **Primary**: Solid background color.\n- **Secondary**: Transparent background with a solid border.\n- **Tertiary**: No background or border, appears as plain text but retains all button functionalities.",
|
1261
|
-
"default": "primary",
|
1262
|
-
"fieldName": "variant"
|
1236
|
+
"attribute": "variant"
|
1263
1237
|
},
|
1264
1238
|
{
|
1239
|
+
"kind": "field",
|
1265
1240
|
"name": "size",
|
1266
1241
|
"type": {
|
1267
1242
|
"text": "ButtonSize"
|
1268
1243
|
},
|
1269
1244
|
"description": "Button sizing is based on the button type.\n- **Pill button**: 40, 32, 28, 24.\n- **Icon button**: 64, 52, 40, 32, 28, 24.\n- Tertiary icon button can also be 20.",
|
1270
1245
|
"default": "32",
|
1271
|
-
"
|
1246
|
+
"attribute": "size",
|
1247
|
+
"reflects": true,
|
1272
1248
|
"inheritedFrom": {
|
1273
1249
|
"name": "Buttonsimple",
|
1274
|
-
"module": "
|
1250
|
+
"module": "components/buttonsimple/buttonsimple.component.js"
|
1275
1251
|
}
|
1276
1252
|
},
|
1277
1253
|
{
|
1254
|
+
"kind": "field",
|
1278
1255
|
"name": "color",
|
1279
1256
|
"type": {
|
1280
1257
|
"text": "ButtonColor"
|
1281
1258
|
},
|
1282
1259
|
"description": "There are 5 colors for button: positive, negative, accent, promotional, default.",
|
1283
1260
|
"default": "default",
|
1284
|
-
"
|
1261
|
+
"attribute": "color"
|
1285
1262
|
},
|
1286
1263
|
{
|
1264
|
+
"kind": "field",
|
1287
1265
|
"name": "role",
|
1288
1266
|
"description": "This property defines the ARIA role for the element. By default, it is set to 'button'.\nConsumers should override this role when:\n- The element is being used in a context where a different role is more appropriate.\n- Custom behaviors are implemented that require a specific ARIA role for accessibility purposes.",
|
1289
1267
|
"default": "'button'",
|
1290
|
-
"
|
1268
|
+
"attribute": "role",
|
1269
|
+
"reflects": true,
|
1291
1270
|
"type": {
|
1292
1271
|
"text": "string"
|
1293
1272
|
},
|
1294
1273
|
"inheritedFrom": {
|
1295
1274
|
"name": "Buttonsimple",
|
1296
|
-
"module": "
|
1275
|
+
"module": "components/buttonsimple/buttonsimple.component.js"
|
1297
1276
|
}
|
1298
1277
|
},
|
1299
1278
|
{
|
1279
|
+
"kind": "method",
|
1280
|
+
"name": "modifyIconName",
|
1281
|
+
"privacy": "private",
|
1282
|
+
"parameters": [
|
1283
|
+
{
|
1284
|
+
"name": "active",
|
1285
|
+
"type": {
|
1286
|
+
"text": "boolean"
|
1287
|
+
},
|
1288
|
+
"description": "The active state."
|
1289
|
+
}
|
1290
|
+
],
|
1291
|
+
"description": "Modifies the icon name based on the active state.\nIf the button is active, the icon name is suffixed with '-filled'.\nIf the button is inactive, the icon name is restored to its original value.\nIf '-filled' icon is not available, the icon name remains unchanged."
|
1292
|
+
},
|
1293
|
+
{
|
1294
|
+
"kind": "method",
|
1295
|
+
"name": "setVariant",
|
1296
|
+
"privacy": "private",
|
1297
|
+
"parameters": [
|
1298
|
+
{
|
1299
|
+
"name": "variant",
|
1300
|
+
"type": {
|
1301
|
+
"text": "ButtonVariant"
|
1302
|
+
},
|
1303
|
+
"description": "The variant to set."
|
1304
|
+
}
|
1305
|
+
],
|
1306
|
+
"description": "Sets the variant attribute for the button component.\nIf the provided variant is not included in the BUTTON_VARIANTS,\nit defaults to the value specified in DEFAULTS.VARIANT."
|
1307
|
+
},
|
1308
|
+
{
|
1309
|
+
"kind": "method",
|
1310
|
+
"name": "setSize",
|
1311
|
+
"privacy": "private",
|
1312
|
+
"parameters": [
|
1313
|
+
{
|
1314
|
+
"name": "size",
|
1315
|
+
"type": {
|
1316
|
+
"text": "PillButtonSize | IconButtonSize"
|
1317
|
+
},
|
1318
|
+
"description": "The size to set."
|
1319
|
+
}
|
1320
|
+
],
|
1321
|
+
"description": "Sets the size attribute for the button component.\nValidates the size based on the button type (icon, pill, or tertiary).\nDefaults to DEFAULTS.SIZE if invalid."
|
1322
|
+
},
|
1323
|
+
{
|
1324
|
+
"kind": "method",
|
1325
|
+
"name": "setColor",
|
1326
|
+
"privacy": "private",
|
1327
|
+
"parameters": [
|
1328
|
+
{
|
1329
|
+
"name": "color",
|
1330
|
+
"type": {
|
1331
|
+
"text": "ButtonColor"
|
1332
|
+
},
|
1333
|
+
"description": "The color to set."
|
1334
|
+
}
|
1335
|
+
],
|
1336
|
+
"description": "Sets the color attribute for the button.\nDefaults to DEFAULTS.COLOR if invalid or for tertiary buttons."
|
1337
|
+
},
|
1338
|
+
{
|
1339
|
+
"kind": "method",
|
1340
|
+
"name": "inferButtonType",
|
1341
|
+
"privacy": "private",
|
1342
|
+
"description": "Infers the type of button based on the presence of slot and/or prefix and postfix icons.",
|
1343
|
+
"parameters": [
|
1344
|
+
{
|
1345
|
+
"description": "default slot of button",
|
1346
|
+
"name": "slot"
|
1347
|
+
}
|
1348
|
+
]
|
1349
|
+
},
|
1350
|
+
{
|
1351
|
+
"kind": "field",
|
1300
1352
|
"name": "tabIndex",
|
1301
1353
|
"type": {
|
1302
1354
|
"text": "number"
|
1303
1355
|
},
|
1304
1356
|
"default": "0",
|
1305
1357
|
"description": "This property specifies the tab order of the element.",
|
1306
|
-
"
|
1358
|
+
"attribute": "tabIndex",
|
1359
|
+
"reflects": true,
|
1307
1360
|
"inheritedFrom": {
|
1308
1361
|
"name": "TabIndexMixin",
|
1309
|
-
"module": "
|
1362
|
+
"module": "utils/mixins/TabIndexMixin.js"
|
1310
1363
|
}
|
1311
1364
|
},
|
1312
1365
|
{
|
1366
|
+
"kind": "field",
|
1313
1367
|
"name": "disabled",
|
1314
1368
|
"type": {
|
1315
1369
|
"text": "boolean"
|
1316
1370
|
},
|
1317
1371
|
"default": "false",
|
1318
1372
|
"description": "Indicates whether the component is disabled.\nWhen the component is disabled for user interaction; it is not focusable or clickable.",
|
1319
|
-
"
|
1373
|
+
"attribute": "disabled",
|
1374
|
+
"reflects": true,
|
1320
1375
|
"inheritedFrom": {
|
1321
1376
|
"name": "DisabledMixin",
|
1322
|
-
"module": "
|
1377
|
+
"module": "utils/mixins/DisabledMixin.js"
|
1323
1378
|
}
|
1324
1379
|
},
|
1325
1380
|
{
|
1381
|
+
"kind": "field",
|
1326
1382
|
"name": "active",
|
1327
1383
|
"type": {
|
1328
1384
|
"text": "boolean"
|
1329
1385
|
},
|
1330
1386
|
"default": "false",
|
1331
1387
|
"description": "The button's active state indicates whether it is currently toggled on (active) or off (inactive).\nWhen the active state is true, the button is considered to be in an active state, meaning it is toggled on.\nConversely, when the active state is false, the button is in an inactive state, indicating it is toggled off.",
|
1332
|
-
"
|
1333
|
-
"
|
1334
|
-
"name": "Buttonsimple",
|
1335
|
-
"module": "src/components/buttonsimple/buttonsimple.component.ts"
|
1336
|
-
}
|
1337
|
-
},
|
1338
|
-
{
|
1339
|
-
"name": "soft-disabled",
|
1340
|
-
"type": {
|
1341
|
-
"text": "boolean"
|
1342
|
-
},
|
1343
|
-
"default": "false",
|
1344
|
-
"description": "Indicates whether the button is soft disabled.\nWhen set to `true`, the button appears visually disabled but still allows\nfocus, click, and keyboard actions to be passed through.\n\n**Important:** When using soft disabled, consumers must ensure that\nthe button behaves like a disabled button, allowing only focus and\npreventing any interactions (clicks or keyboard actions) from triggering unintended actions.",
|
1345
|
-
"fieldName": "softDisabled",
|
1346
|
-
"inheritedFrom": {
|
1347
|
-
"name": "Buttonsimple",
|
1348
|
-
"module": "src/components/buttonsimple/buttonsimple.component.ts"
|
1349
|
-
}
|
1350
|
-
},
|
1351
|
-
{
|
1352
|
-
"name": "type",
|
1353
|
-
"type": {
|
1354
|
-
"text": "ButtonType"
|
1355
|
-
},
|
1356
|
-
"description": "This property defines the type attribute for the button element.\nThe type attribute specifies the behavior of the button when it is clicked.\n- **submit**: The button submits the form data to the server.\n- **reset**: The button resets the form data to its initial state.\n- **button**: The button does nothing when clicked.",
|
1357
|
-
"default": "button",
|
1358
|
-
"fieldName": "type",
|
1388
|
+
"attribute": "active",
|
1389
|
+
"reflects": true,
|
1359
1390
|
"inheritedFrom": {
|
1360
1391
|
"name": "Buttonsimple",
|
1361
|
-
"module": "
|
1392
|
+
"module": "components/buttonsimple/buttonsimple.component.js"
|
1362
1393
|
}
|
1363
|
-
}
|
1364
|
-
],
|
1365
|
-
"superclass": {
|
1366
|
-
"name": "Buttonsimple",
|
1367
|
-
"module": "/src/components/buttonsimple/buttonsimple.component"
|
1368
|
-
},
|
1369
|
-
"tagName": "mdc-button",
|
1370
|
-
"jsDoc": "/**\n * `mdc-button` is a component that can be configured in various ways to suit different use cases.\n *\n * Button Variants:\n * - **Primary**: Solid background color.\n * - **Secondary**: Transparent background with a solid border.\n * - **Tertiary**: No background or border, appears as plain text but retains all button functionalities.\n *\n * Button Colors:\n * - **Positive**: Green color.\n * - **Negative**: Red color.\n * - **Accent**: Blue color.\n * - **Promotional**: Purple color.\n * - **Default**: White color.\n *\n * Button Sizes (in REM units):\n * - **Pill button**: 40, 32, 28, 24.\n * - **Icon button**: 64, 52, 40, 32, 28, 24.\n * - **Tertiary icon button**: 20.\n *\n * Button Types:\n * - **Pill button**: A button that contains text value. Commonly used for call to action, tags, or filters.\n * - **Pill button with icons**: A button containing an icon either on the left or right side of the button.\n * - **Icon button**: A button represented by just an icon without any text.\n * The type of button is inferred based on the presence of slot and/or prefix and postfix icons.\n *\n * @dependency mdc-icon\n *\n * @tagname mdc-button\n *\n * @slot - Text label of the button.\n */",
|
1371
|
-
"customElement": true
|
1372
|
-
}
|
1373
|
-
],
|
1374
|
-
"exports": [
|
1375
|
-
{
|
1376
|
-
"kind": "js",
|
1377
|
-
"name": "default",
|
1378
|
-
"declaration": {
|
1379
|
-
"name": "Button",
|
1380
|
-
"module": "components/button/button.component.js"
|
1381
|
-
}
|
1382
|
-
}
|
1383
|
-
]
|
1384
|
-
},
|
1385
|
-
{
|
1386
|
-
"kind": "javascript-module",
|
1387
|
-
"path": "components/badge/badge.component.js",
|
1388
|
-
"declarations": [
|
1389
|
-
{
|
1390
|
-
"kind": "class",
|
1391
|
-
"description": "The `mdc-badge` component is a versatile UI element used to\ndisplay dot, icons, counters, success, warning and error type badge.\n\nSupported badge types:\n- `dot`: Displays a dot notification badge with a blue color.\n- `icon`: Displays a badge with a specified icon using the `icon-name` attribute.\n- `counter`: Displays a badge with a counter value. If the counter exceeds the `max-counter`,\nit shows `maxCounter+`. The maximum value of the counter is 999 and anything above that will be set to `999+`.\n- `success`: Displays a success badge with a check circle icon and green color.\n- `warning`: Displays a warning badge with a warning icon and yellow color.\n- `error`: Displays a error badge with a error legacy icon and red color.\n\nFor `icon`, `success`, `warning` and `error` types, the `mdc-icon` component is used to render the icon.\n\nFor the `counter` type, the `mdc-text` component is used to render the counter value.",
|
1392
|
-
"name": "Badge",
|
1393
|
-
"cssProperties": [
|
1394
|
-
{
|
1395
|
-
"description": "The foreground color of the primary badge.",
|
1396
|
-
"name": "--mdc-badge-primary-foreground-color"
|
1397
|
-
},
|
1398
|
-
{
|
1399
|
-
"description": "The background color of the primary badge.",
|
1400
|
-
"name": "--mdc-badge-primary-background-color"
|
1401
|
-
},
|
1402
|
-
{
|
1403
|
-
"description": "The foreground color of the secondary badge.",
|
1404
|
-
"name": "--mdc-badge-secondary-foreground-color"
|
1405
|
-
},
|
1406
|
-
{
|
1407
|
-
"description": "The background color of the secondary badge.",
|
1408
|
-
"name": "--mdc-badge-secondary-background-color"
|
1409
|
-
},
|
1410
|
-
{
|
1411
|
-
"description": "The foreground color of the success badge.",
|
1412
|
-
"name": "--mdc-badge-success-foreground-color"
|
1413
|
-
},
|
1414
|
-
{
|
1415
|
-
"description": "The background color of the success badge.",
|
1416
|
-
"name": "--mdc-badge-success-background-color"
|
1417
|
-
},
|
1418
|
-
{
|
1419
|
-
"description": "The foreground color of the warning badge.",
|
1420
|
-
"name": "--mdc-badge-warning-foreground-color"
|
1421
|
-
},
|
1422
|
-
{
|
1423
|
-
"description": "The background color of the warning badge.",
|
1424
|
-
"name": "--mdc-badge-warning-background-color"
|
1425
|
-
},
|
1426
|
-
{
|
1427
|
-
"description": "The foreground color of the error badge.",
|
1428
|
-
"name": "--mdc-badge-error-foreground-color"
|
1429
|
-
},
|
1430
|
-
{
|
1431
|
-
"description": "The background color of the error badge.",
|
1432
|
-
"name": "--mdc-badge-error-background-color"
|
1433
|
-
},
|
1434
|
-
{
|
1435
|
-
"description": "The background color of the badge overlay.",
|
1436
|
-
"name": "--mdc-badge-overlay-background-color"
|
1437
|
-
}
|
1438
|
-
],
|
1439
|
-
"members": [
|
1440
|
-
{
|
1441
|
-
"kind": "field",
|
1442
|
-
"name": "type",
|
1443
|
-
"type": {
|
1444
|
-
"text": "BadgeType | undefined"
|
1445
|
-
},
|
1446
|
-
"description": "Type of the badge\nCan be `dot` (notification) , `icon`, `counter`, `success`, `warning` or `error`.",
|
1447
|
-
"attribute": "type",
|
1448
|
-
"reflects": true
|
1449
|
-
},
|
1450
|
-
{
|
1451
|
-
"kind": "field",
|
1452
|
-
"name": "variant",
|
1453
|
-
"type": {
|
1454
|
-
"text": "IconVariant"
|
1455
|
-
},
|
1456
|
-
"description": "Type of the variant can be `primary` or `secondary`.\nIt defines the background and foreground color of the icon.",
|
1457
|
-
"default": "primary",
|
1458
|
-
"attribute": "variant",
|
1459
|
-
"reflects": true
|
1460
|
-
},
|
1461
|
-
{
|
1462
|
-
"kind": "field",
|
1463
|
-
"name": "counter",
|
1464
|
-
"type": {
|
1465
|
-
"text": "number | undefined"
|
1466
|
-
},
|
1467
|
-
"description": "Counter is the number which can be provided in the badge.",
|
1468
|
-
"attribute": "counter"
|
1469
|
-
},
|
1470
|
-
{
|
1471
|
-
"kind": "field",
|
1472
|
-
"name": "maxCounter",
|
1473
|
-
"type": {
|
1474
|
-
"text": "number"
|
1475
|
-
},
|
1476
|
-
"description": "The maximum number can be set up to 999, anything above that will be rendered as _999+_.\nThe max counter can be `9`, `99` or `999`.",
|
1477
|
-
"default": "99",
|
1478
|
-
"attribute": "max-counter",
|
1479
|
-
"reflects": true
|
1480
1394
|
},
|
1481
1395
|
{
|
1482
1396
|
"kind": "field",
|
1483
|
-
"name": "
|
1397
|
+
"name": "softDisabled",
|
1484
1398
|
"type": {
|
1485
1399
|
"text": "boolean"
|
1486
1400
|
},
|
1487
1401
|
"default": "false",
|
1488
|
-
"description": "
|
1489
|
-
"attribute": "
|
1402
|
+
"description": "Indicates whether the button is soft disabled.\nWhen set to `true`, the button appears visually disabled but still allows\nfocus, click, and keyboard actions to be passed through.\n\n**Important:** When using soft disabled, consumers must ensure that\nthe button behaves like a disabled button, allowing only focus and\npreventing any interactions (clicks or keyboard actions) from triggering unintended actions.",
|
1403
|
+
"attribute": "soft-disabled",
|
1404
|
+
"inheritedFrom": {
|
1405
|
+
"name": "Buttonsimple",
|
1406
|
+
"module": "components/buttonsimple/buttonsimple.component.js"
|
1407
|
+
}
|
1490
1408
|
},
|
1491
1409
|
{
|
1492
1410
|
"kind": "field",
|
1493
|
-
"name": "
|
1411
|
+
"name": "type",
|
1494
1412
|
"type": {
|
1495
|
-
"text": "
|
1413
|
+
"text": "ButtonType"
|
1496
1414
|
},
|
1497
|
-
"
|
1498
|
-
"
|
1499
|
-
"attribute": "
|
1415
|
+
"description": "This property defines the type attribute for the button element.\nThe type attribute specifies the behavior of the button when it is clicked.\n- **submit**: The button submits the form data to the server.\n- **reset**: The button resets the form data to its initial state.\n- **button**: The button does nothing when clicked.",
|
1416
|
+
"default": "button",
|
1417
|
+
"attribute": "type",
|
1418
|
+
"reflects": true,
|
1419
|
+
"inheritedFrom": {
|
1420
|
+
"name": "Buttonsimple",
|
1421
|
+
"module": "components/buttonsimple/buttonsimple.component.js"
|
1422
|
+
}
|
1500
1423
|
},
|
1501
1424
|
{
|
1502
1425
|
"kind": "method",
|
1503
|
-
"name": "
|
1504
|
-
"privacy": "
|
1505
|
-
"
|
1506
|
-
"
|
1507
|
-
|
1508
|
-
|
1509
|
-
|
1426
|
+
"name": "executeAction",
|
1427
|
+
"privacy": "protected",
|
1428
|
+
"inheritedFrom": {
|
1429
|
+
"name": "Buttonsimple",
|
1430
|
+
"module": "components/buttonsimple/buttonsimple.component.js"
|
1431
|
+
}
|
1432
|
+
},
|
1433
|
+
{
|
1434
|
+
"kind": "method",
|
1435
|
+
"name": "setActive",
|
1436
|
+
"privacy": "protected",
|
1510
1437
|
"parameters": [
|
1511
1438
|
{
|
1512
|
-
"name": "
|
1439
|
+
"name": "element",
|
1513
1440
|
"type": {
|
1514
|
-
"text": "
|
1441
|
+
"text": "HTMLElement"
|
1515
1442
|
},
|
1516
|
-
"description": "
|
1443
|
+
"description": "The button element"
|
1517
1444
|
},
|
1518
1445
|
{
|
1519
|
-
"name": "
|
1520
|
-
"optional": true,
|
1446
|
+
"name": "active",
|
1521
1447
|
"type": {
|
1522
|
-
"text": "
|
1448
|
+
"text": "boolean"
|
1523
1449
|
},
|
1524
|
-
"description": "
|
1450
|
+
"description": "The active state of the element"
|
1525
1451
|
}
|
1526
1452
|
],
|
1527
|
-
"description": "
|
1453
|
+
"description": "Sets the aria-pressed attribute based on the active state of the button.",
|
1454
|
+
"inheritedFrom": {
|
1455
|
+
"name": "Buttonsimple",
|
1456
|
+
"module": "components/buttonsimple/buttonsimple.component.js"
|
1457
|
+
}
|
1528
1458
|
},
|
1529
1459
|
{
|
1530
1460
|
"kind": "method",
|
1531
|
-
"name": "
|
1461
|
+
"name": "setSoftDisabled",
|
1532
1462
|
"privacy": "private",
|
1533
|
-
"return": {
|
1534
|
-
"type": {
|
1535
|
-
"text": ""
|
1536
|
-
}
|
1537
|
-
},
|
1538
1463
|
"parameters": [
|
1539
1464
|
{
|
1540
|
-
"name": "
|
1465
|
+
"name": "element",
|
1541
1466
|
"type": {
|
1542
|
-
"text": "
|
1467
|
+
"text": "HTMLElement"
|
1543
1468
|
},
|
1544
|
-
"description": "
|
1469
|
+
"description": "The button element."
|
1545
1470
|
},
|
1546
1471
|
{
|
1547
|
-
"name": "
|
1472
|
+
"name": "softDisabled",
|
1548
1473
|
"type": {
|
1549
|
-
"text": "
|
1474
|
+
"text": "boolean"
|
1550
1475
|
},
|
1551
|
-
"description": "
|
1476
|
+
"description": "The soft-disabled state."
|
1552
1477
|
}
|
1553
1478
|
],
|
1554
|
-
"description": "
|
1479
|
+
"description": "Sets the soft-disabled attribute for the button.\nWhen soft-disabled, the button looks to be disabled but remains focusable and clickable.\nAlso sets/removes aria-disabled attribute.",
|
1480
|
+
"inheritedFrom": {
|
1481
|
+
"name": "Buttonsimple",
|
1482
|
+
"module": "components/buttonsimple/buttonsimple.component.js"
|
1483
|
+
}
|
1555
1484
|
},
|
1556
1485
|
{
|
1557
1486
|
"kind": "method",
|
1558
|
-
"name": "
|
1487
|
+
"name": "setDisabled",
|
1559
1488
|
"privacy": "private",
|
1560
|
-
"
|
1561
|
-
|
1562
|
-
"
|
1489
|
+
"parameters": [
|
1490
|
+
{
|
1491
|
+
"name": "element",
|
1492
|
+
"type": {
|
1493
|
+
"text": "HTMLElement"
|
1494
|
+
},
|
1495
|
+
"description": "The button element."
|
1496
|
+
},
|
1497
|
+
{
|
1498
|
+
"name": "disabled",
|
1499
|
+
"type": {
|
1500
|
+
"text": "boolean"
|
1501
|
+
},
|
1502
|
+
"description": "The disabled state."
|
1563
1503
|
}
|
1564
|
-
|
1565
|
-
"description": "
|
1504
|
+
],
|
1505
|
+
"description": "Sets the disabled attribute for the button.\nWhen disabled, the button is not focusable or clickable, and tabindex is set to -1.\nThe previous tabindex is stored and restored when enabled.\nAlso sets/removes aria-disabled attribute.",
|
1506
|
+
"inheritedFrom": {
|
1507
|
+
"name": "Buttonsimple",
|
1508
|
+
"module": "components/buttonsimple/buttonsimple.component.js"
|
1509
|
+
}
|
1566
1510
|
},
|
1567
1511
|
{
|
1568
1512
|
"kind": "method",
|
1569
|
-
"name": "
|
1513
|
+
"name": "triggerClickEvent",
|
1570
1514
|
"privacy": "private",
|
1571
|
-
"
|
1572
|
-
"
|
1573
|
-
|
1574
|
-
|
1575
|
-
},
|
1576
|
-
"description": "Method to generate the badge text and counter template."
|
1515
|
+
"inheritedFrom": {
|
1516
|
+
"name": "Buttonsimple",
|
1517
|
+
"module": "components/buttonsimple/buttonsimple.component.js"
|
1518
|
+
}
|
1577
1519
|
},
|
1578
1520
|
{
|
1579
1521
|
"kind": "method",
|
1580
|
-
"name": "
|
1522
|
+
"name": "handleKeyDown",
|
1581
1523
|
"privacy": "private",
|
1582
|
-
"
|
1583
|
-
|
1584
|
-
"
|
1524
|
+
"parameters": [
|
1525
|
+
{
|
1526
|
+
"name": "event",
|
1527
|
+
"type": {
|
1528
|
+
"text": "KeyboardEvent"
|
1529
|
+
},
|
1530
|
+
"description": "The keyboard event."
|
1585
1531
|
}
|
1586
|
-
|
1587
|
-
"description": "
|
1532
|
+
],
|
1533
|
+
"description": "Handles the keydown event on the button.\nIf the key is 'Enter' or 'Space', the button is pressed.\nIf the key is 'Enter', the button is pressed. The native HTML button works in the same way.",
|
1534
|
+
"inheritedFrom": {
|
1535
|
+
"name": "Buttonsimple",
|
1536
|
+
"module": "components/buttonsimple/buttonsimple.component.js"
|
1537
|
+
}
|
1588
1538
|
},
|
1589
1539
|
{
|
1590
1540
|
"kind": "method",
|
1591
|
-
"name": "
|
1541
|
+
"name": "handleKeyUp",
|
1592
1542
|
"privacy": "private",
|
1593
|
-
"
|
1594
|
-
|
1595
|
-
"
|
1543
|
+
"parameters": [
|
1544
|
+
{
|
1545
|
+
"name": "event",
|
1546
|
+
"type": {
|
1547
|
+
"text": "KeyboardEvent"
|
1548
|
+
},
|
1549
|
+
"description": "The keyboard event."
|
1596
1550
|
}
|
1597
|
-
|
1598
|
-
"description": "
|
1599
|
-
},
|
1600
|
-
{
|
1601
|
-
"kind": "field",
|
1602
|
-
"name": "iconName",
|
1603
|
-
"type": {
|
1604
|
-
"text": "IconNames | undefined"
|
1605
|
-
},
|
1606
|
-
"description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
|
1607
|
-
"attribute": "icon-name",
|
1551
|
+
],
|
1552
|
+
"description": "Handles the keyup event on the button.\nIf the key is 'Enter' or 'Space', the button is clicked.\nIf the key is 'Space', the button is pressed. The native HTML button works in the same way.",
|
1608
1553
|
"inheritedFrom": {
|
1609
|
-
"name": "
|
1610
|
-
"module": "
|
1554
|
+
"name": "Buttonsimple",
|
1555
|
+
"module": "components/buttonsimple/buttonsimple.component.js"
|
1611
1556
|
}
|
1612
1557
|
}
|
1613
1558
|
],
|
1614
1559
|
"attributes": [
|
1615
1560
|
{
|
1616
|
-
"name": "
|
1561
|
+
"name": "prefix-icon",
|
1617
1562
|
"type": {
|
1618
|
-
"text": "
|
1563
|
+
"text": "string | undefined"
|
1619
1564
|
},
|
1620
|
-
"description": "
|
1621
|
-
"fieldName": "
|
1565
|
+
"description": "The name of the icon to display as a prefix.\nThe icon is displayed on the left side of the button.",
|
1566
|
+
"fieldName": "prefixIcon"
|
1567
|
+
},
|
1568
|
+
{
|
1569
|
+
"name": "postfix-icon",
|
1570
|
+
"type": {
|
1571
|
+
"text": "string | undefined"
|
1572
|
+
},
|
1573
|
+
"description": "The name of the icon to display as a postfix.\nThe icon is displayed on the right side of the button.",
|
1574
|
+
"fieldName": "postfixIcon"
|
1622
1575
|
},
|
1623
1576
|
{
|
1624
1577
|
"name": "variant",
|
1625
1578
|
"type": {
|
1626
|
-
"text": "
|
1579
|
+
"text": "ButtonVariant"
|
1627
1580
|
},
|
1628
|
-
"description": "
|
1581
|
+
"description": "There are 3 variants of button: primary, secondary, tertiary. They are styled differently.\n- **Primary**: Solid background color.\n- **Secondary**: Transparent background with a solid border.\n- **Tertiary**: No background or border, appears as plain text but retains all button functionalities.",
|
1629
1582
|
"default": "primary",
|
1630
1583
|
"fieldName": "variant"
|
1631
1584
|
},
|
1632
1585
|
{
|
1633
|
-
"name": "
|
1586
|
+
"name": "size",
|
1634
1587
|
"type": {
|
1635
|
-
"text": "
|
1588
|
+
"text": "ButtonSize"
|
1636
1589
|
},
|
1637
|
-
"description": "
|
1638
|
-
"
|
1590
|
+
"description": "Button sizing is based on the button type.\n- **Pill button**: 40, 32, 28, 24.\n- **Icon button**: 64, 52, 40, 32, 28, 24.\n- Tertiary icon button can also be 20.",
|
1591
|
+
"default": "32",
|
1592
|
+
"fieldName": "size",
|
1593
|
+
"inheritedFrom": {
|
1594
|
+
"name": "Buttonsimple",
|
1595
|
+
"module": "src/components/buttonsimple/buttonsimple.component.ts"
|
1596
|
+
}
|
1639
1597
|
},
|
1640
1598
|
{
|
1641
|
-
"name": "
|
1599
|
+
"name": "color",
|
1600
|
+
"type": {
|
1601
|
+
"text": "ButtonColor"
|
1602
|
+
},
|
1603
|
+
"description": "There are 5 colors for button: positive, negative, accent, promotional, default.",
|
1604
|
+
"default": "default",
|
1605
|
+
"fieldName": "color"
|
1606
|
+
},
|
1607
|
+
{
|
1608
|
+
"name": "role",
|
1609
|
+
"description": "This property defines the ARIA role for the element. By default, it is set to 'button'.\nConsumers should override this role when:\n- The element is being used in a context where a different role is more appropriate.\n- Custom behaviors are implemented that require a specific ARIA role for accessibility purposes.",
|
1610
|
+
"default": "'button'",
|
1611
|
+
"fieldName": "role",
|
1612
|
+
"type": {
|
1613
|
+
"text": "string"
|
1614
|
+
},
|
1615
|
+
"inheritedFrom": {
|
1616
|
+
"name": "Buttonsimple",
|
1617
|
+
"module": "src/components/buttonsimple/buttonsimple.component.ts"
|
1618
|
+
}
|
1619
|
+
},
|
1620
|
+
{
|
1621
|
+
"name": "tabIndex",
|
1642
1622
|
"type": {
|
1643
1623
|
"text": "number"
|
1644
1624
|
},
|
1645
|
-
"
|
1646
|
-
"
|
1647
|
-
"fieldName": "
|
1625
|
+
"default": "0",
|
1626
|
+
"description": "This property specifies the tab order of the element.",
|
1627
|
+
"fieldName": "tabIndex",
|
1628
|
+
"inheritedFrom": {
|
1629
|
+
"name": "TabIndexMixin",
|
1630
|
+
"module": "src/utils/mixins/TabIndexMixin.ts"
|
1631
|
+
}
|
1648
1632
|
},
|
1649
1633
|
{
|
1650
|
-
"name": "
|
1634
|
+
"name": "disabled",
|
1651
1635
|
"type": {
|
1652
1636
|
"text": "boolean"
|
1653
1637
|
},
|
1654
1638
|
"default": "false",
|
1655
|
-
"description": "
|
1656
|
-
"fieldName": "
|
1639
|
+
"description": "Indicates whether the component is disabled.\nWhen the component is disabled for user interaction; it is not focusable or clickable.",
|
1640
|
+
"fieldName": "disabled",
|
1641
|
+
"inheritedFrom": {
|
1642
|
+
"name": "DisabledMixin",
|
1643
|
+
"module": "src/utils/mixins/DisabledMixin.ts"
|
1644
|
+
}
|
1645
|
+
},
|
1646
|
+
{
|
1647
|
+
"name": "active",
|
1648
|
+
"type": {
|
1649
|
+
"text": "boolean"
|
1650
|
+
},
|
1651
|
+
"default": "false",
|
1652
|
+
"description": "The button's active state indicates whether it is currently toggled on (active) or off (inactive).\nWhen the active state is true, the button is considered to be in an active state, meaning it is toggled on.\nConversely, when the active state is false, the button is in an inactive state, indicating it is toggled off.",
|
1653
|
+
"fieldName": "active",
|
1654
|
+
"inheritedFrom": {
|
1655
|
+
"name": "Buttonsimple",
|
1656
|
+
"module": "src/components/buttonsimple/buttonsimple.component.ts"
|
1657
|
+
}
|
1657
1658
|
},
|
1658
1659
|
{
|
1659
|
-
"name": "
|
1660
|
+
"name": "soft-disabled",
|
1660
1661
|
"type": {
|
1661
|
-
"text": "
|
1662
|
+
"text": "boolean"
|
1662
1663
|
},
|
1663
|
-
"default": "
|
1664
|
-
"description": "
|
1665
|
-
"fieldName": "
|
1664
|
+
"default": "false",
|
1665
|
+
"description": "Indicates whether the button is soft disabled.\nWhen set to `true`, the button appears visually disabled but still allows\nfocus, click, and keyboard actions to be passed through.\n\n**Important:** When using soft disabled, consumers must ensure that\nthe button behaves like a disabled button, allowing only focus and\npreventing any interactions (clicks or keyboard actions) from triggering unintended actions.",
|
1666
|
+
"fieldName": "softDisabled",
|
1667
|
+
"inheritedFrom": {
|
1668
|
+
"name": "Buttonsimple",
|
1669
|
+
"module": "src/components/buttonsimple/buttonsimple.component.ts"
|
1670
|
+
}
|
1666
1671
|
},
|
1667
1672
|
{
|
1668
|
-
"name": "
|
1673
|
+
"name": "type",
|
1669
1674
|
"type": {
|
1670
|
-
"text": "
|
1675
|
+
"text": "ButtonType"
|
1671
1676
|
},
|
1672
|
-
"description": "
|
1673
|
-
"
|
1677
|
+
"description": "This property defines the type attribute for the button element.\nThe type attribute specifies the behavior of the button when it is clicked.\n- **submit**: The button submits the form data to the server.\n- **reset**: The button resets the form data to its initial state.\n- **button**: The button does nothing when clicked.",
|
1678
|
+
"default": "button",
|
1679
|
+
"fieldName": "type",
|
1674
1680
|
"inheritedFrom": {
|
1675
|
-
"name": "
|
1676
|
-
"module": "src/
|
1681
|
+
"name": "Buttonsimple",
|
1682
|
+
"module": "src/components/buttonsimple/buttonsimple.component.ts"
|
1677
1683
|
}
|
1678
1684
|
}
|
1679
1685
|
],
|
1680
|
-
"mixins": [
|
1681
|
-
{
|
1682
|
-
"name": "IconNameMixin",
|
1683
|
-
"module": "/src/utils/mixins/IconNameMixin"
|
1684
|
-
}
|
1685
|
-
],
|
1686
1686
|
"superclass": {
|
1687
|
-
"name": "
|
1688
|
-
"module": "/src/
|
1687
|
+
"name": "Buttonsimple",
|
1688
|
+
"module": "/src/components/buttonsimple/buttonsimple.component"
|
1689
1689
|
},
|
1690
|
-
"tagName": "mdc-
|
1691
|
-
"jsDoc": "/**\n *
|
1690
|
+
"tagName": "mdc-button",
|
1691
|
+
"jsDoc": "/**\n * `mdc-button` is a component that can be configured in various ways to suit different use cases.\n *\n * Button Variants:\n * - **Primary**: Solid background color.\n * - **Secondary**: Transparent background with a solid border.\n * - **Tertiary**: No background or border, appears as plain text but retains all button functionalities.\n *\n * Button Colors:\n * - **Positive**: Green color.\n * - **Negative**: Red color.\n * - **Accent**: Blue color.\n * - **Promotional**: Purple color.\n * - **Default**: White color.\n *\n * Button Sizes (in REM units):\n * - **Pill button**: 40, 32, 28, 24.\n * - **Icon button**: 64, 52, 40, 32, 28, 24.\n * - **Tertiary icon button**: 20.\n *\n * Button Types:\n * - **Pill button**: A button that contains text value. Commonly used for call to action, tags, or filters.\n * - **Pill button with icons**: A button containing an icon either on the left or right side of the button.\n * - **Icon button**: A button represented by just an icon without any text.\n * The type of button is inferred based on the presence of slot and/or prefix and postfix icons.\n *\n * @dependency mdc-icon\n *\n * @tagname mdc-button\n *\n * @slot - Text label of the button.\n */",
|
1692
1692
|
"customElement": true
|
1693
1693
|
}
|
1694
1694
|
],
|
@@ -1697,8 +1697,8 @@
|
|
1697
1697
|
"kind": "js",
|
1698
1698
|
"name": "default",
|
1699
1699
|
"declaration": {
|
1700
|
-
"name": "
|
1701
|
-
"module": "components/
|
1700
|
+
"name": "Button",
|
1701
|
+
"module": "components/button/button.component.js"
|
1702
1702
|
}
|
1703
1703
|
}
|
1704
1704
|
]
|
@@ -2234,6 +2234,20 @@
|
|
2234
2234
|
"module": "components/formfieldwrapper/formfieldwrapper.component.js"
|
2235
2235
|
}
|
2236
2236
|
},
|
2237
|
+
{
|
2238
|
+
"kind": "field",
|
2239
|
+
"name": "requiredLabel",
|
2240
|
+
"type": {
|
2241
|
+
"text": "string | undefined"
|
2242
|
+
},
|
2243
|
+
"description": "The required label of the input field.\nWhen an appropriate string value is set,\nthe input field is marked as required and the label is appended with this text.",
|
2244
|
+
"attribute": "required-label",
|
2245
|
+
"reflects": true,
|
2246
|
+
"inheritedFrom": {
|
2247
|
+
"name": "FormfieldWrapper",
|
2248
|
+
"module": "components/formfieldwrapper/formfieldwrapper.component.js"
|
2249
|
+
}
|
2250
|
+
},
|
2237
2251
|
{
|
2238
2252
|
"kind": "field",
|
2239
2253
|
"name": "id",
|
@@ -2274,6 +2288,15 @@
|
|
2274
2288
|
"module": "components/formfieldwrapper/formfieldwrapper.component.js"
|
2275
2289
|
}
|
2276
2290
|
},
|
2291
|
+
{
|
2292
|
+
"kind": "method",
|
2293
|
+
"name": "renderRequiredLabel",
|
2294
|
+
"privacy": "protected",
|
2295
|
+
"inheritedFrom": {
|
2296
|
+
"name": "FormfieldWrapper",
|
2297
|
+
"module": "components/formfieldwrapper/formfieldwrapper.component.js"
|
2298
|
+
}
|
2299
|
+
},
|
2277
2300
|
{
|
2278
2301
|
"kind": "method",
|
2279
2302
|
"name": "renderHelpTextIcon",
|
@@ -2425,6 +2448,18 @@
|
|
2425
2448
|
"module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
|
2426
2449
|
}
|
2427
2450
|
},
|
2451
|
+
{
|
2452
|
+
"name": "required-label",
|
2453
|
+
"type": {
|
2454
|
+
"text": "string | undefined"
|
2455
|
+
},
|
2456
|
+
"description": "The required label of the input field.\nWhen an appropriate string value is set,\nthe input field is marked as required and the label is appended with this text.",
|
2457
|
+
"fieldName": "requiredLabel",
|
2458
|
+
"inheritedFrom": {
|
2459
|
+
"name": "FormfieldWrapper",
|
2460
|
+
"module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
|
2461
|
+
}
|
2462
|
+
},
|
2428
2463
|
{
|
2429
2464
|
"name": "id",
|
2430
2465
|
"default": "`mdc-input-${uuidv4()}`",
|
@@ -2784,48 +2819,265 @@
|
|
2784
2819
|
],
|
2785
2820
|
"attributes": [
|
2786
2821
|
{
|
2787
|
-
"name": "orientation",
|
2822
|
+
"name": "orientation",
|
2823
|
+
"type": {
|
2824
|
+
"text": "DividerOrientation"
|
2825
|
+
},
|
2826
|
+
"description": "Two orientations of divider\n- **horizontal**: A thin, horizontal line with 0.0625rem width.\n- **vertical**: A thin, vertical line with 0.0625rem width.\n\nNote: We do not support \"Vertical Text Divider\" as of now.",
|
2827
|
+
"default": "horizontal",
|
2828
|
+
"fieldName": "orientation"
|
2829
|
+
},
|
2830
|
+
{
|
2831
|
+
"name": "variant",
|
2832
|
+
"type": {
|
2833
|
+
"text": "DividerVariant"
|
2834
|
+
},
|
2835
|
+
"description": "Two variants of divider\n- **solid**: Solid line.\n- **gradient**: Gradient Line that fades on either sides of the divider.",
|
2836
|
+
"default": "solid",
|
2837
|
+
"fieldName": "variant"
|
2838
|
+
},
|
2839
|
+
{
|
2840
|
+
"name": "arrow-direction",
|
2841
|
+
"type": {
|
2842
|
+
"text": "Directions"
|
2843
|
+
},
|
2844
|
+
"description": "Direction of the arrow icon, if applicable.\n- **positive**\n- **negative**\n\nNote: Positive and Negative directions are defined based on Cartesian plane.",
|
2845
|
+
"default": "'negative'",
|
2846
|
+
"fieldName": "arrowDirection"
|
2847
|
+
},
|
2848
|
+
{
|
2849
|
+
"name": "button-position",
|
2850
|
+
"type": {
|
2851
|
+
"text": "Directions"
|
2852
|
+
},
|
2853
|
+
"description": "Position of the button, if applicable.\n- **positive**\n- **negative**\n\nNote: Positive and Negative directions are defined based on Cartesian plane.",
|
2854
|
+
"default": "'negative'",
|
2855
|
+
"fieldName": "buttonPosition"
|
2856
|
+
}
|
2857
|
+
],
|
2858
|
+
"superclass": {
|
2859
|
+
"name": "Component",
|
2860
|
+
"module": "/src/models"
|
2861
|
+
},
|
2862
|
+
"tagName": "mdc-divider",
|
2863
|
+
"jsDoc": "/**\n * `mdc-divider` is a component that provides a line to separate and organize content.\n * It can also include a button or text positioned centrally, allowing users to interact with the layout.\n *\n * **Divider Orientation:**\n * - **Horizontal**: A thin, horizontal line.\n * - **Vertical**: A thin, vertical line.\n *\n * **Divider Variants:**\n * - **solid**: Solid line.\n * - **gradient**: Gradient Line.\n *\n * **Divider Types:**\n * - The type of divider is inferred based on the kind of slot present.\n * - **Primary**: A simple horizontal or vertical divider.\n * - **Text**: A horizontal divider with a text label in the center.\n * - **Grabber Button**: A horizontal or vertical divider with a styled button in the center.\n *\n * **Accessibility:**\n * - When the slot is replaced by an `mdc-button`:\n * - `aria-label` should be passed to the `mdc-button`.\n * - `aria-expanded` should be passed to the `mdc-button`.\n *\n * **Notes:**\n * - If the slot is replaced by an invalid tag name or contains multiple elements,\n * the divider defaults to the **Primary** type.\n * - To override the styles of the divider, use the provided CSS custom properties.\n *\n * @tagname mdc-divider\n *\n * @cssproperty --mdc-divider-background-color - background color of the divider\n * @cssproperty --mdc-divider-width - width of the divider\n * @cssproperty --mdc-divider-horizontal-gradient - gradient of the horizontal divider\n * @cssproperty --mdc-divider-vertical-gradient - gradient of the vertical divider\n * @cssproperty --mdc-divider-text-size - font size of label in the text divider\n * @cssproperty --mdc-divider-text-color - font color of label in the text divider\n * @cssproperty --mdc-divider-text-margin - left and right margin of label in the text divider\n * @cssproperty --mdc-divider-text-line-height - line height of label in the text divider\n * @cssproperty --mdc-divider-grabber-button-border-radius - border radius of the grabber button\n */",
|
2864
|
+
"customElement": true
|
2865
|
+
}
|
2866
|
+
],
|
2867
|
+
"exports": [
|
2868
|
+
{
|
2869
|
+
"kind": "js",
|
2870
|
+
"name": "default",
|
2871
|
+
"declaration": {
|
2872
|
+
"name": "Divider",
|
2873
|
+
"module": "components/divider/divider.component.js"
|
2874
|
+
}
|
2875
|
+
}
|
2876
|
+
]
|
2877
|
+
},
|
2878
|
+
{
|
2879
|
+
"kind": "javascript-module",
|
2880
|
+
"path": "components/formfieldwrapper/formfieldwrapper.component.js",
|
2881
|
+
"declarations": [
|
2882
|
+
{
|
2883
|
+
"kind": "class",
|
2884
|
+
"description": "formfieldwrapper is a component that contains the label and helper/validation text\n that can be configured in various ways to suit different use cases (most of the input related components).\nIt is used as an internal component and is not intended to be used directly by consumers.",
|
2885
|
+
"name": "FormfieldWrapper",
|
2886
|
+
"slots": [
|
2887
|
+
{
|
2888
|
+
"description": "slot to add the label info icon",
|
2889
|
+
"name": "label-info"
|
2890
|
+
}
|
2891
|
+
],
|
2892
|
+
"members": [
|
2893
|
+
{
|
2894
|
+
"kind": "field",
|
2895
|
+
"name": "label",
|
2896
|
+
"type": {
|
2897
|
+
"text": "string | undefined"
|
2898
|
+
},
|
2899
|
+
"description": "The label of the input field. It is linked to the input field using the `for` attribute.",
|
2900
|
+
"attribute": "label",
|
2901
|
+
"reflects": true
|
2902
|
+
},
|
2903
|
+
{
|
2904
|
+
"kind": "field",
|
2905
|
+
"name": "requiredLabel",
|
2906
|
+
"type": {
|
2907
|
+
"text": "string | undefined"
|
2908
|
+
},
|
2909
|
+
"description": "The required label of the input field.\nWhen an appropriate string value is set,\nthe input field is marked as required and the label is appended with this text.",
|
2910
|
+
"attribute": "required-label",
|
2911
|
+
"reflects": true
|
2912
|
+
},
|
2913
|
+
{
|
2914
|
+
"kind": "field",
|
2915
|
+
"name": "id",
|
2916
|
+
"default": "`mdc-input-${uuidv4()}`",
|
2917
|
+
"description": "The unique id of the input field. It is used to link the input field with the label.",
|
2918
|
+
"attribute": "id"
|
2919
|
+
},
|
2920
|
+
{
|
2921
|
+
"kind": "field",
|
2922
|
+
"name": "helpTextType",
|
2923
|
+
"type": {
|
2924
|
+
"text": "ValidationType"
|
2925
|
+
},
|
2926
|
+
"description": "The type of help text. It can be 'default', 'error', 'warning', 'success', 'priority'.",
|
2927
|
+
"attribute": "help-text-type",
|
2928
|
+
"reflects": true
|
2929
|
+
},
|
2930
|
+
{
|
2931
|
+
"kind": "field",
|
2932
|
+
"name": "helpText",
|
2933
|
+
"type": {
|
2934
|
+
"text": "string | undefined"
|
2935
|
+
},
|
2936
|
+
"description": "The help text that is displayed below the input field.",
|
2937
|
+
"attribute": "help-text",
|
2938
|
+
"reflects": true
|
2939
|
+
},
|
2940
|
+
{
|
2941
|
+
"kind": "method",
|
2942
|
+
"name": "renderLabelElement",
|
2943
|
+
"privacy": "protected",
|
2944
|
+
"description": "creates the label element when the label property is set.\nid is used to link the label with the input field.",
|
2945
|
+
"return": {
|
2946
|
+
"type": {
|
2947
|
+
"text": ""
|
2948
|
+
}
|
2949
|
+
}
|
2950
|
+
},
|
2951
|
+
{
|
2952
|
+
"kind": "method",
|
2953
|
+
"name": "renderRequiredLabel",
|
2954
|
+
"privacy": "protected"
|
2955
|
+
},
|
2956
|
+
{
|
2957
|
+
"kind": "method",
|
2958
|
+
"name": "renderHelpTextIcon",
|
2959
|
+
"privacy": "protected",
|
2960
|
+
"description": "creates the helpertext icon based on the helpTextType for validation.\nIf the helpTextType is not set, it defaults to 'default' and it doesn't display any icon.",
|
2961
|
+
"return": {
|
2962
|
+
"type": {
|
2963
|
+
"text": ""
|
2964
|
+
}
|
2965
|
+
}
|
2966
|
+
},
|
2967
|
+
{
|
2968
|
+
"kind": "method",
|
2969
|
+
"name": "renderHelpText",
|
2970
|
+
"privacy": "protected",
|
2971
|
+
"description": "creates the helper text component when the helpertext value is set.\nIt is also used to display the validation message based on the helpTextType.",
|
2972
|
+
"return": {
|
2973
|
+
"type": {
|
2974
|
+
"text": ""
|
2975
|
+
}
|
2976
|
+
}
|
2977
|
+
},
|
2978
|
+
{
|
2979
|
+
"kind": "method",
|
2980
|
+
"name": "renderLabel",
|
2981
|
+
"privacy": "protected",
|
2982
|
+
"description": "renders the mdc-label-text container that contains the label and labelInfoToggleTip.",
|
2983
|
+
"return": {
|
2984
|
+
"type": {
|
2985
|
+
"text": ""
|
2986
|
+
}
|
2987
|
+
}
|
2988
|
+
},
|
2989
|
+
{
|
2990
|
+
"kind": "method",
|
2991
|
+
"name": "renderHelperText",
|
2992
|
+
"privacy": "protected",
|
2993
|
+
"description": "renders the mdc-help-text container that contains the helpertext icon and helpertext.",
|
2994
|
+
"return": {
|
2995
|
+
"type": {
|
2996
|
+
"text": ""
|
2997
|
+
}
|
2998
|
+
}
|
2999
|
+
},
|
3000
|
+
{
|
3001
|
+
"kind": "field",
|
3002
|
+
"name": "disabled",
|
3003
|
+
"type": {
|
3004
|
+
"text": "boolean"
|
3005
|
+
},
|
3006
|
+
"default": "false",
|
3007
|
+
"description": "Indicates whether the component is disabled.\nWhen the component is disabled for user interaction; it is not focusable or clickable.",
|
3008
|
+
"attribute": "disabled",
|
3009
|
+
"reflects": true,
|
3010
|
+
"inheritedFrom": {
|
3011
|
+
"name": "DisabledMixin",
|
3012
|
+
"module": "utils/mixins/DisabledMixin.js"
|
3013
|
+
}
|
3014
|
+
}
|
3015
|
+
],
|
3016
|
+
"attributes": [
|
3017
|
+
{
|
3018
|
+
"name": "label",
|
2788
3019
|
"type": {
|
2789
|
-
"text": "
|
3020
|
+
"text": "string | undefined"
|
2790
3021
|
},
|
2791
|
-
"description": "
|
2792
|
-
"
|
2793
|
-
"fieldName": "orientation"
|
3022
|
+
"description": "The label of the input field. It is linked to the input field using the `for` attribute.",
|
3023
|
+
"fieldName": "label"
|
2794
3024
|
},
|
2795
3025
|
{
|
2796
|
-
"name": "
|
3026
|
+
"name": "required-label",
|
2797
3027
|
"type": {
|
2798
|
-
"text": "
|
3028
|
+
"text": "string | undefined"
|
2799
3029
|
},
|
2800
|
-
"description": "
|
2801
|
-
"
|
2802
|
-
"fieldName": "variant"
|
3030
|
+
"description": "The required label of the input field.\nWhen an appropriate string value is set,\nthe input field is marked as required and the label is appended with this text.",
|
3031
|
+
"fieldName": "requiredLabel"
|
2803
3032
|
},
|
2804
3033
|
{
|
2805
|
-
"name": "
|
3034
|
+
"name": "id",
|
3035
|
+
"default": "`mdc-input-${uuidv4()}`",
|
3036
|
+
"description": "The unique id of the input field. It is used to link the input field with the label.",
|
3037
|
+
"fieldName": "id"
|
3038
|
+
},
|
3039
|
+
{
|
3040
|
+
"name": "help-text-type",
|
2806
3041
|
"type": {
|
2807
|
-
"text": "
|
3042
|
+
"text": "ValidationType"
|
2808
3043
|
},
|
2809
|
-
"description": "
|
2810
|
-
"
|
2811
|
-
"fieldName": "arrowDirection"
|
3044
|
+
"description": "The type of help text. It can be 'default', 'error', 'warning', 'success', 'priority'.",
|
3045
|
+
"fieldName": "helpTextType"
|
2812
3046
|
},
|
2813
3047
|
{
|
2814
|
-
"name": "
|
3048
|
+
"name": "help-text",
|
2815
3049
|
"type": {
|
2816
|
-
"text": "
|
3050
|
+
"text": "string | undefined"
|
2817
3051
|
},
|
2818
|
-
"description": "
|
2819
|
-
"
|
2820
|
-
|
3052
|
+
"description": "The help text that is displayed below the input field.",
|
3053
|
+
"fieldName": "helpText"
|
3054
|
+
},
|
3055
|
+
{
|
3056
|
+
"name": "disabled",
|
3057
|
+
"type": {
|
3058
|
+
"text": "boolean"
|
3059
|
+
},
|
3060
|
+
"default": "false",
|
3061
|
+
"description": "Indicates whether the component is disabled.\nWhen the component is disabled for user interaction; it is not focusable or clickable.",
|
3062
|
+
"fieldName": "disabled",
|
3063
|
+
"inheritedFrom": {
|
3064
|
+
"name": "DisabledMixin",
|
3065
|
+
"module": "src/utils/mixins/DisabledMixin.ts"
|
3066
|
+
}
|
3067
|
+
}
|
3068
|
+
],
|
3069
|
+
"mixins": [
|
3070
|
+
{
|
3071
|
+
"name": "DisabledMixin",
|
3072
|
+
"module": "/src/utils/mixins/DisabledMixin"
|
2821
3073
|
}
|
2822
3074
|
],
|
2823
3075
|
"superclass": {
|
2824
3076
|
"name": "Component",
|
2825
3077
|
"module": "/src/models"
|
2826
3078
|
},
|
2827
|
-
"tagName": "mdc-
|
2828
|
-
"jsDoc": "/**\n *
|
3079
|
+
"tagName": "mdc-formfieldwrapper",
|
3080
|
+
"jsDoc": "/**\n * formfieldwrapper is a component that contains the label and helper/validation text\n * that can be configured in various ways to suit different use cases (most of the input related components).\n * It is used as an internal component and is not intended to be used directly by consumers.\n *\n * @tagname mdc-formfieldwrapper\n *\n * @slot label-info - slot to add the label info icon\n *\n */",
|
2829
3081
|
"customElement": true
|
2830
3082
|
}
|
2831
3083
|
],
|
@@ -2834,8 +3086,8 @@
|
|
2834
3086
|
"kind": "js",
|
2835
3087
|
"name": "default",
|
2836
3088
|
"declaration": {
|
2837
|
-
"name": "
|
2838
|
-
"module": "components/
|
3089
|
+
"name": "FormfieldWrapper",
|
3090
|
+
"module": "components/formfieldwrapper/formfieldwrapper.component.js"
|
2839
3091
|
}
|
2840
3092
|
}
|
2841
3093
|
]
|
@@ -2926,200 +3178,34 @@
|
|
2926
3178
|
"attribute": "aria-label"
|
2927
3179
|
},
|
2928
3180
|
{
|
2929
|
-
"kind": "field",
|
2930
|
-
"name": "iconProviderContext",
|
2931
|
-
"privacy": "private",
|
2932
|
-
"readonly": true
|
2933
|
-
},
|
2934
|
-
{
|
2935
|
-
"kind": "field",
|
2936
|
-
"name": "abortController",
|
2937
|
-
"type": {
|
2938
|
-
"text": "AbortController"
|
2939
|
-
},
|
2940
|
-
"privacy": "private",
|
2941
|
-
"default": "new AbortController()"
|
2942
|
-
},
|
2943
|
-
{
|
2944
|
-
"kind": "method",
|
2945
|
-
"name": "prepareIconElement",
|
2946
|
-
"privacy": "private",
|
2947
|
-
"parameters": [
|
2948
|
-
{
|
2949
|
-
"name": "iconData",
|
2950
|
-
"type": {
|
2951
|
-
"text": "string"
|
2952
|
-
},
|
2953
|
-
"description": "The icon string to be parsed"
|
2954
|
-
}
|
2955
|
-
],
|
2956
|
-
"description": "Parse the icon string to an html element, set the attributes and\nreturn the icon element",
|
2957
|
-
"return": {
|
2958
|
-
"type": {
|
2959
|
-
"text": ""
|
2960
|
-
}
|
2961
|
-
}
|
2962
|
-
},
|
2963
|
-
{
|
2964
|
-
"kind": "method",
|
2965
|
-
"name": "getIconData",
|
2966
|
-
"privacy": "private",
|
2967
|
-
"description": "Fetches the icon (currently only svg) and sets state and attributes once fetched successfully\n\nThis method uses abortController.signal to cancel the fetch request when the component is disconnected or updated.\nIf the request is aborted after the fetch() call has been fulfilled but before the response body has been read,\nthen attempting to read the response body will reject with an AbortError exception."
|
2968
|
-
},
|
2969
|
-
{
|
2970
|
-
"kind": "method",
|
2971
|
-
"name": "handleIconLoadedSuccess",
|
2972
|
-
"privacy": "private",
|
2973
|
-
"parameters": [
|
2974
|
-
{
|
2975
|
-
"name": "iconHtml",
|
2976
|
-
"type": {
|
2977
|
-
"text": "HTMLElement"
|
2978
|
-
},
|
2979
|
-
"description": "The icon html element which has been fetched from the icon provider."
|
2980
|
-
}
|
2981
|
-
],
|
2982
|
-
"description": "Sets the iconData state to the fetched icon.\nDispatches a 'load' event on the component once the icon has been successfully loaded."
|
2983
|
-
},
|
2984
|
-
{
|
2985
|
-
"kind": "method",
|
2986
|
-
"name": "handleIconLoadedFailure",
|
2987
|
-
"privacy": "private",
|
2988
|
-
"parameters": [
|
2989
|
-
{
|
2990
|
-
"name": "error",
|
2991
|
-
"type": {
|
2992
|
-
"text": "unknown"
|
2993
|
-
}
|
2994
|
-
}
|
2995
|
-
],
|
2996
|
-
"description": "Dispatches an 'error' event on the component when the icon fetching has failed.\nThis event bubbles and is cancelable.\nThe error detail is set to the error object."
|
2997
|
-
},
|
2998
|
-
{
|
2999
|
-
"kind": "method",
|
3000
|
-
"name": "updateSize",
|
3001
|
-
"privacy": "private",
|
3002
|
-
"description": "Updates the size by setting the width and height"
|
3003
|
-
},
|
3004
|
-
{
|
3005
|
-
"kind": "field",
|
3006
|
-
"name": "computedIconSize",
|
3007
|
-
"privacy": "private",
|
3008
|
-
"readonly": true
|
3009
|
-
}
|
3010
|
-
],
|
3011
|
-
"attributes": [
|
3012
|
-
{
|
3013
|
-
"name": "name",
|
3014
|
-
"type": {
|
3015
|
-
"text": "IconNames | undefined"
|
3016
|
-
},
|
3017
|
-
"description": "Name of the icon (= filename)",
|
3018
|
-
"fieldName": "name"
|
3019
|
-
},
|
3020
|
-
{
|
3021
|
-
"name": "size",
|
3022
|
-
"type": {
|
3023
|
-
"text": "number | undefined"
|
3024
|
-
},
|
3025
|
-
"description": "Size of the icon (works in combination with length unit)",
|
3026
|
-
"fieldName": "size"
|
3027
|
-
},
|
3028
|
-
{
|
3029
|
-
"name": "length-unit",
|
3030
|
-
"type": {
|
3031
|
-
"text": "string | undefined"
|
3032
|
-
},
|
3033
|
-
"description": "Length unit attribute for overriding length-unit from `IconProvider`",
|
3034
|
-
"fieldName": "lengthUnit"
|
3035
|
-
},
|
3036
|
-
{
|
3037
|
-
"name": "aria-label",
|
3038
|
-
"type": {
|
3039
|
-
"text": "string | null"
|
3040
|
-
},
|
3041
|
-
"default": "null",
|
3042
|
-
"description": "Aria-label attribute to be set for accessibility",
|
3043
|
-
"fieldName": "ariaLabel"
|
3044
|
-
}
|
3045
|
-
],
|
3046
|
-
"superclass": {
|
3047
|
-
"name": "Component",
|
3048
|
-
"module": "/src/models"
|
3049
|
-
},
|
3050
|
-
"tagName": "mdc-icon",
|
3051
|
-
"jsDoc": "/**\n * Icon component that dynamically displays SVG icons based on a valid name.\n *\n * This component must be mounted within an `IconProvider` component.\n *\n * The `IconProvider` defines the source URL from which icons are consumed.\n * The `Icon` component accepts a `name` attribute, which corresponds to\n * the file name of the icon to be loaded from the specified URL.\n *\n * Once fetched, the icon will be rendered. If the fetching process is unsuccessful,\n * no icon will be displayed.\n *\n * The `size` attribute allows for dynamic sizing of the icon based on the provided\n * `length-unit` attribute. This unit can either come from the `IconProvider`\n * or can be overridden for each individual icon. For example:\n * if `size = 1` and `length-unit = 'em'`, the dimensions of the icon will be\n * `width: 1em; height: 1em`.\n *\n * Regarding accessibility, there are three types of icons: decorative, informative and informative standalone.\n *\n * ### Decorative Icons\n * - Decorative icons do not convey any essential information to the content of a page.\n * - They should be hidden from screen readers (SR) to prevent confusion for users.\n * - For decorative icons, an `aria-label` is not required, and the `role` will be set to null.\n *\n * ### Informative Icons\n * - Informative icons convey important information that is not adequately represented\n * by surrounding text or components.\n * - They provide valuable context and must be announced by assistive technologies.\n * - For informative icons, an `aria-label` is required, and the `role` will be set to \"img\" automatically.\n * - If an `aria-label` is provided, the role will be set to 'img'; if it is absent,\n * the role will be unset.\n *\n * ### Informative Standalone Icons\n * - If an icon is informative (as mentioned above) and does not belong to a button (=standalone), it must\n * have a Tooltip that describes what it means.\n * - For informative standalone icons, an `aria-label` & `tabindex=\"0\"` is required,\n * and the `role` will be set to \"img\" automatically.\n * - **Only use this when a Icon is standalone and is not part of a button or other interactive elements.**\n *\n * @tagname mdc-icon\n *\n * @cssproperty --mdc-icon-fill-color - Allows customization of the default fill color.\n * @cssproperty --mdc-icon-size - Allows customization of the icon size.\n * @cssproperty --mdc-icon-border-radius - Allows customization of the icon border radius.\n */",
|
3052
|
-
"customElement": true
|
3053
|
-
}
|
3054
|
-
],
|
3055
|
-
"exports": [
|
3056
|
-
{
|
3057
|
-
"kind": "js",
|
3058
|
-
"name": "default",
|
3059
|
-
"declaration": {
|
3060
|
-
"name": "Icon",
|
3061
|
-
"module": "components/icon/icon.component.js"
|
3062
|
-
}
|
3063
|
-
}
|
3064
|
-
]
|
3065
|
-
},
|
3066
|
-
{
|
3067
|
-
"kind": "javascript-module",
|
3068
|
-
"path": "components/formfieldwrapper/formfieldwrapper.component.js",
|
3069
|
-
"declarations": [
|
3070
|
-
{
|
3071
|
-
"kind": "class",
|
3072
|
-
"description": "formfieldwrapper is a component that contains the label and helper/validation text\n that can be configured in various ways to suit different use cases (most of the input related components).\nIt is used as an internal component and is not intended to be used directly by consumers.",
|
3073
|
-
"name": "FormfieldWrapper",
|
3074
|
-
"slots": [
|
3075
|
-
{
|
3076
|
-
"description": "slot to add the label info icon",
|
3077
|
-
"name": "label-info"
|
3078
|
-
}
|
3079
|
-
],
|
3080
|
-
"members": [
|
3081
|
-
{
|
3082
|
-
"kind": "field",
|
3083
|
-
"name": "label",
|
3084
|
-
"type": {
|
3085
|
-
"text": "string | undefined"
|
3086
|
-
},
|
3087
|
-
"description": "The label of the input field. It is linked to the input field using the `for` attribute.",
|
3088
|
-
"attribute": "label",
|
3089
|
-
"reflects": true
|
3090
|
-
},
|
3091
|
-
{
|
3092
|
-
"kind": "field",
|
3093
|
-
"name": "id",
|
3094
|
-
"default": "`mdc-input-${uuidv4()}`",
|
3095
|
-
"description": "The unique id of the input field. It is used to link the input field with the label.",
|
3096
|
-
"attribute": "id"
|
3097
|
-
},
|
3098
|
-
{
|
3099
|
-
"kind": "field",
|
3100
|
-
"name": "helpTextType",
|
3101
|
-
"type": {
|
3102
|
-
"text": "ValidationType"
|
3103
|
-
},
|
3104
|
-
"description": "The type of help text. It can be 'default', 'error', 'warning', 'success', 'priority'.",
|
3105
|
-
"attribute": "help-text-type",
|
3106
|
-
"reflects": true
|
3181
|
+
"kind": "field",
|
3182
|
+
"name": "iconProviderContext",
|
3183
|
+
"privacy": "private",
|
3184
|
+
"readonly": true
|
3107
3185
|
},
|
3108
3186
|
{
|
3109
3187
|
"kind": "field",
|
3110
|
-
"name": "
|
3188
|
+
"name": "abortController",
|
3111
3189
|
"type": {
|
3112
|
-
"text": "
|
3190
|
+
"text": "AbortController"
|
3113
3191
|
},
|
3114
|
-
"
|
3115
|
-
"
|
3116
|
-
"reflects": true
|
3192
|
+
"privacy": "private",
|
3193
|
+
"default": "new AbortController()"
|
3117
3194
|
},
|
3118
3195
|
{
|
3119
3196
|
"kind": "method",
|
3120
|
-
"name": "
|
3121
|
-
"privacy": "
|
3122
|
-
"
|
3197
|
+
"name": "prepareIconElement",
|
3198
|
+
"privacy": "private",
|
3199
|
+
"parameters": [
|
3200
|
+
{
|
3201
|
+
"name": "iconData",
|
3202
|
+
"type": {
|
3203
|
+
"text": "string"
|
3204
|
+
},
|
3205
|
+
"description": "The icon string to be parsed"
|
3206
|
+
}
|
3207
|
+
],
|
3208
|
+
"description": "Parse the icon string to an html element, set the attributes and\nreturn the icon element",
|
3123
3209
|
"return": {
|
3124
3210
|
"type": {
|
3125
3211
|
"text": ""
|
@@ -3128,121 +3214,93 @@
|
|
3128
3214
|
},
|
3129
3215
|
{
|
3130
3216
|
"kind": "method",
|
3131
|
-
"name": "
|
3132
|
-
"privacy": "
|
3133
|
-
"description": "
|
3134
|
-
"return": {
|
3135
|
-
"type": {
|
3136
|
-
"text": ""
|
3137
|
-
}
|
3138
|
-
}
|
3217
|
+
"name": "getIconData",
|
3218
|
+
"privacy": "private",
|
3219
|
+
"description": "Fetches the icon (currently only svg) and sets state and attributes once fetched successfully\n\nThis method uses abortController.signal to cancel the fetch request when the component is disconnected or updated.\nIf the request is aborted after the fetch() call has been fulfilled but before the response body has been read,\nthen attempting to read the response body will reject with an AbortError exception."
|
3139
3220
|
},
|
3140
3221
|
{
|
3141
3222
|
"kind": "method",
|
3142
|
-
"name": "
|
3143
|
-
"privacy": "
|
3144
|
-
"
|
3145
|
-
|
3146
|
-
|
3147
|
-
"
|
3223
|
+
"name": "handleIconLoadedSuccess",
|
3224
|
+
"privacy": "private",
|
3225
|
+
"parameters": [
|
3226
|
+
{
|
3227
|
+
"name": "iconHtml",
|
3228
|
+
"type": {
|
3229
|
+
"text": "HTMLElement"
|
3230
|
+
},
|
3231
|
+
"description": "The icon html element which has been fetched from the icon provider."
|
3148
3232
|
}
|
3149
|
-
|
3233
|
+
],
|
3234
|
+
"description": "Sets the iconData state to the fetched icon.\nDispatches a 'load' event on the component once the icon has been successfully loaded."
|
3150
3235
|
},
|
3151
3236
|
{
|
3152
3237
|
"kind": "method",
|
3153
|
-
"name": "
|
3154
|
-
"privacy": "
|
3155
|
-
"
|
3156
|
-
|
3157
|
-
|
3158
|
-
"
|
3238
|
+
"name": "handleIconLoadedFailure",
|
3239
|
+
"privacy": "private",
|
3240
|
+
"parameters": [
|
3241
|
+
{
|
3242
|
+
"name": "error",
|
3243
|
+
"type": {
|
3244
|
+
"text": "unknown"
|
3245
|
+
}
|
3159
3246
|
}
|
3160
|
-
|
3247
|
+
],
|
3248
|
+
"description": "Dispatches an 'error' event on the component when the icon fetching has failed.\nThis event bubbles and is cancelable.\nThe error detail is set to the error object."
|
3161
3249
|
},
|
3162
3250
|
{
|
3163
3251
|
"kind": "method",
|
3164
|
-
"name": "
|
3165
|
-
"privacy": "
|
3166
|
-
"description": "
|
3167
|
-
"return": {
|
3168
|
-
"type": {
|
3169
|
-
"text": ""
|
3170
|
-
}
|
3171
|
-
}
|
3252
|
+
"name": "updateSize",
|
3253
|
+
"privacy": "private",
|
3254
|
+
"description": "Updates the size by setting the width and height"
|
3172
3255
|
},
|
3173
3256
|
{
|
3174
3257
|
"kind": "field",
|
3175
|
-
"name": "
|
3176
|
-
"
|
3177
|
-
|
3178
|
-
},
|
3179
|
-
"default": "false",
|
3180
|
-
"description": "Indicates whether the component is disabled.\nWhen the component is disabled for user interaction; it is not focusable or clickable.",
|
3181
|
-
"attribute": "disabled",
|
3182
|
-
"reflects": true,
|
3183
|
-
"inheritedFrom": {
|
3184
|
-
"name": "DisabledMixin",
|
3185
|
-
"module": "utils/mixins/DisabledMixin.js"
|
3186
|
-
}
|
3258
|
+
"name": "computedIconSize",
|
3259
|
+
"privacy": "private",
|
3260
|
+
"readonly": true
|
3187
3261
|
}
|
3188
3262
|
],
|
3189
3263
|
"attributes": [
|
3190
3264
|
{
|
3191
|
-
"name": "
|
3265
|
+
"name": "name",
|
3192
3266
|
"type": {
|
3193
|
-
"text": "
|
3267
|
+
"text": "IconNames | undefined"
|
3194
3268
|
},
|
3195
|
-
"description": "
|
3196
|
-
"fieldName": "
|
3197
|
-
},
|
3198
|
-
{
|
3199
|
-
"name": "id",
|
3200
|
-
"default": "`mdc-input-${uuidv4()}`",
|
3201
|
-
"description": "The unique id of the input field. It is used to link the input field with the label.",
|
3202
|
-
"fieldName": "id"
|
3269
|
+
"description": "Name of the icon (= filename)",
|
3270
|
+
"fieldName": "name"
|
3203
3271
|
},
|
3204
3272
|
{
|
3205
|
-
"name": "
|
3273
|
+
"name": "size",
|
3206
3274
|
"type": {
|
3207
|
-
"text": "
|
3275
|
+
"text": "number | undefined"
|
3208
3276
|
},
|
3209
|
-
"description": "
|
3210
|
-
"fieldName": "
|
3277
|
+
"description": "Size of the icon (works in combination with length unit)",
|
3278
|
+
"fieldName": "size"
|
3211
3279
|
},
|
3212
3280
|
{
|
3213
|
-
"name": "
|
3281
|
+
"name": "length-unit",
|
3214
3282
|
"type": {
|
3215
3283
|
"text": "string | undefined"
|
3216
3284
|
},
|
3217
|
-
"description": "
|
3218
|
-
"fieldName": "
|
3285
|
+
"description": "Length unit attribute for overriding length-unit from `IconProvider`",
|
3286
|
+
"fieldName": "lengthUnit"
|
3219
3287
|
},
|
3220
3288
|
{
|
3221
|
-
"name": "
|
3289
|
+
"name": "aria-label",
|
3222
3290
|
"type": {
|
3223
|
-
"text": "
|
3291
|
+
"text": "string | null"
|
3224
3292
|
},
|
3225
|
-
"default": "
|
3226
|
-
"description": "
|
3227
|
-
"fieldName": "
|
3228
|
-
"inheritedFrom": {
|
3229
|
-
"name": "DisabledMixin",
|
3230
|
-
"module": "src/utils/mixins/DisabledMixin.ts"
|
3231
|
-
}
|
3232
|
-
}
|
3233
|
-
],
|
3234
|
-
"mixins": [
|
3235
|
-
{
|
3236
|
-
"name": "DisabledMixin",
|
3237
|
-
"module": "/src/utils/mixins/DisabledMixin"
|
3293
|
+
"default": "null",
|
3294
|
+
"description": "Aria-label attribute to be set for accessibility",
|
3295
|
+
"fieldName": "ariaLabel"
|
3238
3296
|
}
|
3239
3297
|
],
|
3240
3298
|
"superclass": {
|
3241
3299
|
"name": "Component",
|
3242
3300
|
"module": "/src/models"
|
3243
3301
|
},
|
3244
|
-
"tagName": "mdc-
|
3245
|
-
"jsDoc": "/**\n *
|
3302
|
+
"tagName": "mdc-icon",
|
3303
|
+
"jsDoc": "/**\n * Icon component that dynamically displays SVG icons based on a valid name.\n *\n * This component must be mounted within an `IconProvider` component.\n *\n * The `IconProvider` defines the source URL from which icons are consumed.\n * The `Icon` component accepts a `name` attribute, which corresponds to\n * the file name of the icon to be loaded from the specified URL.\n *\n * Once fetched, the icon will be rendered. If the fetching process is unsuccessful,\n * no icon will be displayed.\n *\n * The `size` attribute allows for dynamic sizing of the icon based on the provided\n * `length-unit` attribute. This unit can either come from the `IconProvider`\n * or can be overridden for each individual icon. For example:\n * if `size = 1` and `length-unit = 'em'`, the dimensions of the icon will be\n * `width: 1em; height: 1em`.\n *\n * Regarding accessibility, there are three types of icons: decorative, informative and informative standalone.\n *\n * ### Decorative Icons\n * - Decorative icons do not convey any essential information to the content of a page.\n * - They should be hidden from screen readers (SR) to prevent confusion for users.\n * - For decorative icons, an `aria-label` is not required, and the `role` will be set to null.\n *\n * ### Informative Icons\n * - Informative icons convey important information that is not adequately represented\n * by surrounding text or components.\n * - They provide valuable context and must be announced by assistive technologies.\n * - For informative icons, an `aria-label` is required, and the `role` will be set to \"img\" automatically.\n * - If an `aria-label` is provided, the role will be set to 'img'; if it is absent,\n * the role will be unset.\n *\n * ### Informative Standalone Icons\n * - If an icon is informative (as mentioned above) and does not belong to a button (=standalone), it must\n * have a Tooltip that describes what it means.\n * - For informative standalone icons, an `aria-label` & `tabindex=\"0\"` is required,\n * and the `role` will be set to \"img\" automatically.\n * - **Only use this when a Icon is standalone and is not part of a button or other interactive elements.**\n *\n * @tagname mdc-icon\n *\n * @cssproperty --mdc-icon-fill-color - Allows customization of the default fill color.\n * @cssproperty --mdc-icon-size - Allows customization of the icon size.\n * @cssproperty --mdc-icon-border-radius - Allows customization of the icon border radius.\n */",
|
3246
3304
|
"customElement": true
|
3247
3305
|
}
|
3248
3306
|
],
|
@@ -3251,8 +3309,8 @@
|
|
3251
3309
|
"kind": "js",
|
3252
3310
|
"name": "default",
|
3253
3311
|
"declaration": {
|
3254
|
-
"name": "
|
3255
|
-
"module": "components/
|
3312
|
+
"name": "Icon",
|
3313
|
+
"module": "components/icon/icon.component.js"
|
3256
3314
|
}
|
3257
3315
|
}
|
3258
3316
|
]
|
@@ -3500,16 +3558,6 @@
|
|
3500
3558
|
"description": "The placeholder text that is displayed when the input field is empty.",
|
3501
3559
|
"attribute": "placeholder"
|
3502
3560
|
},
|
3503
|
-
{
|
3504
|
-
"kind": "field",
|
3505
|
-
"name": "required",
|
3506
|
-
"type": {
|
3507
|
-
"text": "boolean"
|
3508
|
-
},
|
3509
|
-
"default": "false",
|
3510
|
-
"description": "required attribute of the input field.\nIf true, the consumer should indicate it on the label that the input field is required.",
|
3511
|
-
"attribute": "required"
|
3512
|
-
},
|
3513
3561
|
{
|
3514
3562
|
"kind": "field",
|
3515
3563
|
"name": "readonly",
|
@@ -3837,6 +3885,20 @@
|
|
3837
3885
|
"module": "components/formfieldwrapper/formfieldwrapper.component.js"
|
3838
3886
|
}
|
3839
3887
|
},
|
3888
|
+
{
|
3889
|
+
"kind": "field",
|
3890
|
+
"name": "requiredLabel",
|
3891
|
+
"type": {
|
3892
|
+
"text": "string | undefined"
|
3893
|
+
},
|
3894
|
+
"description": "The required label of the input field.\nWhen an appropriate string value is set,\nthe input field is marked as required and the label is appended with this text.",
|
3895
|
+
"attribute": "required-label",
|
3896
|
+
"reflects": true,
|
3897
|
+
"inheritedFrom": {
|
3898
|
+
"name": "FormfieldWrapper",
|
3899
|
+
"module": "components/formfieldwrapper/formfieldwrapper.component.js"
|
3900
|
+
}
|
3901
|
+
},
|
3840
3902
|
{
|
3841
3903
|
"kind": "field",
|
3842
3904
|
"name": "id",
|
@@ -3891,6 +3953,15 @@
|
|
3891
3953
|
"module": "components/formfieldwrapper/formfieldwrapper.component.js"
|
3892
3954
|
}
|
3893
3955
|
},
|
3956
|
+
{
|
3957
|
+
"kind": "method",
|
3958
|
+
"name": "renderRequiredLabel",
|
3959
|
+
"privacy": "protected",
|
3960
|
+
"inheritedFrom": {
|
3961
|
+
"name": "FormfieldWrapper",
|
3962
|
+
"module": "components/formfieldwrapper/formfieldwrapper.component.js"
|
3963
|
+
}
|
3964
|
+
},
|
3894
3965
|
{
|
3895
3966
|
"kind": "method",
|
3896
3967
|
"name": "renderHelpTextIcon",
|
@@ -3969,15 +4040,6 @@
|
|
3969
4040
|
"description": "The placeholder text that is displayed when the input field is empty.",
|
3970
4041
|
"fieldName": "placeholder"
|
3971
4042
|
},
|
3972
|
-
{
|
3973
|
-
"name": "required",
|
3974
|
-
"type": {
|
3975
|
-
"text": "boolean"
|
3976
|
-
},
|
3977
|
-
"default": "false",
|
3978
|
-
"description": "required attribute of the input field.\nIf true, the consumer should indicate it on the label that the input field is required.",
|
3979
|
-
"fieldName": "required"
|
3980
|
-
},
|
3981
4043
|
{
|
3982
4044
|
"name": "readonly",
|
3983
4045
|
"type": {
|
@@ -4161,6 +4223,18 @@
|
|
4161
4223
|
"module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
|
4162
4224
|
}
|
4163
4225
|
},
|
4226
|
+
{
|
4227
|
+
"name": "required-label",
|
4228
|
+
"type": {
|
4229
|
+
"text": "string | undefined"
|
4230
|
+
},
|
4231
|
+
"description": "The required label of the input field.\nWhen an appropriate string value is set,\nthe input field is marked as required and the label is appended with this text.",
|
4232
|
+
"fieldName": "requiredLabel",
|
4233
|
+
"inheritedFrom": {
|
4234
|
+
"name": "FormfieldWrapper",
|
4235
|
+
"module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
|
4236
|
+
}
|
4237
|
+
},
|
4164
4238
|
{
|
4165
4239
|
"name": "id",
|
4166
4240
|
"default": "`mdc-input-${uuidv4()}`",
|
@@ -5110,6 +5184,20 @@
|
|
5110
5184
|
"module": "components/formfieldwrapper/formfieldwrapper.component.js"
|
5111
5185
|
}
|
5112
5186
|
},
|
5187
|
+
{
|
5188
|
+
"kind": "field",
|
5189
|
+
"name": "requiredLabel",
|
5190
|
+
"type": {
|
5191
|
+
"text": "string | undefined"
|
5192
|
+
},
|
5193
|
+
"description": "The required label of the input field.\nWhen an appropriate string value is set,\nthe input field is marked as required and the label is appended with this text.",
|
5194
|
+
"attribute": "required-label",
|
5195
|
+
"reflects": true,
|
5196
|
+
"inheritedFrom": {
|
5197
|
+
"name": "FormfieldWrapper",
|
5198
|
+
"module": "components/formfieldwrapper/formfieldwrapper.component.js"
|
5199
|
+
}
|
5200
|
+
},
|
5113
5201
|
{
|
5114
5202
|
"kind": "field",
|
5115
5203
|
"name": "id",
|
@@ -5164,6 +5252,15 @@
|
|
5164
5252
|
"module": "components/formfieldwrapper/formfieldwrapper.component.js"
|
5165
5253
|
}
|
5166
5254
|
},
|
5255
|
+
{
|
5256
|
+
"kind": "method",
|
5257
|
+
"name": "renderRequiredLabel",
|
5258
|
+
"privacy": "protected",
|
5259
|
+
"inheritedFrom": {
|
5260
|
+
"name": "FormfieldWrapper",
|
5261
|
+
"module": "components/formfieldwrapper/formfieldwrapper.component.js"
|
5262
|
+
}
|
5263
|
+
},
|
5167
5264
|
{
|
5168
5265
|
"kind": "method",
|
5169
5266
|
"name": "renderHelpTextIcon",
|
@@ -5315,6 +5412,18 @@
|
|
5315
5412
|
"module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
|
5316
5413
|
}
|
5317
5414
|
},
|
5415
|
+
{
|
5416
|
+
"name": "required-label",
|
5417
|
+
"type": {
|
5418
|
+
"text": "string | undefined"
|
5419
|
+
},
|
5420
|
+
"description": "The required label of the input field.\nWhen an appropriate string value is set,\nthe input field is marked as required and the label is appended with this text.",
|
5421
|
+
"fieldName": "requiredLabel",
|
5422
|
+
"inheritedFrom": {
|
5423
|
+
"name": "FormfieldWrapper",
|
5424
|
+
"module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
|
5425
|
+
}
|
5426
|
+
},
|
5318
5427
|
{
|
5319
5428
|
"name": "id",
|
5320
5429
|
"default": "`mdc-input-${uuidv4()}`",
|
@@ -6461,6 +6570,20 @@
|
|
6461
6570
|
"module": "components/formfieldwrapper/formfieldwrapper.component.js"
|
6462
6571
|
}
|
6463
6572
|
},
|
6573
|
+
{
|
6574
|
+
"kind": "field",
|
6575
|
+
"name": "requiredLabel",
|
6576
|
+
"type": {
|
6577
|
+
"text": "string | undefined"
|
6578
|
+
},
|
6579
|
+
"description": "The required label of the input field.\nWhen an appropriate string value is set,\nthe input field is marked as required and the label is appended with this text.",
|
6580
|
+
"attribute": "required-label",
|
6581
|
+
"reflects": true,
|
6582
|
+
"inheritedFrom": {
|
6583
|
+
"name": "FormfieldWrapper",
|
6584
|
+
"module": "components/formfieldwrapper/formfieldwrapper.component.js"
|
6585
|
+
}
|
6586
|
+
},
|
6464
6587
|
{
|
6465
6588
|
"kind": "field",
|
6466
6589
|
"name": "id",
|
@@ -6501,6 +6624,15 @@
|
|
6501
6624
|
"module": "components/formfieldwrapper/formfieldwrapper.component.js"
|
6502
6625
|
}
|
6503
6626
|
},
|
6627
|
+
{
|
6628
|
+
"kind": "method",
|
6629
|
+
"name": "renderRequiredLabel",
|
6630
|
+
"privacy": "protected",
|
6631
|
+
"inheritedFrom": {
|
6632
|
+
"name": "FormfieldWrapper",
|
6633
|
+
"module": "components/formfieldwrapper/formfieldwrapper.component.js"
|
6634
|
+
}
|
6635
|
+
},
|
6504
6636
|
{
|
6505
6637
|
"kind": "method",
|
6506
6638
|
"name": "renderHelpTextIcon",
|
@@ -6652,6 +6784,18 @@
|
|
6652
6784
|
"module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
|
6653
6785
|
}
|
6654
6786
|
},
|
6787
|
+
{
|
6788
|
+
"name": "required-label",
|
6789
|
+
"type": {
|
6790
|
+
"text": "string | undefined"
|
6791
|
+
},
|
6792
|
+
"description": "The required label of the input field.\nWhen an appropriate string value is set,\nthe input field is marked as required and the label is appended with this text.",
|
6793
|
+
"fieldName": "requiredLabel",
|
6794
|
+
"inheritedFrom": {
|
6795
|
+
"name": "FormfieldWrapper",
|
6796
|
+
"module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
|
6797
|
+
}
|
6798
|
+
},
|
6655
6799
|
{
|
6656
6800
|
"name": "id",
|
6657
6801
|
"default": "`mdc-input-${uuidv4()}`",
|