@olenbetong/appframe-ds 1.3.6 → 1.3.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.
Files changed (179) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/package.json +6 -6
  3. package/scripts/copyAssets.mjs +27 -27
  4. package/src/AfLookup/Lookup.css +130 -129
  5. package/src/AfLookup/Lookup.tsx +186 -186
  6. package/src/AfLookup/LookupCombobox.css +72 -78
  7. package/src/AfLookup/LookupCombobox.tsx +237 -237
  8. package/src/AfLookup/LookupEdit.tsx +130 -130
  9. package/src/AfLookup/LookupGrid.css +7 -12
  10. package/src/AfLookup/LookupGrid.tsx +124 -124
  11. package/src/AfLookup/index.ts +5 -5
  12. package/src/autocomplete/Autocomplete.css +256 -256
  13. package/src/autocomplete/Autocomplete.tsx +320 -320
  14. package/src/autocomplete/AutocompleteFrame.tsx +168 -168
  15. package/src/autocomplete/Combobox.tsx +286 -286
  16. package/src/autocomplete/index.ts +4 -4
  17. package/src/autocomplete/types.ts +204 -204
  18. package/src/autocomplete/utils.ts +183 -183
  19. package/src/binding/BoundNumericTextField.tsx +102 -102
  20. package/src/binding/BoundTextField.tsx +49 -49
  21. package/src/binding/CancelButton.tsx +30 -30
  22. package/src/binding/CancelIconButton.tsx +30 -30
  23. package/src/binding/DataEditToolbar.css +23 -23
  24. package/src/binding/DataEditToolbar.tsx +84 -84
  25. package/src/binding/DeleteButton.tsx +35 -35
  26. package/src/binding/DeleteIconButton.tsx +35 -35
  27. package/src/binding/RefreshButton.tsx +31 -31
  28. package/src/binding/RefreshIconButton.tsx +33 -33
  29. package/src/binding/RefreshRowIconButton.tsx +33 -33
  30. package/src/binding/SaveButton.tsx +37 -37
  31. package/src/binding/SaveIconButton.tsx +38 -38
  32. package/src/container/Container.tsx +50 -49
  33. package/src/container/index.ts +1 -1
  34. package/src/cutoff/CutOffPicker.css +12 -12
  35. package/src/cutoff/CutOffPicker.tsx +165 -165
  36. package/src/cutoff/context.tsx +194 -194
  37. package/src/cutoff/dsCutOffDates.ts +21 -21
  38. package/src/cutoff/index.ts +4 -4
  39. package/src/cutoff/utils.test.ts +59 -59
  40. package/src/cutoff/utils.ts +276 -276
  41. package/src/filter/ChipListInput.tsx +79 -79
  42. package/src/filter/FieldFilterPanel.css +150 -150
  43. package/src/filter/FieldFilterPanel.tsx +309 -309
  44. package/src/filter/FilterBuilder.css +152 -152
  45. package/src/filter/FilterBuilder.test.tsx +153 -153
  46. package/src/filter/FilterBuilder.tsx +435 -435
  47. package/src/filter/FilterEditor.css +231 -231
  48. package/src/filter/FilterEditor.test.tsx +285 -285
  49. package/src/filter/FilterEditor.tsx +75 -75
  50. package/src/filter/FilterGroupEditor.tsx +160 -160
  51. package/src/filter/FilterNameDialog.css +22 -22
  52. package/src/filter/FilterNameDialog.tsx +81 -81
  53. package/src/filter/FilterRow.tsx +117 -117
  54. package/src/filter/FilterShareDialog.css +28 -28
  55. package/src/filter/FilterShareDialog.tsx +201 -201
  56. package/src/filter/FilterStringField.tsx +78 -78
  57. package/src/filter/FilterValueEditor.tsx +239 -239
  58. package/src/filter/SavedFilterTree.css +107 -107
  59. package/src/filter/SavedFilterTree.test.tsx +94 -94
  60. package/src/filter/SavedFilterTree.tsx +218 -218
  61. package/src/filter/fieldFilter.test.ts +158 -158
  62. package/src/filter/fieldFilter.ts +139 -139
  63. package/src/filter/index.ts +27 -27
  64. package/src/filter/types.ts +38 -38
  65. package/src/filter/useDistinctValues.test.ts +102 -102
  66. package/src/filter/useDistinctValues.ts +230 -230
  67. package/src/global.d.ts +11 -11
  68. package/src/grid/AfGridColumnsPanel.tsx +118 -118
  69. package/src/grid/AfGridContext.tsx +51 -51
  70. package/src/grid/AfGridError.tsx +46 -46
  71. package/src/grid/AfHeaderFilterCell.tsx +147 -147
  72. package/src/grid/AfHeaderFilterPanel.tsx +111 -111
  73. package/src/grid/GridEditLookup.css +12 -12
  74. package/src/grid/GridEditLookup.tsx +121 -121
  75. package/src/grid/Toolbar.tsx +233 -233
  76. package/src/grid/editing.ts +100 -100
  77. package/src/grid/filter.ts +78 -78
  78. package/src/grid/formatters.ts +48 -48
  79. package/src/grid/index.css +245 -245
  80. package/src/grid/index.tsx +503 -503
  81. package/src/grid/license.ts +48 -48
  82. package/src/grid/localization.ts +369 -369
  83. package/src/grid/slots/index.tsx +334 -334
  84. package/src/grid/slots/slots.css +64 -64
  85. package/src/grid/slots/slots.test.tsx +39 -39
  86. package/src/grid/theme.tsx +138 -138
  87. package/src/grid/useAfColumns.tsx +371 -371
  88. package/src/grid/useAfCurrentIndex.ts +63 -63
  89. package/src/grid/useAfData.ts +20 -20
  90. package/src/grid/useAfFilter.ts +160 -160
  91. package/src/grid/useAfFilterFields.ts +55 -55
  92. package/src/grid/useAfGridApi.ts +71 -71
  93. package/src/grid/useAfKeyBindings.ts +36 -36
  94. package/src/grid/useAfNewItemRow.ts +258 -258
  95. package/src/grid/useAfPagination.ts +53 -53
  96. package/src/grid/useAfPersistedState.ts +230 -230
  97. package/src/grid/useAfRowEditModel.ts +145 -145
  98. package/src/grid/useAfRowGrouping.ts +47 -47
  99. package/src/grid/useAfServerAggregation.test.ts +68 -68
  100. package/src/grid/useAfServerAggregation.ts +158 -158
  101. package/src/grid/useAfSortModel.ts +84 -84
  102. package/src/i18n.ts +13 -13
  103. package/src/index.ts +14 -14
  104. package/src/input/InputAdornments.css +84 -84
  105. package/src/input/InputAdornments.tsx +102 -102
  106. package/src/input/index.ts +1 -1
  107. package/src/layout/AppMenu.tsx +74 -74
  108. package/src/layout/AppMenuDrawer.css +70 -70
  109. package/src/layout/AppMenuDrawer.tsx +122 -122
  110. package/src/layout/ErrorBoundary.tsx +162 -162
  111. package/src/layout/PageContainer.css +48 -48
  112. package/src/layout/PageContainer.tsx +41 -41
  113. package/src/layout/ResponsiveDialog.css +86 -86
  114. package/src/layout/ResponsiveDialog.tsx +55 -55
  115. package/src/layout/index.tsx +69 -69
  116. package/src/link/Link.tsx +23 -23
  117. package/src/link/index.ts +1 -1
  118. package/src/mdi/Mdi.css +138 -138
  119. package/src/mdi/Mdi.test.tsx +91 -91
  120. package/src/mdi/Mdi.tsx +141 -141
  121. package/src/mdi/MdiConfirmCloseDialog.tsx +47 -47
  122. package/src/mdi/MdiContext.tsx +59 -59
  123. package/src/mdi/MdiDocumentContext.tsx +60 -60
  124. package/src/mdi/MdiPanel.tsx +61 -61
  125. package/src/mdi/MdiRestore.test.tsx +86 -86
  126. package/src/mdi/MdiTab.tsx +30 -30
  127. package/src/mdi/controller.test.ts +382 -382
  128. package/src/mdi/controller.ts +656 -656
  129. package/src/mdi/dockviewHost.ts +132 -132
  130. package/src/mdi/fakeHost.ts +200 -200
  131. package/src/mdi/host.ts +44 -44
  132. package/src/mdi/ids.test.ts +20 -20
  133. package/src/mdi/ids.ts +18 -18
  134. package/src/mdi/index.ts +31 -31
  135. package/src/mdi/layoutRestore.test.ts +156 -156
  136. package/src/mdi/layoutRestore.ts +311 -311
  137. package/src/mdi/layoutSpec.test.ts +143 -143
  138. package/src/mdi/layoutSpec.ts +214 -214
  139. package/src/mdi/layoutStore.test.ts +93 -93
  140. package/src/mdi/layoutStore.ts +99 -99
  141. package/src/mdi/memorySettingsStore.ts +21 -21
  142. package/src/mdi/registry.ts +34 -34
  143. package/src/mdi/testTypes.ts +37 -37
  144. package/src/mdi/theme.ts +22 -22
  145. package/src/mdi/types.ts +214 -214
  146. package/src/page/Page.css +53 -53
  147. package/src/page/PageBlock.css +64 -64
  148. package/src/page/PageBlock.tsx +93 -92
  149. package/src/page/PageHeader.css +88 -88
  150. package/src/page/PageHeader.tsx +115 -115
  151. package/src/page/PageTitle.css +5 -5
  152. package/src/page/PageTitle.tsx +21 -21
  153. package/src/page/index.ts +4 -4
  154. package/src/paper/Paper.tsx +52 -52
  155. package/src/progress/LinearProgress.css +93 -93
  156. package/src/progress/LinearProgress.tsx +104 -104
  157. package/src/progress/index.ts +1 -1
  158. package/src/report-downloader/ReportDownloader.css +67 -67
  159. package/src/report-downloader/components/StatusItem.tsx +87 -87
  160. package/src/report-downloader/components/StatusList.tsx +28 -28
  161. package/src/report-downloader/index.ts +41 -41
  162. package/src/report-downloader/status.tsx +92 -92
  163. package/src/sortable/DropIndicator.css +51 -51
  164. package/src/sortable/DropIndicator.tsx +27 -27
  165. package/src/sortable/SortableItemList.css +21 -21
  166. package/src/sortable/SortableItemList.tsx +264 -264
  167. package/src/sortable/index.ts +8 -8
  168. package/src/sortable/reorderSortOrder.ts +126 -126
  169. package/src/sortable/sortOrder.ts +101 -101
  170. package/src/sortable/types.ts +9 -9
  171. package/src/sortable/useSortableContainer.ts +53 -53
  172. package/src/sortable/useSortableItem.ts +95 -95
  173. package/src/sortable/useSortableList.ts +117 -117
  174. package/src/test/happy-dom-document-class.ts +24 -24
  175. package/src/test/setup.ts +12 -12
  176. package/src/theme/useDsColorScheme.ts +53 -53
  177. package/tsconfig.build.json +9 -9
  178. package/tsconfig.json +8 -8
  179. package/vitest.config.ts +10 -10
