@proyecto-viviana/solidaria 0.2.4 → 0.2.8
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/LICENSE +21 -0
- package/dist/actiongroup/createActionGroup.d.ts +29 -0
- package/dist/actiongroup/createActionGroup.d.ts.map +1 -0
- package/dist/actiongroup/index.d.ts +2 -0
- package/dist/actiongroup/index.d.ts.map +1 -0
- package/dist/autocomplete/createAutocomplete.d.ts +6 -2
- package/dist/autocomplete/createAutocomplete.d.ts.map +1 -1
- package/dist/breadcrumbs/createBreadcrumbs.d.ts +2 -0
- package/dist/breadcrumbs/createBreadcrumbs.d.ts.map +1 -1
- package/dist/button/createToggleButtonGroup.d.ts +32 -0
- package/dist/button/createToggleButtonGroup.d.ts.map +1 -0
- package/dist/button/index.d.ts +2 -0
- package/dist/button/index.d.ts.map +1 -1
- package/dist/calendar/createCalendarCell.d.ts +2 -0
- package/dist/calendar/createCalendarCell.d.ts.map +1 -1
- package/dist/calendar/createCalendarGrid.d.ts.map +1 -1
- package/dist/calendar/createRangeCalendarCell.d.ts +3 -1
- package/dist/calendar/createRangeCalendarCell.d.ts.map +1 -1
- package/dist/checkbox/createCheckboxGroup.d.ts +5 -1
- package/dist/checkbox/createCheckboxGroup.d.ts.map +1 -1
- package/dist/collections/index.d.ts +56 -0
- package/dist/collections/index.d.ts.map +1 -0
- package/dist/color/createColorArea.d.ts.map +1 -1
- package/dist/color/createColorSlider.d.ts.map +1 -1
- package/dist/color/createColorWheel.d.ts.map +1 -1
- package/dist/combobox/createComboBox.d.ts +6 -0
- package/dist/combobox/createComboBox.d.ts.map +1 -1
- package/dist/datepicker/createDatePicker.d.ts +6 -0
- package/dist/datepicker/createDatePicker.d.ts.map +1 -1
- package/dist/datepicker/createDateRangePicker.d.ts +40 -0
- package/dist/datepicker/createDateRangePicker.d.ts.map +1 -0
- package/dist/datepicker/createDateSegment.d.ts +1 -1
- package/dist/datepicker/createDateSegment.d.ts.map +1 -1
- package/dist/datepicker/createTimeSegment.d.ts +29 -0
- package/dist/datepicker/createTimeSegment.d.ts.map +1 -0
- package/dist/datepicker/index.d.ts +2 -0
- package/dist/datepicker/index.d.ts.map +1 -1
- package/dist/disclosure/createDisclosureGroup.d.ts +2 -1
- package/dist/disclosure/createDisclosureGroup.d.ts.map +1 -1
- package/dist/dnd/createDrag.d.ts.map +1 -1
- package/dist/dnd/createDraggableCollection.d.ts +4 -0
- package/dist/dnd/createDraggableCollection.d.ts.map +1 -1
- package/dist/dnd/createDraggableItem.d.ts.map +1 -1
- package/dist/dnd/createDrop.d.ts.map +1 -1
- package/dist/dnd/createDroppableCollection.d.ts +32 -1
- package/dist/dnd/createDroppableCollection.d.ts.map +1 -1
- package/dist/dnd/createDroppableItem.d.ts.map +1 -1
- package/dist/dnd/index.d.ts +1 -1
- package/dist/dnd/index.d.ts.map +1 -1
- package/dist/grid/createGrid.d.ts.map +1 -1
- package/dist/gridlist/createGridList.d.ts.map +1 -1
- package/dist/index.d.ts +6 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4659 -3452
- package/dist/index.js.map +1 -7
- package/dist/index.ssr.js +4659 -3452
- package/dist/index.ssr.js.map +1 -7
- package/dist/interactions/createFocus.d.ts.map +1 -1
- package/dist/interactions/createFocusWithin.d.ts.map +1 -1
- package/dist/link/createLink.d.ts +10 -0
- package/dist/link/createLink.d.ts.map +1 -1
- package/dist/listbox/createListBox.d.ts +1 -0
- package/dist/listbox/createListBox.d.ts.map +1 -1
- package/dist/listbox/createOption.d.ts.map +1 -1
- package/dist/menu/createMenu.d.ts +1 -0
- package/dist/menu/createMenu.d.ts.map +1 -1
- package/dist/meter/createMeter.d.ts.map +1 -1
- package/dist/numberfield/createNumberField.d.ts +18 -0
- package/dist/numberfield/createNumberField.d.ts.map +1 -1
- package/dist/overlays/createModal.d.ts +16 -0
- package/dist/overlays/createModal.d.ts.map +1 -1
- package/dist/overlays/createOverlay.d.ts.map +1 -1
- package/dist/overlays/index.d.ts +1 -1
- package/dist/overlays/index.d.ts.map +1 -1
- package/dist/popover/createOverlayPosition.d.ts.map +1 -1
- package/dist/popover/createPopover.d.ts.map +1 -1
- package/dist/progress/createProgressBar.d.ts.map +1 -1
- package/dist/radio/createRadioGroup.d.ts +2 -2
- package/dist/radio/createRadioGroup.d.ts.map +1 -1
- package/dist/searchfield/createSearchField.d.ts.map +1 -1
- package/dist/select/createHiddenSelect.d.ts.map +1 -1
- package/dist/select/createSelect.d.ts.map +1 -1
- package/dist/slider/createSlider.d.ts.map +1 -1
- package/dist/table/createTable.d.ts.map +1 -1
- package/dist/tabs/createTabs.d.ts +1 -1
- package/dist/tabs/createTabs.d.ts.map +1 -1
- package/dist/tag/createTag.d.ts.map +1 -1
- package/dist/tag/createTagGroup.d.ts.map +1 -1
- package/dist/toast/createToast.d.ts +4 -0
- package/dist/toast/createToast.d.ts.map +1 -1
- package/dist/toast/createToastRegion.d.ts.map +1 -1
- package/dist/toolbar/createToolbar.d.ts.map +1 -1
- package/dist/tooltip/createTooltipTrigger.d.ts.map +1 -1
- package/dist/tree/createTree.d.ts.map +1 -1
- package/dist/tree/createTreeItem.d.ts.map +1 -1
- package/dist/tree/types.d.ts +4 -0
- package/dist/tree/types.d.ts.map +1 -1
- package/dist/utils/env.d.ts +1 -1
- package/dist/utils/env.d.ts.map +1 -1
- package/dist/utils/platform.d.ts.map +1 -1
- package/dist/visually-hidden/createVisuallyHidden.d.ts.map +1 -1
- package/package.json +8 -6
- package/src/actiongroup/createActionGroup.ts +324 -0
- package/src/actiongroup/index.ts +8 -0
- package/src/autocomplete/createAutocomplete.ts +32 -9
- package/src/breadcrumbs/createBreadcrumbs.ts +10 -15
- package/src/button/createButton.ts +1 -1
- package/src/button/createToggleButtonGroup.ts +128 -0
- package/src/button/index.ts +9 -0
- package/src/calendar/createCalendarCell.ts +6 -4
- package/src/calendar/createCalendarGrid.ts +27 -18
- package/src/calendar/createRangeCalendarCell.ts +26 -9
- package/src/checkbox/createCheckboxGroup.ts +21 -4
- package/src/collections/index.ts +242 -0
- package/src/color/createColorArea.ts +380 -314
- package/src/color/createColorField.ts +137 -137
- package/src/color/createColorSlider.ts +286 -197
- package/src/color/createColorSwatch.ts +40 -40
- package/src/color/createColorWheel.ts +218 -208
- package/src/color/index.ts +24 -24
- package/src/color/types.ts +116 -116
- package/src/combobox/createComboBox.ts +670 -647
- package/src/combobox/index.ts +6 -6
- package/src/datepicker/createDatePicker.ts +54 -16
- package/src/datepicker/createDateRangePicker.ts +246 -0
- package/src/datepicker/createDateSegment.ts +185 -31
- package/src/datepicker/createTimeSegment.ts +370 -0
- package/src/datepicker/index.ts +14 -0
- package/src/dialog/createDialog.ts +120 -120
- package/src/dialog/index.ts +2 -2
- package/src/dialog/types.ts +19 -19
- package/src/disclosure/createDisclosureGroup.ts +5 -2
- package/src/dnd/createDrag.ts +224 -209
- package/src/dnd/createDraggableCollection.ts +96 -63
- package/src/dnd/createDraggableItem.ts +259 -243
- package/src/dnd/createDrop.ts +322 -321
- package/src/dnd/createDroppableCollection.ts +682 -293
- package/src/dnd/createDroppableItem.ts +215 -213
- package/src/dnd/index.ts +55 -47
- package/src/dnd/types.ts +89 -89
- package/src/dnd/utils.ts +294 -294
- package/src/focus/createAutoFocus.ts +321 -321
- package/src/focus/createFocusRestore.ts +313 -313
- package/src/focus/createVirtualFocus.ts +396 -396
- package/src/form/createFormValidation.ts +224 -224
- package/src/form/index.ts +11 -11
- package/src/grid/createGrid.ts +3 -1
- package/src/gridlist/createGridList.ts +16 -0
- package/src/gridlist/createGridListItem.ts +1 -1
- package/src/i18n/NumberFormatter.ts +266 -266
- package/src/i18n/createCollator.ts +79 -79
- package/src/i18n/createDateFormatter.ts +83 -83
- package/src/i18n/createFilter.ts +131 -131
- package/src/i18n/createNumberFormatter.ts +52 -52
- package/src/i18n/index.ts +40 -40
- package/src/i18n/locale.tsx +188 -188
- package/src/i18n/utils.ts +99 -99
- package/src/index.ts +51 -0
- package/src/interactions/createFocus.ts +6 -5
- package/src/interactions/createFocusWithin.ts +6 -5
- package/src/interactions/createLongPress.ts +174 -174
- package/src/interactions/createMove.ts +289 -289
- package/src/interactions/createPress.ts +5 -5
- package/src/landmark/createLandmark.ts +377 -377
- package/src/landmark/index.ts +8 -8
- package/src/link/createLink.ts +23 -8
- package/src/listbox/createListBox.ts +308 -269
- package/src/listbox/createOption.ts +162 -151
- package/src/listbox/index.ts +12 -12
- package/src/live-announcer/announce.ts +322 -322
- package/src/live-announcer/index.ts +9 -9
- package/src/menu/createMenu.ts +405 -396
- package/src/menu/createMenuItem.ts +149 -149
- package/src/menu/createMenuTrigger.ts +88 -88
- package/src/menu/index.ts +18 -18
- package/src/meter/createMeter.ts +1 -6
- package/src/numberfield/createNumberField.ts +311 -268
- package/src/numberfield/index.ts +5 -5
- package/src/overlays/ariaHideOutside.ts +219 -219
- package/src/overlays/createInteractOutside.ts +149 -149
- package/src/overlays/createModal.tsx +238 -202
- package/src/overlays/createOverlay.ts +165 -155
- package/src/overlays/createOverlayTrigger.ts +85 -85
- package/src/overlays/createPreventScroll.ts +266 -266
- package/src/overlays/index.ts +48 -44
- package/src/popover/calculatePosition.ts +6 -6
- package/src/popover/createOverlayPosition.ts +7 -4
- package/src/popover/createPopover.ts +21 -7
- package/src/progress/createProgressBar.ts +6 -1
- package/src/radio/createRadioGroup.ts +88 -14
- package/src/searchfield/createSearchField.ts +241 -186
- package/src/searchfield/index.ts +2 -2
- package/src/select/createHiddenSelect.tsx +263 -236
- package/src/select/createSelect.ts +373 -395
- package/src/select/index.ts +14 -14
- package/src/slider/createSlider.ts +364 -349
- package/src/slider/index.ts +2 -2
- package/src/ssr/index.tsx +370 -370
- package/src/table/createTable.ts +3 -1
- package/src/table/createTableColumnHeader.ts +1 -1
- package/src/table/createTableRow.ts +1 -1
- package/src/tabs/createTabs.ts +80 -51
- package/src/tag/createTag.ts +135 -6
- package/src/tag/createTagGroup.ts +7 -2
- package/src/toast/createToast.ts +8 -2
- package/src/toast/createToastRegion.ts +0 -1
- package/src/toolbar/createToolbar.ts +75 -1
- package/src/tooltip/createTooltip.ts +79 -79
- package/src/tooltip/createTooltipTrigger.ts +226 -222
- package/src/tooltip/index.ts +6 -6
- package/src/tree/createTree.ts +261 -246
- package/src/tree/createTreeItem.ts +282 -233
- package/src/tree/createTreeSelectionCheckbox.ts +68 -68
- package/src/tree/index.ts +16 -16
- package/src/tree/types.ts +91 -87
- package/src/utils/env.ts +55 -54
- package/src/utils/platform.ts +16 -6
- package/src/visually-hidden/createVisuallyHidden.ts +139 -124
- package/src/visually-hidden/index.ts +6 -6
|
@@ -1,395 +1,373 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Provides the behavior and accessibility implementation for a select component.
|
|
3
|
-
* A select displays a collapsible list of options and allows a user to select one of them.
|
|
4
|
-
* Based on @react-aria/select useSelect.
|
|
5
|
-
*/
|
|
6
|
-
|
|
7
|
-
import { type JSX, type Accessor, createEffect, onCleanup } from 'solid-js';
|
|
8
|
-
import { createPress } from '../interactions/createPress';
|
|
9
|
-
import { createFocusRing } from '../interactions/createFocusRing';
|
|
10
|
-
import { createLabel } from '../label/createLabel';
|
|
11
|
-
import { createTypeSelect } from '../selection/createTypeSelect';
|
|
12
|
-
import { filterDOMProps } from '../utils/filterDOMProps';
|
|
13
|
-
import { mergeProps } from '../utils/mergeProps';
|
|
14
|
-
import { createId } from '../ssr';
|
|
15
|
-
import { access, type MaybeAccessor } from '../utils/reactivity';
|
|
16
|
-
import type { SelectState, CollectionNode } from '@proyecto-viviana/solid-stately';
|
|
17
|
-
|
|
18
|
-
export interface AriaSelectProps {
|
|
19
|
-
/** An ID for the select. */
|
|
20
|
-
id?: string;
|
|
21
|
-
/** Whether the select is disabled. */
|
|
22
|
-
isDisabled?: boolean;
|
|
23
|
-
/** Whether the select is required. */
|
|
24
|
-
isRequired?: boolean;
|
|
25
|
-
/** The label for the select. */
|
|
26
|
-
label?: JSX.Element;
|
|
27
|
-
/** An accessible label for the select when no visible label is provided. */
|
|
28
|
-
'aria-label'?: string;
|
|
29
|
-
/** The ID of an element that labels the select. */
|
|
30
|
-
'aria-labelledby'?: string;
|
|
31
|
-
/** The ID of an element that describes the select. */
|
|
32
|
-
'aria-describedby'?: string;
|
|
33
|
-
/** Placeholder text when no option is selected. */
|
|
34
|
-
placeholder?: string;
|
|
35
|
-
/** Whether the select should be auto-focused. */
|
|
36
|
-
autoFocus?: boolean;
|
|
37
|
-
/** Handler called when focus moves to the select. */
|
|
38
|
-
onFocus?: (e: FocusEvent) => void;
|
|
39
|
-
/** Handler called when focus moves away from the select. */
|
|
40
|
-
onBlur?: (e: FocusEvent) => void;
|
|
41
|
-
/** Handler called when the focus state changes. */
|
|
42
|
-
onFocusChange?: (isFocused: boolean) => void;
|
|
43
|
-
/** The name of the select, used when submitting an HTML form. */
|
|
44
|
-
name?: string;
|
|
45
|
-
/** Whether type-to-select is disabled. @default false */
|
|
46
|
-
disallowTypeAhead?: boolean;
|
|
47
|
-
}
|
|
48
|
-
|
|
49
|
-
export interface SelectAria<T> {
|
|
50
|
-
/** Props for the label element. */
|
|
51
|
-
labelProps: JSX.HTMLAttributes<HTMLElement>;
|
|
52
|
-
/** Props for the trigger button element. */
|
|
53
|
-
triggerProps: JSX.HTMLAttributes<HTMLElement>;
|
|
54
|
-
/** Props for the value display element. */
|
|
55
|
-
valueProps: JSX.HTMLAttributes<HTMLElement>;
|
|
56
|
-
/** Props for the listbox/menu popup. */
|
|
57
|
-
menuProps: JSX.HTMLAttributes<HTMLElement>;
|
|
58
|
-
/** Props for the description element, if any. */
|
|
59
|
-
descriptionProps: JSX.HTMLAttributes<HTMLElement>;
|
|
60
|
-
/** Props for the error message element, if any. */
|
|
61
|
-
errorMessageProps: JSX.HTMLAttributes<HTMLElement>;
|
|
62
|
-
/** Whether the select is currently focused. */
|
|
63
|
-
isFocused: Accessor<boolean>;
|
|
64
|
-
/** Whether the select has keyboard focus. */
|
|
65
|
-
isFocusVisible: Accessor<boolean>;
|
|
66
|
-
/** Whether the select is currently open. */
|
|
67
|
-
isOpen: Accessor<boolean>;
|
|
68
|
-
/** The currently selected item. */
|
|
69
|
-
selectedItem: Accessor<CollectionNode<T> | null>;
|
|
70
|
-
}
|
|
71
|
-
|
|
72
|
-
// Shared data between select and options
|
|
73
|
-
const selectData = new WeakMap<object, SelectData>();
|
|
74
|
-
|
|
75
|
-
interface SelectData {
|
|
76
|
-
id: string;
|
|
77
|
-
}
|
|
78
|
-
|
|
79
|
-
export function getSelectData(state: SelectState): SelectData | undefined {
|
|
80
|
-
return selectData.get(state);
|
|
81
|
-
}
|
|
82
|
-
|
|
83
|
-
/**
|
|
84
|
-
* Provides the behavior and accessibility implementation for a select component.
|
|
85
|
-
*/
|
|
86
|
-
export function createSelect<T>(
|
|
87
|
-
props: MaybeAccessor<AriaSelectProps>,
|
|
88
|
-
state: SelectState<T>,
|
|
89
|
-
_ref?: () => HTMLElement | null
|
|
90
|
-
): SelectAria<T> {
|
|
91
|
-
const getProps = () => access(props);
|
|
92
|
-
const id = createId(getProps().id);
|
|
93
|
-
|
|
94
|
-
// Generate IDs for associated elements
|
|
95
|
-
const buttonId = `${id}-button`;
|
|
96
|
-
const listBoxId = `${id}-listbox`;
|
|
97
|
-
const valueId = `${id}-value`;
|
|
98
|
-
const descriptionId = `${id}-description`;
|
|
99
|
-
const errorMessageId = `${id}-error`;
|
|
100
|
-
|
|
101
|
-
// Filter DOM props
|
|
102
|
-
const domProps = () =>
|
|
103
|
-
filterDOMProps(getProps() as unknown as Record<string, unknown>, { labelable: true });
|
|
104
|
-
|
|
105
|
-
// Share data with child options
|
|
106
|
-
createEffect(() => {
|
|
107
|
-
selectData.set(state, { id });
|
|
108
|
-
|
|
109
|
-
onCleanup(() => {
|
|
110
|
-
selectData.delete(state);
|
|
111
|
-
});
|
|
112
|
-
});
|
|
113
|
-
|
|
114
|
-
// Label handling
|
|
115
|
-
const { labelProps, fieldProps } = createLabel({
|
|
116
|
-
get id() {
|
|
117
|
-
return buttonId;
|
|
118
|
-
},
|
|
119
|
-
get label() {
|
|
120
|
-
return getProps().label;
|
|
121
|
-
},
|
|
122
|
-
get 'aria-label'() {
|
|
123
|
-
return getProps()['aria-label'];
|
|
124
|
-
},
|
|
125
|
-
get 'aria-labelledby'() {
|
|
126
|
-
return getProps()['aria-labelledby'];
|
|
127
|
-
},
|
|
128
|
-
labelElementType: 'span',
|
|
129
|
-
});
|
|
130
|
-
|
|
131
|
-
// Focus ring for keyboard focus styling
|
|
132
|
-
const { isFocusVisible, focusProps } = createFocusRing({
|
|
133
|
-
get autoFocus() {
|
|
134
|
-
return getProps().autoFocus;
|
|
135
|
-
},
|
|
136
|
-
});
|
|
137
|
-
|
|
138
|
-
// Track focus state
|
|
139
|
-
const isFocused = state.isFocused;
|
|
140
|
-
|
|
141
|
-
// Handle press on trigger
|
|
142
|
-
const { pressProps } = createPress({
|
|
143
|
-
get isDisabled() {
|
|
144
|
-
return getProps().isDisabled ?? state.isDisabled;
|
|
145
|
-
},
|
|
146
|
-
onPress() {
|
|
147
|
-
state.toggle();
|
|
148
|
-
},
|
|
149
|
-
});
|
|
150
|
-
|
|
151
|
-
// Helper to
|
|
152
|
-
const
|
|
153
|
-
const collection = state.collection();
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
const
|
|
161
|
-
? (k: string | number) => collection.getKeyAfter(k)
|
|
162
|
-
: (k: string | number) => collection.getKeyBefore(k);
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
id: listBoxId,
|
|
375
|
-
role: 'listbox',
|
|
376
|
-
'aria-labelledby': buttonId,
|
|
377
|
-
tabIndex: -1,
|
|
378
|
-
} as JSX.HTMLAttributes<HTMLElement>;
|
|
379
|
-
},
|
|
380
|
-
get descriptionProps() {
|
|
381
|
-
return {
|
|
382
|
-
id: descriptionId,
|
|
383
|
-
} as JSX.HTMLAttributes<HTMLElement>;
|
|
384
|
-
},
|
|
385
|
-
get errorMessageProps() {
|
|
386
|
-
return {
|
|
387
|
-
id: errorMessageId,
|
|
388
|
-
} as JSX.HTMLAttributes<HTMLElement>;
|
|
389
|
-
},
|
|
390
|
-
isFocused,
|
|
391
|
-
isFocusVisible: () => isFocused() && isFocusVisible(),
|
|
392
|
-
isOpen: state.isOpen,
|
|
393
|
-
selectedItem: state.selectedItem,
|
|
394
|
-
};
|
|
395
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* Provides the behavior and accessibility implementation for a select component.
|
|
3
|
+
* A select displays a collapsible list of options and allows a user to select one of them.
|
|
4
|
+
* Based on @react-aria/select useSelect.
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
import { type JSX, type Accessor, createEffect, onCleanup } from 'solid-js';
|
|
8
|
+
import { createPress } from '../interactions/createPress';
|
|
9
|
+
import { createFocusRing } from '../interactions/createFocusRing';
|
|
10
|
+
import { createLabel } from '../label/createLabel';
|
|
11
|
+
import { createTypeSelect } from '../selection/createTypeSelect';
|
|
12
|
+
import { filterDOMProps } from '../utils/filterDOMProps';
|
|
13
|
+
import { mergeProps } from '../utils/mergeProps';
|
|
14
|
+
import { createId } from '../ssr';
|
|
15
|
+
import { access, type MaybeAccessor } from '../utils/reactivity';
|
|
16
|
+
import type { SelectState, CollectionNode } from '@proyecto-viviana/solid-stately';
|
|
17
|
+
|
|
18
|
+
export interface AriaSelectProps {
|
|
19
|
+
/** An ID for the select. */
|
|
20
|
+
id?: string;
|
|
21
|
+
/** Whether the select is disabled. */
|
|
22
|
+
isDisabled?: boolean;
|
|
23
|
+
/** Whether the select is required. */
|
|
24
|
+
isRequired?: boolean;
|
|
25
|
+
/** The label for the select. */
|
|
26
|
+
label?: JSX.Element;
|
|
27
|
+
/** An accessible label for the select when no visible label is provided. */
|
|
28
|
+
'aria-label'?: string;
|
|
29
|
+
/** The ID of an element that labels the select. */
|
|
30
|
+
'aria-labelledby'?: string;
|
|
31
|
+
/** The ID of an element that describes the select. */
|
|
32
|
+
'aria-describedby'?: string;
|
|
33
|
+
/** Placeholder text when no option is selected. */
|
|
34
|
+
placeholder?: string;
|
|
35
|
+
/** Whether the select should be auto-focused. */
|
|
36
|
+
autoFocus?: boolean;
|
|
37
|
+
/** Handler called when focus moves to the select. */
|
|
38
|
+
onFocus?: (e: FocusEvent) => void;
|
|
39
|
+
/** Handler called when focus moves away from the select. */
|
|
40
|
+
onBlur?: (e: FocusEvent) => void;
|
|
41
|
+
/** Handler called when the focus state changes. */
|
|
42
|
+
onFocusChange?: (isFocused: boolean) => void;
|
|
43
|
+
/** The name of the select, used when submitting an HTML form. */
|
|
44
|
+
name?: string;
|
|
45
|
+
/** Whether type-to-select is disabled. @default false */
|
|
46
|
+
disallowTypeAhead?: boolean;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
export interface SelectAria<T> {
|
|
50
|
+
/** Props for the label element. */
|
|
51
|
+
labelProps: JSX.HTMLAttributes<HTMLElement>;
|
|
52
|
+
/** Props for the trigger button element. */
|
|
53
|
+
triggerProps: JSX.HTMLAttributes<HTMLElement>;
|
|
54
|
+
/** Props for the value display element. */
|
|
55
|
+
valueProps: JSX.HTMLAttributes<HTMLElement>;
|
|
56
|
+
/** Props for the listbox/menu popup. */
|
|
57
|
+
menuProps: JSX.HTMLAttributes<HTMLElement>;
|
|
58
|
+
/** Props for the description element, if any. */
|
|
59
|
+
descriptionProps: JSX.HTMLAttributes<HTMLElement>;
|
|
60
|
+
/** Props for the error message element, if any. */
|
|
61
|
+
errorMessageProps: JSX.HTMLAttributes<HTMLElement>;
|
|
62
|
+
/** Whether the select is currently focused. */
|
|
63
|
+
isFocused: Accessor<boolean>;
|
|
64
|
+
/** Whether the select has keyboard focus. */
|
|
65
|
+
isFocusVisible: Accessor<boolean>;
|
|
66
|
+
/** Whether the select is currently open. */
|
|
67
|
+
isOpen: Accessor<boolean>;
|
|
68
|
+
/** The currently selected item. */
|
|
69
|
+
selectedItem: Accessor<CollectionNode<T> | null>;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
// Shared data between select and options
|
|
73
|
+
const selectData = new WeakMap<object, SelectData>();
|
|
74
|
+
|
|
75
|
+
interface SelectData {
|
|
76
|
+
id: string;
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
export function getSelectData(state: SelectState): SelectData | undefined {
|
|
80
|
+
return selectData.get(state);
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
/**
|
|
84
|
+
* Provides the behavior and accessibility implementation for a select component.
|
|
85
|
+
*/
|
|
86
|
+
export function createSelect<T>(
|
|
87
|
+
props: MaybeAccessor<AriaSelectProps>,
|
|
88
|
+
state: SelectState<T>,
|
|
89
|
+
_ref?: () => HTMLElement | null
|
|
90
|
+
): SelectAria<T> {
|
|
91
|
+
const getProps = () => access(props);
|
|
92
|
+
const id = createId(getProps().id);
|
|
93
|
+
|
|
94
|
+
// Generate IDs for associated elements
|
|
95
|
+
const buttonId = `${id}-button`;
|
|
96
|
+
const listBoxId = `${id}-listbox`;
|
|
97
|
+
const valueId = `${id}-value`;
|
|
98
|
+
const descriptionId = `${id}-description`;
|
|
99
|
+
const errorMessageId = `${id}-error`;
|
|
100
|
+
|
|
101
|
+
// Filter DOM props
|
|
102
|
+
const domProps = () =>
|
|
103
|
+
filterDOMProps(getProps() as unknown as Record<string, unknown>, { labelable: true });
|
|
104
|
+
|
|
105
|
+
// Share data with child options
|
|
106
|
+
createEffect(() => {
|
|
107
|
+
selectData.set(state, { id });
|
|
108
|
+
|
|
109
|
+
onCleanup(() => {
|
|
110
|
+
selectData.delete(state);
|
|
111
|
+
});
|
|
112
|
+
});
|
|
113
|
+
|
|
114
|
+
// Label handling
|
|
115
|
+
const { labelProps, fieldProps } = createLabel({
|
|
116
|
+
get id() {
|
|
117
|
+
return buttonId;
|
|
118
|
+
},
|
|
119
|
+
get label() {
|
|
120
|
+
return getProps().label;
|
|
121
|
+
},
|
|
122
|
+
get 'aria-label'() {
|
|
123
|
+
return getProps()['aria-label'];
|
|
124
|
+
},
|
|
125
|
+
get 'aria-labelledby'() {
|
|
126
|
+
return getProps()['aria-labelledby'];
|
|
127
|
+
},
|
|
128
|
+
labelElementType: 'span',
|
|
129
|
+
});
|
|
130
|
+
|
|
131
|
+
// Focus ring for keyboard focus styling
|
|
132
|
+
const { isFocusVisible, focusProps } = createFocusRing({
|
|
133
|
+
get autoFocus() {
|
|
134
|
+
return getProps().autoFocus;
|
|
135
|
+
},
|
|
136
|
+
});
|
|
137
|
+
|
|
138
|
+
// Track focus state
|
|
139
|
+
const isFocused = state.isFocused;
|
|
140
|
+
|
|
141
|
+
// Handle press on trigger
|
|
142
|
+
const { pressProps } = createPress({
|
|
143
|
+
get isDisabled() {
|
|
144
|
+
return getProps().isDisabled ?? state.isDisabled;
|
|
145
|
+
},
|
|
146
|
+
onPress() {
|
|
147
|
+
state.toggle();
|
|
148
|
+
},
|
|
149
|
+
});
|
|
150
|
+
|
|
151
|
+
// Helper to check if key is disabled
|
|
152
|
+
const isKeyDisabled = (key: string | number): boolean => {
|
|
153
|
+
const collection = state.collection();
|
|
154
|
+
return state.isKeyDisabled?.(key) || collection.getItem(key)?.isDisabled || false;
|
|
155
|
+
};
|
|
156
|
+
|
|
157
|
+
// Helper to find the next non-disabled key.
|
|
158
|
+
const findNextKey = (fromKey: string | number | null, direction: 'forward' | 'backward'): string | number | null => {
|
|
159
|
+
const collection = state.collection();
|
|
160
|
+
const getAdjacent = direction === 'forward'
|
|
161
|
+
? (k: string | number) => collection.getKeyAfter(k)
|
|
162
|
+
: (k: string | number) => collection.getKeyBefore(k);
|
|
163
|
+
const getBoundary = direction === 'forward'
|
|
164
|
+
? () => collection.getFirstKey()
|
|
165
|
+
: () => collection.getLastKey();
|
|
166
|
+
|
|
167
|
+
let key = fromKey == null ? getBoundary() : getAdjacent(fromKey);
|
|
168
|
+
while (key != null && isKeyDisabled(key)) {
|
|
169
|
+
key = getAdjacent(key);
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
return key;
|
|
173
|
+
};
|
|
174
|
+
|
|
175
|
+
// Type-to-select - for Select, typing directly selects items when closed
|
|
176
|
+
const { typeSelectProps } = createTypeSelect({
|
|
177
|
+
collection: () => state.collection(),
|
|
178
|
+
focusedKey: () => state.selectedKey(), // Use selectedKey as the "focused" key for closed Select
|
|
179
|
+
onFocusedKeyChange: (key) => {
|
|
180
|
+
// When closed, type-to-select directly changes selection
|
|
181
|
+
if (!state.isOpen()) {
|
|
182
|
+
state.setSelectedKey(key);
|
|
183
|
+
} else {
|
|
184
|
+
// When open, update focused key (listbox handles selection)
|
|
185
|
+
state.setFocusedKey(key);
|
|
186
|
+
}
|
|
187
|
+
},
|
|
188
|
+
isKeyDisabled,
|
|
189
|
+
get isDisabled() {
|
|
190
|
+
return Boolean((getProps().disallowTypeAhead ?? false) || getProps().isDisabled || state.isDisabled);
|
|
191
|
+
},
|
|
192
|
+
});
|
|
193
|
+
|
|
194
|
+
// Keyboard navigation
|
|
195
|
+
const onKeyDown: JSX.EventHandler<HTMLElement, KeyboardEvent> = (e) => {
|
|
196
|
+
if (getProps().isDisabled ?? state.isDisabled) return;
|
|
197
|
+
|
|
198
|
+
const currentKey = state.focusedKey() ?? state.selectedKey();
|
|
199
|
+
|
|
200
|
+
switch (e.key) {
|
|
201
|
+
case 'Enter':
|
|
202
|
+
case ' ':
|
|
203
|
+
e.preventDefault();
|
|
204
|
+
state.toggle();
|
|
205
|
+
break;
|
|
206
|
+
|
|
207
|
+
case 'ArrowDown':
|
|
208
|
+
e.preventDefault();
|
|
209
|
+
if (!state.isOpen()) {
|
|
210
|
+
// ArrowDown: Open the dropdown and focus first/selected item
|
|
211
|
+
state.open();
|
|
212
|
+
const focusKey = currentKey != null && !isKeyDisabled(currentKey)
|
|
213
|
+
? currentKey
|
|
214
|
+
: findNextKey(currentKey, 'forward');
|
|
215
|
+
if (focusKey) {
|
|
216
|
+
state.setFocusedKey(focusKey);
|
|
217
|
+
}
|
|
218
|
+
}
|
|
219
|
+
// When open, navigation is handled by the listbox
|
|
220
|
+
break;
|
|
221
|
+
|
|
222
|
+
case 'ArrowUp':
|
|
223
|
+
e.preventDefault();
|
|
224
|
+
if (!state.isOpen()) {
|
|
225
|
+
// ArrowUp: Open the dropdown and focus last/selected item
|
|
226
|
+
state.open();
|
|
227
|
+
const focusKey = currentKey != null && !isKeyDisabled(currentKey)
|
|
228
|
+
? currentKey
|
|
229
|
+
: findNextKey(currentKey, 'backward');
|
|
230
|
+
if (focusKey) {
|
|
231
|
+
state.setFocusedKey(focusKey);
|
|
232
|
+
}
|
|
233
|
+
}
|
|
234
|
+
// When open, navigation is handled by the listbox
|
|
235
|
+
break;
|
|
236
|
+
|
|
237
|
+
case 'ArrowRight':
|
|
238
|
+
// ArrowRight: Select next option (for horizontal keyboard navigation pattern)
|
|
239
|
+
if (!state.isOpen()) {
|
|
240
|
+
e.preventDefault();
|
|
241
|
+
const nextKey = findNextKey(currentKey, 'forward');
|
|
242
|
+
if (nextKey != null) {
|
|
243
|
+
state.setSelectedKey(nextKey);
|
|
244
|
+
}
|
|
245
|
+
}
|
|
246
|
+
break;
|
|
247
|
+
|
|
248
|
+
case 'ArrowLeft':
|
|
249
|
+
// ArrowLeft: Select previous option (for horizontal keyboard navigation pattern)
|
|
250
|
+
if (!state.isOpen()) {
|
|
251
|
+
e.preventDefault();
|
|
252
|
+
const prevKey = findNextKey(currentKey, 'backward');
|
|
253
|
+
if (prevKey != null) {
|
|
254
|
+
state.setSelectedKey(prevKey);
|
|
255
|
+
}
|
|
256
|
+
}
|
|
257
|
+
break;
|
|
258
|
+
|
|
259
|
+
case 'Home':
|
|
260
|
+
// Home: Select first option
|
|
261
|
+
if (!state.isOpen()) {
|
|
262
|
+
e.preventDefault();
|
|
263
|
+
const firstKey = findNextKey(null, 'forward');
|
|
264
|
+
if (firstKey != null) {
|
|
265
|
+
state.setSelectedKey(firstKey);
|
|
266
|
+
}
|
|
267
|
+
}
|
|
268
|
+
break;
|
|
269
|
+
|
|
270
|
+
case 'End':
|
|
271
|
+
// End: Select last option
|
|
272
|
+
if (!state.isOpen()) {
|
|
273
|
+
e.preventDefault();
|
|
274
|
+
const lastKey = findNextKey(null, 'backward');
|
|
275
|
+
if (lastKey != null) {
|
|
276
|
+
state.setSelectedKey(lastKey);
|
|
277
|
+
}
|
|
278
|
+
}
|
|
279
|
+
break;
|
|
280
|
+
|
|
281
|
+
case 'Escape':
|
|
282
|
+
if (state.isOpen()) {
|
|
283
|
+
e.preventDefault();
|
|
284
|
+
state.close();
|
|
285
|
+
}
|
|
286
|
+
break;
|
|
287
|
+
}
|
|
288
|
+
};
|
|
289
|
+
|
|
290
|
+
// Handle focus events
|
|
291
|
+
const handleFocus = (e: FocusEvent) => {
|
|
292
|
+
state.setFocused(true);
|
|
293
|
+
getProps().onFocus?.(e);
|
|
294
|
+
getProps().onFocusChange?.(true);
|
|
295
|
+
};
|
|
296
|
+
|
|
297
|
+
const handleBlur = (e: FocusEvent) => {
|
|
298
|
+
state.setFocused(false);
|
|
299
|
+
getProps().onBlur?.(e);
|
|
300
|
+
getProps().onFocusChange?.(false);
|
|
301
|
+
};
|
|
302
|
+
|
|
303
|
+
return {
|
|
304
|
+
get labelProps() {
|
|
305
|
+
return labelProps as JSX.HTMLAttributes<HTMLElement>;
|
|
306
|
+
},
|
|
307
|
+
get triggerProps() {
|
|
308
|
+
const p = getProps();
|
|
309
|
+
const isOpen = state.isOpen();
|
|
310
|
+
const isDisabled = p.isDisabled ?? state.isDisabled;
|
|
311
|
+
|
|
312
|
+
const baseProps = mergeProps(
|
|
313
|
+
domProps(),
|
|
314
|
+
pressProps as Record<string, unknown>,
|
|
315
|
+
focusProps as Record<string, unknown>,
|
|
316
|
+
fieldProps as Record<string, unknown>,
|
|
317
|
+
{
|
|
318
|
+
id: buttonId,
|
|
319
|
+
role: 'combobox',
|
|
320
|
+
type: 'button',
|
|
321
|
+
tabIndex: isDisabled ? undefined : 0,
|
|
322
|
+
'aria-haspopup': 'listbox',
|
|
323
|
+
'aria-expanded': isOpen,
|
|
324
|
+
'aria-controls': isOpen ? listBoxId : undefined,
|
|
325
|
+
'aria-disabled': isDisabled || undefined,
|
|
326
|
+
'aria-required': p.isRequired || undefined,
|
|
327
|
+
'aria-describedby': p['aria-describedby'] || undefined,
|
|
328
|
+
onKeyDown,
|
|
329
|
+
onFocus: handleFocus,
|
|
330
|
+
onBlur: handleBlur,
|
|
331
|
+
'data-open': isOpen || undefined,
|
|
332
|
+
'data-disabled': isDisabled || undefined,
|
|
333
|
+
'data-focus-visible': isFocusVisible() || undefined,
|
|
334
|
+
} as Record<string, unknown>
|
|
335
|
+
);
|
|
336
|
+
|
|
337
|
+
// Add type-select props if enabled
|
|
338
|
+
if (!p.disallowTypeAhead) {
|
|
339
|
+
return mergeProps(baseProps, typeSelectProps as Record<string, unknown>) as JSX.HTMLAttributes<HTMLElement>;
|
|
340
|
+
}
|
|
341
|
+
|
|
342
|
+
return baseProps as JSX.HTMLAttributes<HTMLElement>;
|
|
343
|
+
},
|
|
344
|
+
get valueProps() {
|
|
345
|
+
return {
|
|
346
|
+
id: valueId,
|
|
347
|
+
} as JSX.HTMLAttributes<HTMLElement>;
|
|
348
|
+
},
|
|
349
|
+
get menuProps() {
|
|
350
|
+
return {
|
|
351
|
+
id: listBoxId,
|
|
352
|
+
role: 'listbox',
|
|
353
|
+
'aria-labelledby': buttonId,
|
|
354
|
+
'aria-multiselectable': state.selectionMode() === 'multiple' ? true : undefined,
|
|
355
|
+
tabIndex: -1,
|
|
356
|
+
} as JSX.HTMLAttributes<HTMLElement>;
|
|
357
|
+
},
|
|
358
|
+
get descriptionProps() {
|
|
359
|
+
return {
|
|
360
|
+
id: descriptionId,
|
|
361
|
+
} as JSX.HTMLAttributes<HTMLElement>;
|
|
362
|
+
},
|
|
363
|
+
get errorMessageProps() {
|
|
364
|
+
return {
|
|
365
|
+
id: errorMessageId,
|
|
366
|
+
} as JSX.HTMLAttributes<HTMLElement>;
|
|
367
|
+
},
|
|
368
|
+
isFocused,
|
|
369
|
+
isFocusVisible: () => isFocused() && isFocusVisible(),
|
|
370
|
+
isOpen: state.isOpen,
|
|
371
|
+
selectedItem: state.selectedItem,
|
|
372
|
+
};
|
|
373
|
+
}
|