@adobe/spectrum-design-data 0.0.0-size-token-taxonomy-20260929225107

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (203) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +75 -0
  3. package/components/accordion.json +185 -0
  4. package/components/action-bar.json +89 -0
  5. package/components/action-button.json +167 -0
  6. package/components/action-group.json +190 -0
  7. package/components/alert-banner.json +148 -0
  8. package/components/alert-dialog.json +124 -0
  9. package/components/avatar-group.json +82 -0
  10. package/components/avatar.json +162 -0
  11. package/components/badge.json +227 -0
  12. package/components/bar-panel.json +14 -0
  13. package/components/body.json +54 -0
  14. package/components/bottom-navigation-android.json +72 -0
  15. package/components/breadcrumbs.json +213 -0
  16. package/components/button-group.json +122 -0
  17. package/components/button.json +239 -0
  18. package/components/calendar.json +196 -0
  19. package/components/card-horizontal.json +14 -0
  20. package/components/card.json +22 -0
  21. package/components/cards.json +117 -0
  22. package/components/checkbox-group.json +128 -0
  23. package/components/checkbox.json +171 -0
  24. package/components/close-button.json +116 -0
  25. package/components/coach-indicator.json +109 -0
  26. package/components/coach-mark.json +151 -0
  27. package/components/code.json +44 -0
  28. package/components/collection-card.json +13 -0
  29. package/components/color-area.json +150 -0
  30. package/components/color-control.json +14 -0
  31. package/components/color-handle.json +79 -0
  32. package/components/color-loupe.json +49 -0
  33. package/components/color-slider.json +189 -0
  34. package/components/color-wheel.json +137 -0
  35. package/components/combo-box.json +319 -0
  36. package/components/contextual-help.json +186 -0
  37. package/components/date-field.json +13 -0
  38. package/components/date-picker.json +297 -0
  39. package/components/detail.json +53 -0
  40. package/components/divider.json +62 -0
  41. package/components/double-calendar.json +13 -0
  42. package/components/drop-zone.json +102 -0
  43. package/components/field-label.json +125 -0
  44. package/components/field.json +13 -0
  45. package/components/floating-action-button.json +13 -0
  46. package/components/form-item.json +13 -0
  47. package/components/heading.json +68 -0
  48. package/components/help-text.json +117 -0
  49. package/components/illustrated-message.json +159 -0
  50. package/components/in-field-button.json +14 -0
  51. package/components/in-field-progress-button.json +88 -0
  52. package/components/in-field-progress-circle.json +62 -0
  53. package/components/in-line-alert.json +109 -0
  54. package/components/link.json +127 -0
  55. package/components/list-view.json +233 -0
  56. package/components/menu.json +310 -0
  57. package/components/meter.json +127 -0
  58. package/components/number-field.json +264 -0
  59. package/components/opacity-checkerboard.json +51 -0
  60. package/components/picker.json +287 -0
  61. package/components/popover.json +182 -0
  62. package/components/progress-bar.json +177 -0
  63. package/components/progress-circle.json +108 -0
  64. package/components/radio-button.json +130 -0
  65. package/components/radio-group.json +202 -0
  66. package/components/rating.json +120 -0
  67. package/components/scroll-zoom-bar.json +82 -0
  68. package/components/search-field.json +206 -0
  69. package/components/segmented-control.json +184 -0
  70. package/components/segmented-text-field.json +13 -0
  71. package/components/select-box.json +165 -0
  72. package/components/side-navigation.json +185 -0
  73. package/components/single-calendar.json +13 -0
  74. package/components/slider.json +238 -0
  75. package/components/stack-item.json +23 -0
  76. package/components/standard-dialog.json +155 -0
  77. package/components/standard-panel.json +135 -0
  78. package/components/status-light.json +175 -0
  79. package/components/steplist.json +127 -0
  80. package/components/swatch-group.json +126 -0
  81. package/components/swatch.json +153 -0
  82. package/components/switch.json +156 -0
  83. package/components/table.json +273 -0
  84. package/components/tabs.json +163 -0
  85. package/components/tag-field.json +147 -0
  86. package/components/tag-group.json +111 -0
  87. package/components/tag.json +123 -0
  88. package/components/takeover-dialog.json +129 -0
  89. package/components/text-area.json +299 -0
  90. package/components/text-field.json +263 -0
  91. package/components/thumbnail.json +109 -0
  92. package/components/time-field.json +13 -0
  93. package/components/title.json +53 -0
  94. package/components/toast.json +136 -0
  95. package/components/tooltip.json +171 -0
  96. package/components/tray.json +32 -0
  97. package/components/tree-view.json +270 -0
  98. package/components/triple-calendar.json +13 -0
  99. package/components/user-card.json +14 -0
  100. package/fields/alignment.json +15 -0
  101. package/fields/anatomy.json +15 -0
  102. package/fields/color-scheme.json +16 -0
  103. package/fields/colorFamily.json +16 -0
  104. package/fields/colorRole.json +16 -0
  105. package/fields/component.json +15 -0
  106. package/fields/contrast.json +16 -0
  107. package/fields/density.json +15 -0
  108. package/fields/easing.json +15 -0
  109. package/fields/emphasis.json +16 -0
  110. package/fields/family.json +16 -0
  111. package/fields/from.json +16 -0
  112. package/fields/icon.json +15 -0
  113. package/fields/motionRole.json +15 -0
  114. package/fields/object.json +15 -0
  115. package/fields/orientation.json +15 -0
  116. package/fields/position.json +15 -0
  117. package/fields/property.json +15 -0
  118. package/fields/qualifier.json +15 -0
  119. package/fields/referenceScaleIndex.json +16 -0
  120. package/fields/role.json +15 -0
  121. package/fields/scale.json +16 -0
  122. package/fields/scaleIndex.json +16 -0
  123. package/fields/script.json +16 -0
  124. package/fields/shape.json +15 -0
  125. package/fields/size.json +15 -0
  126. package/fields/state.json +15 -0
  127. package/fields/structure.json +16 -0
  128. package/fields/style.json +15 -0
  129. package/fields/substructure.json +15 -0
  130. package/fields/to.json +16 -0
  131. package/fields/variant.json +15 -0
  132. package/fields/weight.json +15 -0
  133. package/guidelines/app-frame-content-area.json +81 -0
  134. package/guidelines/app-frame-creating-bluelines.json +58 -0
  135. package/guidelines/app-frame-header.json +72 -0
  136. package/guidelines/app-frame-overview.json +167 -0
  137. package/guidelines/app-frame-side-navigation.json +138 -0
  138. package/guidelines/attention-hierarchy.json +42 -0
  139. package/guidelines/background-layers.json +38 -0
  140. package/guidelines/brand.json +50 -0
  141. package/guidelines/colors.json +62 -0
  142. package/guidelines/containers.json +62 -0
  143. package/guidelines/developer-overview.json +35 -0
  144. package/guidelines/faqs.json +35 -0
  145. package/guidelines/fonts.json +58 -0
  146. package/guidelines/grays.json +66 -0
  147. package/guidelines/icon-fundamentals.json +45 -0
  148. package/guidelines/illustrations.json +111 -0
  149. package/guidelines/introduction.json +31 -0
  150. package/guidelines/manifest.json +204 -0
  151. package/guidelines/motion.json +41 -0
  152. package/guidelines/object-styles.json +102 -0
  153. package/guidelines/principles.json +30 -0
  154. package/guidelines/resources.json +59 -0
  155. package/guidelines/spacing.json +25 -0
  156. package/guidelines/states.json +34 -0
  157. package/guidelines/typography-fundamentals.json +142 -0
  158. package/guidelines/using-icons.json +107 -0
  159. package/mode-sets/color-scheme.json +8 -0
  160. package/mode-sets/contrast.json +8 -0
  161. package/mode-sets/scale.json +8 -0
  162. package/package.json +68 -0
  163. package/registry/alignments.json +22 -0
  164. package/registry/anatomy-terms.json +860 -0
  165. package/registry/categories.json +55 -0
  166. package/registry/color-families.json +177 -0
  167. package/registry/color-roles.json +47 -0
  168. package/registry/components.json +472 -0
  169. package/registry/densities.json +17 -0
  170. package/registry/easing-curves.json +42 -0
  171. package/registry/glossary.json +181 -0
  172. package/registry/icon-terms.json +104 -0
  173. package/registry/motion-roles.json +32 -0
  174. package/registry/navigation-terms.json +241 -0
  175. package/registry/orientations.json +17 -0
  176. package/registry/platform-extensions/web-components-states.json +58 -0
  177. package/registry/platforms.json +37 -0
  178. package/registry/positions.json +70 -0
  179. package/registry/property-terms.json +352 -0
  180. package/registry/qualifiers.json +47 -0
  181. package/registry/roles.json +17 -0
  182. package/registry/scale-values.json +133 -0
  183. package/registry/scripts.json +12 -0
  184. package/registry/shapes.json +27 -0
  185. package/registry/sizes.json +78 -0
  186. package/registry/states.json +187 -0
  187. package/registry/structures.json +67 -0
  188. package/registry/substructures.json +12 -0
  189. package/registry/token-objects.json +32 -0
  190. package/registry/token-terminology.json +925 -0
  191. package/registry/typography-emphasis.json +32 -0
  192. package/registry/typography-families.json +22 -0
  193. package/registry/typography-styles.json +22 -0
  194. package/registry/typography-weights.json +37 -0
  195. package/registry/variants.json +366 -0
  196. package/tokens/color-aliases.tokens.json +5579 -0
  197. package/tokens/color-component.tokens.json +1 -0
  198. package/tokens/color-palette.tokens.json +13458 -0
  199. package/tokens/icons.tokens.json +2777 -0
  200. package/tokens/layout-component.tokens.json +3121 -0
  201. package/tokens/layout.tokens.json +8741 -0
  202. package/tokens/semantic-color-palette.tokens.json +1246 -0
  203. package/tokens/typography.tokens.json +1447 -0