@@ -1,21 +1,21 @@
1
- .ObSortableItemList-item {
2
- position: relative;
3
-
4
- &.ObSortableItemList-dragging {
5
- outline: 3px dashed;
6
- outline-offset: -3px;
7
- }
8
- }
9
-
10
- .ObSortableItemList-handle {
11
- cursor: grab;
12
- flex-shrink: 0;
13
- }
14
-
15
- .ObSortableItemList-handle:active {
16
- cursor: grabbing;
17
- }
18
-
19
- .ObSortableItemList-empty {
20
- color: var(--ds-color-neutral-text-subtle, #666);
21
- }
1
+ .ObSortableItemList-item {
2
+ position: relative;
3
+
4
+ &.ObSortableItemList-dragging {
5
+ outline: 3px dashed;
6
+ outline-offset: -3px;
7
+ }
8
+ }
9
+
10
+ .ObSortableItemList-handle {
11
+ cursor: grab;
12
+ flex-shrink: 0;
13
+ }
14
+
15
+ .ObSortableItemList-handle:active {
16
+ cursor: grabbing;
17
+ }
18
+
19
+ .ObSortableItemList-empty {
20
+ color: var(--ds-color-neutral-text-subtle, #666);
21
+ }
@@ -1,264 +1,264 @@
1
- import "./SortableItemList.css";
2
-
3
- import { Button, Dropdown } from "@digdir/designsystemet-react";
4
- import { DragVerticalIcon } from "@navikt/aksel-icons";
5
- import clsx from "clsx";
6
- import type React from "react";
7
- import { createContext, useContext, useId, useRef } from "react";
8
-
9
- import { ItemList } from "../list/ItemList.js";
10
- import { Paper } from "../paper/Paper.js";
11
- import { DropIndicator } from "./DropIndicator.js";
12
- import type { SortableRecord } from "./types.js";
13
- import { type SortableItemState, useSortableItem } from "./useSortableItem.js";
14
- import { type SortableList, type SortableListOptions, useSortableList } from "./useSortableList.js";
15
- import { getLocalizedString } from "../i18n.js";
16
-
17
- export interface SortableItemContextValue<T extends SortableRecord = SortableRecord> {
18
- record: T;
19
- /** Index of the record in the sorted list */
20
- index: number;
21
- /** Number of records in the list */
22
- count: number;
23
- /** Records in the list, sorted by `SortOrder` */
24
- records: T[];
25
- /** Current drag state of the item */
26
- state: SortableItemState;
27
- /** Element that starts the drag. Attach with `<SortableItemList.DragHandle />` */
28
- handleRef: React.RefObject<HTMLButtonElement | null>;
29
- enabled: boolean;
30
- moveItem: SortableList<T>["moveItem"];
31
- /** Moves the item one step up, to the top, one step down or to the bottom */
32
- moveTo: (position: "top" | "up" | "down" | "bottom") => Promise<void>;
33
- }
34
-
35
- const SortableItemContext = createContext<SortableItemContextValue | null>(null);
36
-
37
- /**
38
- * Gives access to the state of the surrounding sortable item, e.g. to
39
- * suppress click handlers while the item is being dragged.
40
- */
41
- export function useSortableItemContext<T extends SortableRecord = SortableRecord>(): SortableItemContextValue<T> {
42
- let context = useContext(SortableItemContext);
43
- if (!context) {
44
- throw new Error("useSortableItemContext must be used inside a SortableItemList item");
45
- }
46
-
47
- return context as SortableItemContextValue<T>;
48
- }
49
-
50
- export type SortableDragHandleProps = Omit<React.ComponentProps<typeof Button>, "ref" | "icon"> & {
51
- /** Accessible label for the handle */
52
- label?: string;
53
- /**
54
- * Adds a menu with move up/down/top/bottom actions, so the list can be
55
- * reordered without a pointer.
56
- * @default true
57
- */
58
- menu?: boolean;
59
- children?: React.ReactNode;
60
- };
61
-
62
- /**
63
- * Drag handle for a `SortableItemList` item. Dragging is only started from
64
- * this element, so the rest of the item stays clickable. By default it also
65
- * opens a menu with keyboard accessible move actions.
66
- */
67
- export function SortableDragHandle({
68
- label,
69
- menu = true,
70
- children,
71
- className,
72
- disabled,
73
- ...props
74
- }: SortableDragHandleProps) {
75
- let { handleRef, index, count, enabled, moveTo } = useSortableItemContext();
76
- let dropdownId = useId();
77
- let isDisabled = disabled || !enabled;
78
-
79
- return (
80
- <>
81
- <Button
82
- ref={handleRef}
83
- icon
84
- variant="tertiary"
85
- data-color="neutral"
86
- className={clsx("ObSortableItemList-handle", className)}
87
- aria-label={label ?? getLocalizedString("Change order")}
88
- disabled={isDisabled}
89
- popoverTarget={menu && !isDisabled ? dropdownId : undefined}
90
- {...props}
91
- >
92
- {children ?? <DragVerticalIcon aria-hidden />}
93
- </Button>
94
- {menu && !isDisabled && (
95
- <Dropdown id={dropdownId}>
96
- <Dropdown.List>
97
- <Dropdown.Item>
98
- <Dropdown.Button disabled={index === 0} onClick={() => moveTo("top")}>
99
- {getLocalizedString("Move to top")}
100
- </Dropdown.Button>
101
- </Dropdown.Item>
102
- <Dropdown.Item>
103
- <Dropdown.Button disabled={index === 0} onClick={() => moveTo("up")}>
104
- {getLocalizedString("Move up")}
105
- </Dropdown.Button>
106
- </Dropdown.Item>
107
- <Dropdown.Item>
108
- <Dropdown.Button disabled={index === count - 1} onClick={() => moveTo("down")}>
109
- {getLocalizedString("Move down")}
110
- </Dropdown.Button>
111
- </Dropdown.Item>
112
- <Dropdown.Item>
113
- <Dropdown.Button disabled={index === count - 1} onClick={() => moveTo("bottom")}>
114
- {getLocalizedString("Move to bottom")}
115
- </Dropdown.Button>
116
- </Dropdown.Item>
117
- </Dropdown.List>
118
- </Dropdown>
119
- )}
120
- </>
121
- );
122
- }
123
-
124
- function SortableItem<T extends SortableRecord>({
125
- record,
126
- index,
127
- list,
128
- className,
129
- indicatorGap,
130
- children,
131
- }: {
132
- record: T;
133
- index: number;
134
- list: SortableList<T>;
135
- className?: string;
136
- indicatorGap?: string;
137
- children: (context: SortableItemContextValue<T>) => React.ReactNode;
138
- }) {
139
- let itemRef = useRef<HTMLElement>(null);
140
- let handleRef = useRef<HTMLButtonElement>(null);
141
- let { records, moveItem, enabled, type } = list;
142
- let state = useSortableItem({ type, record, itemRef, handleRef, enabled });
143
-
144
- async function moveTo(position: "top" | "up" | "down" | "bottom") {
145
- let target =
146
- position === "top"
147
- ? records[0]
148
- : position === "up"
149
- ? records[index - 1]
150
- : position === "down"
151
- ? records[index + 1]
152
- : records[records.length - 1];
153
- if (!target || target.PrimKey === record.PrimKey) return;
154
-
155
- await moveItem(record.PrimKey, target.PrimKey, position === "top" || position === "up" ? null : "bottom");
156
- }
157
-
158
- let context: SortableItemContextValue<T> = {
159
- record,
160
- index,
161
- count: records.length,
162
- records,
163
- state,
164
- handleRef,
165
- enabled,
166
- moveItem,
167
- moveTo,
168
- };
169
-
170
- return (
171
- <SortableItemContext.Provider value={context as SortableItemContextValue}>
172
- <ItemList.Item
173
- ref={itemRef}
174
- className={clsx(
175
- "ObSortableItemList-item",
176
- state.type === "is-dragging" && "ObSortableItemList-dragging",
177
- className,
178
- )}
179
- >
180
- {children(context)}
181
- {state.type === "is-dragging-over" && state.edge && <DropIndicator edge={state.edge} gap={indicatorGap} />}
182
- </ItemList.Item>
183
- </SortableItemContext.Provider>
184
- );
185
- }
186
-
187
- export type SortableItemListProps<T extends SortableRecord> = SortableListOptions<T> & {
188
- /** Renders the content of a single item. Include a `<SortableItemList.DragHandle />` to allow dragging */
189
- children: (record: T, context: SortableItemContextValue<T>) => React.ReactNode;
190
- /** Rendered instead of the items when the list is empty */
191
- empty?: React.ReactNode;
192
- /** Wraps the list in a `Paper` surface @default true */
193
- paper?: boolean;
194
- /** Renders a divider between items @default true */
195
- dividers?: boolean;
196
- className?: string;
197
- /** Class name added to every item */
198
- itemClassName?: string;
199
- /** Distance between the drop indicator and the item edge, when items have a gap */
200
- indicatorGap?: string;
201
- };
202
-
203
- function SortableItemListComponent<T extends SortableRecord>({
204
- children,
205
- empty,
206
- paper = true,
207
- dividers = true,
208
- className,
209
- itemClassName,
210
- indicatorGap,
211
- ...options
212
- }: SortableItemListProps<T>) {
213
- let list = useSortableList<T>(options);
214
-
215
- let items = list.records.map((record, index) => (
216
- <SortableItem
217
- key={record.PrimKey}
218
- record={record}
219
- index={index}
220
- list={list}
221
- className={itemClassName}
222
- indicatorGap={indicatorGap}
223
- >
224
- {(context) => children(record, context)}
225
- </SortableItem>
226
- ));
227
-
228
- let content = list.records.length === 0 && empty ? <li className="ObSortableItemList-empty">{empty}</li> : items;
229
-
230
- let listElement = (
231
- <ItemList dividers={dividers} className={paper ? undefined : className}>
232
- {content}
233
- </ItemList>
234
- );
235
-
236
- return paper ? <Paper className={className}>{listElement}</Paper> : listElement;
237
- }
238
-
239
- /**
240
- * `ItemList` bound to a data object, where the items can be reordered by
241
- * dragging them or through the menu on the drag handle. The list is sorted by
242
- * the `SortOrder` column, and dropping an item writes a new sort order between
243
- * its new neighbours through the data object.
244
- *
245
- * @example
246
- * ```jsx
247
- * <SortableItemList
248
- * dataObject={dsRelatedProducts}
249
- * filter={(record) => record.ProductRef === productRef}
250
- * empty={<Paragraph>No related products added yet.</Paragraph>}
251
- * >
252
- * {(record) => (
253
- * <>
254
- * <SortableItemList.DragHandle label="Change related product order" />
255
- * <ItemList.ItemText primary={record.Title} secondary={record.Slug} />
256
- * </>
257
- * )}
258
- * </SortableItemList>
259
- * ```
260
- */
261
- export const SortableItemList = Object.assign(SortableItemListComponent, {
262
- DragHandle: SortableDragHandle,
263
- ItemText: ItemList.ItemText,
264
- });
1
+ import "./SortableItemList.css";
2
+
3
+ import { Button, Dropdown } from "@digdir/designsystemet-react";
4
+ import { DragVerticalIcon } from "@navikt/aksel-icons";
5
+ import clsx from "clsx";
6
+ import type React from "react";
7
+ import { createContext, useContext, useId, useRef } from "react";
8
+
9
+ import { ItemList } from "../list/ItemList.js";
10
+ import { Paper } from "../paper/Paper.js";
11
+ import { DropIndicator } from "./DropIndicator.js";
12
+ import type { SortableRecord } from "./types.js";
13
+ import { type SortableItemState, useSortableItem } from "./useSortableItem.js";
14
+ import { type SortableList, type SortableListOptions, useSortableList } from "./useSortableList.js";
15
+ import { getLocalizedString } from "../i18n.js";
16
+
17
+ export interface SortableItemContextValue<T extends SortableRecord = SortableRecord> {
18
+ record: T;
19
+ /** Index of the record in the sorted list */
20
+ index: number;
21
+ /** Number of records in the list */
22
+ count: number;
23
+ /** Records in the list, sorted by `SortOrder` */
24
+ records: T[];
25
+ /** Current drag state of the item */
26
+ state: SortableItemState;
27
+ /** Element that starts the drag. Attach with `<SortableItemList.DragHandle />` */
28
+ handleRef: React.RefObject<HTMLButtonElement | null>;
29
+ enabled: boolean;
30
+ moveItem: SortableList<T>["moveItem"];
31
+ /** Moves the item one step up, to the top, one step down or to the bottom */
32
+ moveTo: (position: "top" | "up" | "down" | "bottom") => Promise<void>;
33
+ }
34
+
35
+ const SortableItemContext = createContext<SortableItemContextValue | null>(null);
36
+
37
+ /**
38
+ * Gives access to the state of the surrounding sortable item, e.g. to
39
+ * suppress click handlers while the item is being dragged.
40
+ */
41
+ export function useSortableItemContext<T extends SortableRecord = SortableRecord>(): SortableItemContextValue<T> {
42
+ let context = useContext(SortableItemContext);
43
+ if (!context) {
44
+ throw new Error("useSortableItemContext must be used inside a SortableItemList item");
45
+ }
46
+
47
+ return context as SortableItemContextValue<T>;
48
+ }
49
+
50
+ export type SortableDragHandleProps = Omit<React.ComponentProps<typeof Button>, "ref" | "icon"> & {
51
+ /** Accessible label for the handle */
52
+ label?: string;
53
+ /**
54
+ * Adds a menu with move up/down/top/bottom actions, so the list can be
55
+ * reordered without a pointer.
56
+ * @default true
57
+ */
58
+ menu?: boolean;
59
+ children?: React.ReactNode;
60
+ };
61
+
62
+ /**
63
+ * Drag handle for a `SortableItemList` item. Dragging is only started from
64
+ * this element, so the rest of the item stays clickable. By default it also
65
+ * opens a menu with keyboard accessible move actions.
66
+ */
67
+ export function SortableDragHandle({
68
+ label,
69
+ menu = true,
70
+ children,
71
+ className,
72
+ disabled,
73
+ ...props
74
+ }: SortableDragHandleProps) {
75
+ let { handleRef, index, count, enabled, moveTo } = useSortableItemContext();
76
+ let dropdownId = useId();
77
+ let isDisabled = disabled || !enabled;
78
+
79
+ return (
80
+ <>
81
+ <Button
82
+ ref={handleRef}
83
+ icon
84
+ variant="tertiary"
85
+ data-color="neutral"
86
+ className={clsx("ObSortableItemList-handle", className)}
87
+ aria-label={label ?? getLocalizedString("Change order")}
88
+ disabled={isDisabled}
89
+ popoverTarget={menu && !isDisabled ? dropdownId : undefined}
90
+ {...props}
91
+ >
92
+ {children ?? <DragVerticalIcon aria-hidden />}
93
+ </Button>
94
+ {menu && !isDisabled && (
95
+ <Dropdown id={dropdownId}>
96
+ <Dropdown.List>
97
+ <Dropdown.Item>
98
+ <Dropdown.Button disabled={index === 0} onClick={() => moveTo("top")}>
99
+ {getLocalizedString("Move to top")}
100
+ </Dropdown.Button>
101
+ </Dropdown.Item>
102
+ <Dropdown.Item>
103
+ <Dropdown.Button disabled={index === 0} onClick={() => moveTo("up")}>
104
+ {getLocalizedString("Move up")}
105
+ </Dropdown.Button>
106
+ </Dropdown.Item>
107
+ <Dropdown.Item>
108
+ <Dropdown.Button disabled={index === count - 1} onClick={() => moveTo("down")}>
109
+ {getLocalizedString("Move down")}
110
+ </Dropdown.Button>
111
+ </Dropdown.Item>
112
+ <Dropdown.Item>
113
+ <Dropdown.Button disabled={index === count - 1} onClick={() => moveTo("bottom")}>
114
+ {getLocalizedString("Move to bottom")}
115
+ </Dropdown.Button>
116
+ </Dropdown.Item>
117
+ </Dropdown.List>
118
+ </Dropdown>
119
+ )}
120
+ </>
121
+ );
122
+ }
123
+
124
+ function SortableItem<T extends SortableRecord>({
125
+ record,
126
+ index,
127
+ list,
128
+ className,
129
+ indicatorGap,
130
+ children,
131
+ }: {
132
+ record: T;
133
+ index: number;
134
+ list: SortableList<T>;
135
+ className?: string;
136
+ indicatorGap?: string;
137
+ children: (context: SortableItemContextValue<T>) => React.ReactNode;
138
+ }) {
139
+ let itemRef = useRef<HTMLElement>(null);
140
+ let handleRef = useRef<HTMLButtonElement>(null);
141
+ let { records, moveItem, enabled, type } = list;
142
+ let state = useSortableItem({ type, record, itemRef, handleRef, enabled });
143
+
144
+ async function moveTo(position: "top" | "up" | "down" | "bottom") {
145
+ let target =
146
+ position === "top"
147
+ ? records[0]
148
+ : position === "up"
149
+ ? records[index - 1]
150
+ : position === "down"
151
+ ? records[index + 1]
152
+ : records[records.length - 1];
153
+ if (!target || target.PrimKey === record.PrimKey) return;
154
+
155
+ await moveItem(record.PrimKey, target.PrimKey, position === "top" || position === "up" ? null : "bottom");
156
+ }
157
+
158
+ let context: SortableItemContextValue<T> = {
159
+ record,
160
+ index,
161
+ count: records.length,
162
+ records,
163
+ state,
164
+ handleRef,
165
+ enabled,
166
+ moveItem,
167
+ moveTo,
168
+ };
169
+
170
+ return (
171
+ <SortableItemContext.Provider value={context as SortableItemContextValue}>
172
+ <ItemList.Item
173
+ ref={itemRef}
174
+ className={clsx(
175
+ "ObSortableItemList-item",
176
+ state.type === "is-dragging" && "ObSortableItemList-dragging",
177
+ className,
178
+ )}
179
+ >
180
+ {children(context)}
181
+ {state.type === "is-dragging-over" && state.edge && <DropIndicator edge={state.edge} gap={indicatorGap} />}
182
+ </ItemList.Item>
183
+ </SortableItemContext.Provider>
184
+ );
185
+ }
186
+
187
+ export type SortableItemListProps<T extends SortableRecord> = SortableListOptions<T> & {
188
+ /** Renders the content of a single item. Include a `<SortableItemList.DragHandle />` to allow dragging */
189
+ children: (record: T, context: SortableItemContextValue<T>) => React.ReactNode;
190
+ /** Rendered instead of the items when the list is empty */
191
+ empty?: React.ReactNode;
192
+ /** Wraps the list in a `Paper` surface @default true */
193
+ paper?: boolean;
194
+ /** Renders a divider between items @default true */
195
+ dividers?: boolean;
196
+ className?: string;
197
+ /** Class name added to every item */
198
+ itemClassName?: string;
199
+ /** Distance between the drop indicator and the item edge, when items have a gap */
200
+ indicatorGap?: string;
201
+ };
202
+
203
+ function SortableItemListComponent<T extends SortableRecord>({
204
+ children,
205
+ empty,
206
+ paper = true,
207
+ dividers = true,
208
+ className,
209
+ itemClassName,
210
+ indicatorGap,
211
+ ...options
212
+ }: SortableItemListProps<T>) {
213
+ let list = useSortableList<T>(options);
214
+
215
+ let items = list.records.map((record, index) => (
216
+ <SortableItem
217
+ key={record.PrimKey}
218
+ record={record}
219
+ index={index}
220
+ list={list}
221
+ className={itemClassName}
222
+ indicatorGap={indicatorGap}
223
+ >
224
+ {(context) => children(record, context)}
225
+ </SortableItem>
226
+ ));
227
+
228
+ let content = list.records.length === 0 && empty ? <li className="ObSortableItemList-empty">{empty}</li> : items;
229
+
230
+ let listElement = (
231
+ <ItemList dividers={dividers} className={paper ? undefined : className}>
232
+ {content}
233
+ </ItemList>
234
+ );
235
+
236
+ return paper ? <Paper className={className}>{listElement}</Paper> : listElement;
237
+ }
238
+
239
+ /**
240
+ * `ItemList` bound to a data object, where the items can be reordered by
241
+ * dragging them or through the menu on the drag handle. The list is sorted by
242
+ * the `SortOrder` column, and dropping an item writes a new sort order between
243
+ * its new neighbours through the data object.
244
+ *
245
+ * @example
246
+ * ```jsx
247
+ * <SortableItemList
248
+ * dataObject={dsRelatedProducts}
249
+ * filter={(record) => record.ProductRef === productRef}
250
+ * empty={<Paragraph>No related products added yet.</Paragraph>}
251
+ * >
252
+ * {(record) => (
253
+ * <>
254
+ * <SortableItemList.DragHandle label="Change related product order" />
255
+ * <ItemList.ItemText primary={record.Title} secondary={record.Slug} />
256
+ * </>
257
+ * )}
258
+ * </SortableItemList>
259
+ * ```
260
+ */
261
+ export const SortableItemList = Object.assign(SortableItemListComponent, {
262
+ DragHandle: SortableDragHandle,
263
+ ItemText: ItemList.ItemText,
264
+ });
@@ -1,8 +1,8 @@
1
- export * from "./DropIndicator.js";
2
- export * from "./SortableItemList.js";
3
- export * from "./reorderSortOrder.js";
4
- export * from "./sortOrder.js";
5
- export * from "./types.js";
6
- export * from "./useSortableContainer.js";
7
- export * from "./useSortableItem.js";
8
- export * from "./useSortableList.js";
1
+ export * from "./DropIndicator.js";
2
+ export * from "./SortableItemList.js";
3
+ export * from "./reorderSortOrder.js";
4
+ export * from "./sortOrder.js";
5
+ export * from "./types.js";
6
+ export * from "./useSortableContainer.js";
7
+ export * from "./useSortableItem.js";
8
+ export * from "./useSortableList.js";