@@ -0,0 +1,297 @@
1
+ {
2
+ "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component.schema.json",
3
+ "$id": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/components/date-picker.json",
4
+ "specVersion": "1.0.0-draft",
5
+ "name": "date-picker",
6
+ "displayName": "Date picker",
7
+ "description": "A date picker lets users enter a single date or a date range. It includes a calendar popover and a field.",
8
+ "meta": {
9
+ "category": "inputs",
10
+ "documentationUrl": "https://spectrum.adobe.com/page/date-picker/"
11
+ },
12
+ "documentBlocks": [
13
+ {
14
+ "type": "purpose",
15
+ "content": "A date picker lets users enter a single date or a date range. It includes a calendar popover and a field."
16
+ },
17
+ {
18
+ "type": "guideline",
19
+ "content": "Date pickers allow selection of a single date or a date range. They include a calendar within a popover, with optional manual entry. Date range variants support selecting a start and end date in one field."
20
+ },
21
+ {
22
+ "type": "guideline",
23
+ "content": "Calendar popover displays a grid of days spanning one, two, or three months, enabling users to select a single date or a range."
24
+ },
25
+ {
26
+ "type": "guideline",
27
+ "content": "Date field allows users to enter and edit date values. Users can edit each part of a date value, such as the day, month, and year, by interacting with individual segments. A date field includes a label, segments for each value of the date, and an in-field button to allow the user to open the calendar popover."
28
+ },
29
+ {
30
+ "type": "guideline",
31
+ "content": "The range of days the user has selected (a start date and an end date)."
32
+ },
33
+ {
34
+ "type": "guideline",
35
+ "content": "The selected date allows a user to see which date they have selected within the calendar popover."
36
+ },
37
+ {
38
+ "type": "guideline",
39
+ "content": "A single date picker only displays a single date within the date field as well as a single month within the calendar popover."
40
+ },
41
+ {
42
+ "type": "guideline",
43
+ "content": "A double date picker displays a date range within the date field as well as two consecutive months within the calendar popover."
44
+ },
45
+ {
46
+ "type": "guideline",
47
+ "content": "A triple date picker displays a date range within the date field as well as three consecutive months within the calendar popover."
48
+ },
49
+ {
50
+ "type": "guideline",
51
+ "content": "The calendar popover is displayed or hidden when the user selects the in-field button (the calendar icon)."
52
+ },
53
+ {
54
+ "type": "guideline",
55
+ "content": "If a user selects a day preceding the first selection, that earlier day becomes the start of the range. For example:"
56
+ },
57
+ {
58
+ "type": "guideline",
59
+ "content": "A third selection resets the range. For example:"
60
+ },
61
+ {
62
+ "type": "guideline",
63
+ "content": "Date pickers display placeholder values in individual segments by default. This is to makes it easier for users to focus and edit specific values like the day, month, or year without re-entering the entire date."
64
+ },
65
+ {
66
+ "type": "guideline",
67
+ "content": "This approach reduces input errors, improves accessibility, and supports faster, more precise interactions. It also adapts well to different regional formats, enhancing clarity across locales."
68
+ },
69
+ {
70
+ "type": "guideline",
71
+ "content": "Date pickers can be used to select a single date or a date range (a start date and an end date)."
72
+ },
73
+ {
74
+ "type": "guideline",
75
+ "content": "When a date picker is formatted to allow a range, it displays a placeholder by default. When the user first interacts with the date field, the first value of the placeholder is in focus. This is to allow the user to edit the individual segments. When the user opens the popover without interacting, it displays the current day along with the month and year based on their locale. However, the date field will continue to show the placeholder until the user either completes the range in the field or within the calendar popover."
76
+ },
77
+ {
78
+ "type": "guideline",
79
+ "content": "If the user inputs a date range within the date field that spans more than the maximum of three months that the calendar popover allows, the calendar popover will only show the first three consecutive months within that range."
80
+ },
81
+ {
82
+ "type": "guideline",
83
+ "content": "The date field can also capture time values with precision down to the second, and may include time zone information. The calendar popover can also include time-specific fields, allowing users to specify start and end times."
84
+ },
85
+ {
86
+ "type": "guideline",
87
+ "content": "Date pickers can be marked as optional or required, depending on the situation. For required date pickers, there are two styling options: a “(required)” label or an asterisk. If you use an asterisk, be sure to include help text to explain what the asterisk means. Optional date pickers are either denoted with text added to the end of the label — “(optional)” — or have no indication at all."
88
+ },
89
+ {
90
+ "type": "guideline",
91
+ "content": "The asterisk used in this component is an icon that has specific spacing from the label text — not part of the label text itself."
92
+ },
93
+ {
94
+ "type": "guideline",
95
+ "content": "A read-only state of date picker means that the user cannot interact with the field, and they can only read what the field is displaying. Therefore, the in-field button is not clickable. In the disabled state, the read-only state of date picker allows the user to focus on a value—even though they cannot change the value."
96
+ },
97
+ {
98
+ "type": "guideline",
99
+ "content": "A disabled date picker means that the user cannot interact with the field, but not for the same reasons as a read-only scenario. For example, a date picker may be temporarily disabled because the user needs to complete a dependent task (such as filling out another field) somewhere within their experience. A disabled date picker does not allow for the ability to focus on a value, or to change its value."
100
+ },
101
+ {
102
+ "type": "guideline",
103
+ "content": "A date picker can be marked as having an error to show that a value needs to be entered in order to move forward, or that an entered value is invalid. In this scenario, displaying error text beneath the date field can aid the user in understanding how to resolve it. Error text within the calendar popover may also be helpful to aid the user in understanding what the error is signaling."
104
+ }
105
+ ],
106
+ "options": {
107
+ "variant": {
108
+ "type": "string",
109
+ "default": "single",
110
+ "description": "Controls the number of months displayed in the calendar popover.",
111
+ "values": [
112
+ {
113
+ "value": "single"
114
+ },
115
+ {
116
+ "value": "double"
117
+ },
118
+ {
119
+ "value": "triple"
120
+ }
121
+ ]
122
+ },
123
+ "selectedDate": {
124
+ "type": "string",
125
+ "description": "The currently selected date. Used when selectionMode is single."
126
+ },
127
+ "selectedRange": {
128
+ "type": "object",
129
+ "description": "The currently selected date range, used when selectionMode is range.",
130
+ "properties": {
131
+ "start": {
132
+ "type": "string",
133
+ "description": "Range start date."
134
+ },
135
+ "end": {
136
+ "type": "string",
137
+ "description": "Range end date."
138
+ }
139
+ }
140
+ },
141
+ "dateField": {
142
+ "type": "object",
143
+ "description": "Configuration for the date input field.",
144
+ "properties": {
145
+ "label": {
146
+ "type": "string",
147
+ "description": "Optional text label displayed with the date field."
148
+ },
149
+ "labelPosition": {
150
+ "type": "string",
151
+ "enum": ["top", "side"],
152
+ "default": "top"
153
+ },
154
+ "hideLabel": {
155
+ "type": "boolean",
156
+ "default": false
157
+ },
158
+ "isDisabled": {
159
+ "type": "boolean",
160
+ "default": false
161
+ },
162
+ "isReadOnly": {
163
+ "type": "boolean",
164
+ "default": false
165
+ },
166
+ "isRequired": {
167
+ "type": "boolean",
168
+ "default": false
169
+ },
170
+ "isError": {
171
+ "type": "boolean",
172
+ "default": false,
173
+ "description": "If there is an error, this property overrides show valid icon."
174
+ },
175
+ "state": {
176
+ "type": "string",
177
+ "enum": [
178
+ "default",
179
+ "hover",
180
+ "hover (in-field button)",
181
+ "focus + hover",
182
+ "focus + open",
183
+ "focus + not hover",
184
+ "keyboard focus"
185
+ ],
186
+ "default": "default"
187
+ }
188
+ }
189
+ },
190
+ "calendarPopover": {
191
+ "type": "object",
192
+ "description": "Configuration for the calendar popover.",
193
+ "properties": {
194
+ "isDisabled": {
195
+ "type": "boolean",
196
+ "default": false
197
+ },
198
+ "minValue": {
199
+ "type": "string",
200
+ "description": "The minimum allowed date that a user may select."
201
+ },
202
+ "maxValue": {
203
+ "type": "string",
204
+ "description": "The maximum allowed date that a user may select (ISO format string)."
205
+ },
206
+ "currentMonth": {
207
+ "type": "number",
208
+ "minimum": 1,
209
+ "maximum": 12,
210
+ "description": "The month currently displayed in the calendar (1 = January, 12 = December)."
211
+ },
212
+ "currentYear": {
213
+ "type": "number",
214
+ "description": "The year currently displayed in the calendar (Gregorian year number)."
215
+ },
216
+ "selectionMode": {
217
+ "type": "string",
218
+ "enum": ["single", "range"],
219
+ "default": "single",
220
+ "description": "Controls whether the calendar allows selecting a single date or a date range."
221
+ },
222
+ "showTimeZone": {
223
+ "type": "boolean",
224
+ "default": false,
225
+ "description": "Whether to show a time zone indicator in the popover."
226
+ },
227
+ "isError": {
228
+ "type": "boolean",
229
+ "default": false,
230
+ "description": "If the calendar popover is in an error state."
231
+ },
232
+ "timeFields": {
233
+ "type": "object",
234
+ "description": "Optional start and end time fields displayed within the calendar popover.",
235
+ "properties": {
236
+ "showStartTime": {
237
+ "type": "boolean",
238
+ "default": false,
239
+ "description": "If true, displays a start time field."
240
+ },
241
+ "showEndTime": {
242
+ "type": "boolean",
243
+ "default": false,
244
+ "description": "If true, displays an end time field."
245
+ },
246
+ "granularity": {
247
+ "type": "string",
248
+ "enum": ["hour", "minute", "second"],
249
+ "default": "minute",
250
+ "description": "The level of time granularity for the time fields."
251
+ },
252
+ "is24Hour": {
253
+ "type": "boolean",
254
+ "default": false,
255
+ "description": "If true, displays time in 24-hour format instead of AM/PM."
256
+ }
257
+ }
258
+ }
259
+ }
260
+ }
261
+ },
262
+ "lifecycle": {
263
+ "introduced": "1.0.0-draft"
264
+ },
265
+ "tokenBindings": [
266
+ {
267
+ "token": "strikethrough-day-thickness",
268
+ "context": "Strikethrough day "
269
+ },
270
+ {
271
+ "token": "date-picker-text-to-in-field-button",
272
+ "context": "Spacing (value to in-field button)"
273
+ }
274
+ ],
275
+ "accessibility": {
276
+ "intents": ["input", "choose"],
277
+ "focusable": true,
278
+ "keyboardIntents": ["navigate-items", "activate"],
279
+ "wcag": [
280
+ {
281
+ "criterion": "1.3.1",
282
+ "level": "A",
283
+ "title": "Info and Relationships"
284
+ },
285
+ {
286
+ "criterion": "2.1.1",
287
+ "level": "A",
288
+ "title": "Keyboard"
289
+ },
290
+ {
291
+ "criterion": "4.1.2",
292
+ "level": "A",
293
+ "title": "Name, Role, Value"
294
+ }
295
+ ]
296
+ }
297
+ }
@@ -0,0 +1,53 @@
1
+ {
2
+ "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component.schema.json",
3
+ "$id": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/components/detail.json",
4
+ "specVersion": "1.0.0-draft",
5
+ "name": "detail",
6
+ "displayName": "Detail",
7
+ "description": "Detail is a typography component used for disclosing extra information or smaller items in hierarchical relationships of text.",
8
+ "meta": {
9
+ "category": "typography",
10
+ "documentationUrl": "https://spectrum.adobe.com/page/detail/"
11
+ },
12
+ "options": {
13
+ "script": {
14
+ "$ref": "https://opensource.adobe.com/spectrum-design-data/schemas/types/typography-script.json"
15
+ },
16
+ "weight": {
17
+ "type": "string",
18
+ "default": "default",
19
+ "values": [
20
+ {
21
+ "value": "light"
22
+ },
23
+ {
24
+ "value": "default"
25
+ }
26
+ ]
27
+ },
28
+ "size": {
29
+ "type": "string",
30
+ "default": "m",
31
+ "values": [
32
+ {
33
+ "value": "s"
34
+ },
35
+ {
36
+ "value": "m"
37
+ },
38
+ {
39
+ "value": "l"
40
+ },
41
+ {
42
+ "value": "xl"
43
+ }
44
+ ]
45
+ }
46
+ },
47
+ "lifecycle": {
48
+ "introduced": "1.0.0-draft"
49
+ },
50
+ "accessibility": {
51
+ "focusable": false
52
+ }
53
+ }
@@ -0,0 +1,62 @@
1
+ {
2
+ "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component.schema.json",
3
+ "$id": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/components/divider.json",
4
+ "specVersion": "1.0.0-draft",
5
+ "name": "divider",
6
+ "displayName": "Divider",
7
+ "description": "Dividers bring clarity to a layout by grouping and dividing content in close proximity. They can also be used to establish rhythm and hierarchy.",
8
+ "meta": {
9
+ "category": "containers",
10
+ "documentationUrl": "https://spectrum.adobe.com/page/divider/"
11
+ },
12
+ "documentBlocks": [
13
+ {
14
+ "type": "purpose",
15
+ "content": "Dividers bring clarity to a layout by grouping and dividing content in close proximity. They can also be used to establish rhythm and hierarchy."
16
+ },
17
+ {
18
+ "type": "guideline",
19
+ "content": "Place a divider below a header.\n\nDividers (medium or large) can be used in combination with a header text to create a section or a page title. In such cases, place the divider below the header."
20
+ },
21
+ {
22
+ "type": "do-dont",
23
+ "content": "Don't overuse dividers",
24
+ "dont": "Dividers lose their value when overused. Use them sparingly to avoid creating unnecessary noise."
25
+ }
26
+ ],
27
+ "options": {
28
+ "size": {
29
+ "type": "string",
30
+ "default": "s",
31
+ "values": [
32
+ {
33
+ "value": "s"
34
+ },
35
+ {
36
+ "value": "m"
37
+ },
38
+ {
39
+ "value": "l"
40
+ }
41
+ ]
42
+ },
43
+ "orientation": {
44
+ "type": "string",
45
+ "default": "horizontal",
46
+ "values": [
47
+ {
48
+ "value": "horizontal"
49
+ },
50
+ {
51
+ "value": "vertical"
52
+ }
53
+ ]
54
+ }
55
+ },
56
+ "lifecycle": {
57
+ "introduced": "1.0.0-draft"
58
+ },
59
+ "accessibility": {
60
+ "focusable": false
61
+ }
62
+ }
@@ -0,0 +1,13 @@
1
+ {
2
+ "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component.schema.json",
3
+ "$id": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/components/double-calendar.json",
4
+ "specVersion": "1.0.0-draft",
5
+ "name": "double-calendar",
6
+ "displayName": "Double calendar",
7
+ "description": "A date-picker calendar variant displaying two consecutive months.",
8
+ "meta": {
9
+ "category": "inputs",
10
+ "documentationUrl": "https://spectrum.adobe.com/page/double-calendar/"
11
+ },
12
+ "lifecycle": { "introduced": "1.0.0-draft" }
13
+ }
@@ -0,0 +1,102 @@
1
+ {
2
+ "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component.schema.json",
3
+ "$id": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/components/drop-zone.json",
4
+ "specVersion": "1.0.0-draft",
5
+ "name": "drop-zone",
6
+ "displayName": "Drop zone",
7
+ "description": "A drop zone allows users to drag and drop files or other content into a designated area.",
8
+ "meta": {
9
+ "category": "inputs",
10
+ "documentationUrl": "https://spectrum.adobe.com/page/drop-zone/"
11
+ },
12
+ "documentBlocks": [
13
+ {
14
+ "type": "purpose",
15
+ "content": "A drop zone allows users to drag and drop files or other content into a designated area."
16
+ },
17
+ {
18
+ "type": "guideline",
19
+ "content": "Drop zones accept dragged and dropped objects. They support upload and file management workflows, and are commonly used to move or add content within an interface."
20
+ },
21
+ {
22
+ "type": "guideline",
23
+ "content": "A button is an optional element to prompt the user to take action."
24
+ },
25
+ {
26
+ "type": "guideline",
27
+ "content": "Drop zones come in three different sizes: small, medium, and large. The medium size is the default and most frequently used option."
28
+ },
29
+ {
30
+ "type": "guideline",
31
+ "content": "Indicate to users the accepted file types to let users know what they can upload before interacting. This can be done through helper text or placeholder content."
32
+ },
33
+ {
34
+ "type": "guideline",
35
+ "content": "When a file is dragged over or dropped into the zone, provide the user with visual feedback such as highlighting the border or changing the background, to confirm the interaction is recognized."
36
+ },
37
+ {
38
+ "type": "guideline",
39
+ "content": "Visual styling that indicates a user can replace file types within a dropzone should clearly communicate interactivity and the potential for change without disrupting the overall layout. This is typically achieved through subtle but intuitive cues such as displaying a button over the drop zone area informing the user that they may replace their content type."
40
+ }
41
+ ],
42
+ "options": {
43
+ "accept": {
44
+ "type": "array",
45
+ "items": {
46
+ "type": "string",
47
+ "description": "File types that are accepted by the drop zone."
48
+ }
49
+ },
50
+ "size": {
51
+ "type": "string",
52
+ "default": "m",
53
+ "values": [
54
+ {
55
+ "value": "s"
56
+ },
57
+ {
58
+ "value": "m"
59
+ },
60
+ {
61
+ "value": "l"
62
+ }
63
+ ]
64
+ },
65
+ "actionLabel": {
66
+ "type": "string",
67
+ "description": "If undefined, this button does not appear."
68
+ },
69
+ "onDrop": {
70
+ "type": "string",
71
+ "description": "Callback function called when files are dropped onto the drop zone."
72
+ },
73
+ "onDragOver": {
74
+ "type": "string",
75
+ "description": "Callback function called when a file is dragged over the drop zone."
76
+ },
77
+ "onDragLeave": {
78
+ "type": "string",
79
+ "description": "Callback function called when a file is dragged out of the drop zone."
80
+ }
81
+ },
82
+ "lifecycle": {
83
+ "introduced": "1.0.0-draft"
84
+ },
85
+ "accessibility": {
86
+ "intents": ["input"],
87
+ "focusable": true,
88
+ "keyboardIntents": ["activate"],
89
+ "wcag": [
90
+ {
91
+ "criterion": "2.1.1",
92
+ "level": "A",
93
+ "title": "Keyboard"
94
+ },
95
+ {
96
+ "criterion": "4.1.2",
97
+ "level": "A",
98
+ "title": "Name, Role, Value"
99
+ }
100
+ ]
101
+ }
102
+ }
@@ -0,0 +1,125 @@
1
+ {
2
+ "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component.schema.json",
3
+ "$id": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/components/field-label.json",
4
+ "specVersion": "1.0.0-draft",
5
+ "name": "field-label",
6
+ "displayName": "Field label",
7
+ "description": "Field labels give context to the information that a user needs to input. They're commonly used in forms.",
8
+ "meta": {
9
+ "category": "inputs",
10
+ "documentationUrl": "https://spectrum.adobe.com/page/field-label/"
11
+ },
12
+ "documentBlocks": [
13
+ {
14
+ "type": "purpose",
15
+ "content": "Field labels give context to the information that a user needs to input. They're commonly used in forms."
16
+ },
17
+ {
18
+ "type": "guideline",
19
+ "content": "Field labels provide context for associated input fields. They describe the expected content or data type."
20
+ },
21
+ {
22
+ "type": "guideline",
23
+ "content": "A field label in a disabled state shows that an input field exists, but is not available in that circumstance. This can be used to maintain layout continuity and communicate that an input field may become available later."
24
+ },
25
+ {
26
+ "type": "guideline",
27
+ "content": "Inputs can be marked as required or optional, depending on the situation, using a necessity indicator. There are two styles for the necessity indicator: icon or text."
28
+ },
29
+ {
30
+ "type": "guideline",
31
+ "content": "By default, the necessity indicator is shown with an asterisk icon. Required inputs are marked with this at the end of the label. If you use this icon, be sure to include hint text to explain what it means. The asterisk used in this component is an icon that has specific spacing from the label text — not part of the label text itself. Optional inputs do not have an icon."
32
+ },
33
+ {
34
+ "type": "guideline",
35
+ "content": "Alternatively, the necessity indicator can be shown with text. This appends text that reads either “(required)” or “(optional)” at the end of the label."
36
+ },
37
+ {
38
+ "type": "guideline",
39
+ "content": "Field labels come in four different sizes: small, medium, large, and extra-large. The medium size is the default and most frequently used option with medium-sized inputs. Use the other sizes sparingly; they should be used to create a hierarchy of importance within the page. Both small and medium field labels have the same font size, but different paddings when used as side labels."
40
+ },
41
+ {
42
+ "type": "guideline",
43
+ "content": "A label can be placed either on top or on the side of an input. This option affects the bounding box of the component to ensure proper alignment. Top labels are the default and are recommended because they work better with long copy, localization, and responsive layouts. Side labels are most useful when vertical space is limited."
44
+ },
45
+ {
46
+ "type": "guideline",
47
+ "content": "When the field label is too long for the available horizontal space, it wraps to form another line."
48
+ },
49
+ {
50
+ "type": "guideline",
51
+ "content": "In a single form, mark only the required fields or only the optional fields, depending on whichever is less frequent in the entire form."
52
+ },
53
+ {
54
+ "type": "guideline",
55
+ "content": "If most of the input fields are optional, only the required fields should be given an asterisk icon or have labels appended with “(required).” If most of the input fields are required, only the optional fields should be appended with “(optional).” An asterisk icon should never be used to note that a field is optional."
56
+ }
57
+ ],
58
+ "options": {
59
+ "label": {
60
+ "type": "string"
61
+ },
62
+ "labelPosition": {
63
+ "type": "string",
64
+ "default": "top",
65
+ "values": [
66
+ {
67
+ "value": "top"
68
+ },
69
+ {
70
+ "value": "side"
71
+ }
72
+ ]
73
+ },
74
+ "size": {
75
+ "type": "string",
76
+ "default": "m",
77
+ "values": [
78
+ {
79
+ "value": "s"
80
+ },
81
+ {
82
+ "value": "m"
83
+ },
84
+ {
85
+ "value": "l"
86
+ },
87
+ {
88
+ "value": "xl"
89
+ }
90
+ ]
91
+ },
92
+ "necessityIndicator": {
93
+ "type": "string",
94
+ "default": "icon",
95
+ "values": [
96
+ {
97
+ "value": "text"
98
+ },
99
+ {
100
+ "value": "icon"
101
+ }
102
+ ]
103
+ },
104
+ "isRequired": {
105
+ "type": "boolean",
106
+ "default": false
107
+ },
108
+ "isDisabled": {
109
+ "type": "boolean",
110
+ "default": false
111
+ }
112
+ },
113
+ "anatomy": [
114
+ {
115
+ "name": "asterisk",
116
+ "description": "Required-field indicator."
117
+ }
118
+ ],
119
+ "lifecycle": {
120
+ "introduced": "1.0.0-draft"
121
+ },
122
+ "accessibility": {
123
+ "focusable": false
124
+ }
125
+ }
@@ -0,0 +1,13 @@
1
+ {
2
+ "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component.schema.json",
3
+ "$id": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/components/field.json",
4
+ "specVersion": "1.0.0-draft",
5
+ "name": "field",
6
+ "displayName": "Field",
7
+ "description": "Shared layout primitive underlying labeled form fields (text field, picker, etc.).",
8
+ "meta": {
9
+ "category": "inputs",
10
+ "documentationUrl": "https://spectrum.adobe.com/page/field/"
11
+ },
12
+ "lifecycle": { "introduced": "1.0.0-draft" }
13
+ }