@rock555/frontend-core 2.0.2 → 2.0.3
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/README.md +95 -95
- package/package.json +98 -98
- package/src/components/GlobalPendingBar.vue +85 -85
- package/src/components/SearchPicker.vue +84 -84
- package/src/components/filters/DateRangeField.vue +692 -692
- package/src/components/filters/ExportCsvButton.vue +60 -60
- package/src/components/filters/FiltersBar.vue +150 -150
- package/src/components/filters/MonthField.vue +309 -309
- package/src/components/filters/SortControl.vue +162 -162
- package/src/components/filters/SortControlPanel.vue +242 -242
- package/src/components/filters/sortControl.types.ts +25 -25
- package/src/components/modals/ConfirmModal.vue +58 -58
- package/src/components/modals/ImageViewerModal.vue +200 -200
- package/src/components/tables/MultiSortHeader.vue +126 -126
- package/src/components/tables/TableBodyRow.vue +62 -62
- package/src/components/tables/TableFooterRow.vue +54 -54
- package/src/components/tables/TableHeaderRow.vue +75 -75
- package/src/components/tables/TableLoadedCount.vue +61 -61
- package/src/components/tables/TableLoadedFooter.vue +44 -44
- package/src/components/tables/TableSkeletonRows.vue +40 -40
- package/src/components/tables/TableVirtualPad.vue +16 -16
- package/src/components/tables/cells/BoolBadgeCell.vue +32 -32
- package/src/components/tables/multiSortHeader.types.ts +16 -16
- package/src/components/ui/UiActionTiles.vue +92 -92
- package/src/components/ui/UiBackLink.vue +39 -39
- package/src/components/ui/UiBadge.vue +60 -60
- package/src/components/ui/UiButton.vue +126 -126
- package/src/components/ui/UiCard.vue +88 -88
- package/src/components/ui/UiCount.vue +35 -35
- package/src/components/ui/UiKpiGrid.vue +142 -142
- package/src/components/ui/UiPopover.vue +62 -62
- package/src/components/ui/UiSearchInput.vue +102 -102
- package/src/components/ui/UiSegmented.vue +145 -145
- package/src/components/ui/UiTableCard.vue +116 -116
- package/src/components/ui/uiActionTiles.types.ts +10 -10
- package/src/components/ui/uiBadge.types.ts +11 -11
- package/src/components/ui/uiKpi.types.ts +17 -17
- package/src/composables/useAppForm.ts +67 -67
- package/src/composables/useConfirm.ts +21 -21
- package/src/composables/useFilterState.ts +70 -70
- package/src/composables/useServerList.ts +348 -348
- package/src/composables/useServerTable.ts +117 -117
- package/src/composables/useSharedAsync.ts +51 -51
- package/src/composables/useVirtualTable.ts +77 -77
- package/src/config.ts +155 -155
- package/src/errors/actionCancelled.ts +9 -9
- package/src/errors/apiError.helper.ts +161 -161
- package/src/errors/useHandleError.ts +33 -33
- package/src/helpers/calendarRange.helper.ts +74 -74
- package/src/helpers/month.helper.ts +63 -63
- package/src/helpers/periodLabel.helper.ts +70 -70
- package/src/helpers/periodPresets.helper.ts +76 -76
- package/src/helpers/sort.helper.ts +57 -57
- package/src/helpers/tableFields.helper.ts +205 -205
- package/src/helpers/urlParams.helper.ts +99 -99
- package/src/helpers/urlSchema.helper.ts +296 -296
- package/src/plugins/modals.plugin.ts +253 -253
- package/src/plugins/table.plugin.ts +173 -173
|
@@ -1,117 +1,117 @@
|
|
|
1
|
-
// Міст «наш стор ↔ TanStack» для серверних таблиць: сортування + стани порожньо/
|
|
2
|
-
// завантаження. Рядки приходять порціями при прокрутці (useVirtualTable).
|
|
3
|
-
|
|
4
|
-
import type { SortingState } from '@tanstack/vue-table'
|
|
5
|
-
import { computed } from 'vue'
|
|
6
|
-
import type { SortDirection } from '../api/types'
|
|
7
|
-
import type { ColumnsMap } from '../helpers/tableFields.helper'
|
|
8
|
-
|
|
9
|
-
// Тип — у контракті API (`_shared/api/types`); тут лише для звичних імпортів фіч.
|
|
10
|
-
export type { SortDirection }
|
|
11
|
-
|
|
12
|
-
/** Зріз стора, потрібний серверній таблиці. Сторі фіч його вже мають. */
|
|
13
|
-
export interface ServerTableStore<TSortBy extends string> {
|
|
14
|
-
filters: {
|
|
15
|
-
sortBy: TSortBy | null
|
|
16
|
-
sortDirection: SortDirection | null
|
|
17
|
-
setSort(by: TSortBy | null, dir?: SortDirection): void
|
|
18
|
-
}
|
|
19
|
-
data: { rows: readonly unknown[]; isLoading: boolean; isError: boolean }
|
|
20
|
-
}
|
|
21
|
-
|
|
22
|
-
// Скелетонів більше екрана не треба — далі вони лише миготять.
|
|
23
|
-
const MAX_SKELETON_ROWS = 8
|
|
24
|
-
|
|
25
|
-
export function useServerTable<TId extends string, TSortBy extends string>(
|
|
26
|
-
store: ServerTableStore<TSortBy>,
|
|
27
|
-
columns: ColumnsMap<TId, TSortBy>,
|
|
28
|
-
) {
|
|
29
|
-
const sorting = computed<SortingState>({
|
|
30
|
-
get: () => {
|
|
31
|
-
const { sortBy, sortDirection } = store.filters
|
|
32
|
-
if (!sortBy || !sortDirection) return []
|
|
33
|
-
const id = columns.toId[sortBy]
|
|
34
|
-
if (!id) return []
|
|
35
|
-
return [{ id, desc: sortDirection === 'desc' }]
|
|
36
|
-
},
|
|
37
|
-
set: (next) => {
|
|
38
|
-
const first = next[0]
|
|
39
|
-
if (!first) { store.filters.setSort(null); return }
|
|
40
|
-
if (!columns.isId(first.id)) return
|
|
41
|
-
const sortBy = columns.byId[first.id]
|
|
42
|
-
if (!sortBy) return // несортована колонка (значення в карті null)
|
|
43
|
-
store.filters.setSort(sortBy, first.desc ? 'desc' : 'asc')
|
|
44
|
-
},
|
|
45
|
-
})
|
|
46
|
-
|
|
47
|
-
return { sorting, ...useTableStates(store) }
|
|
48
|
-
}
|
|
49
|
-
|
|
50
|
-
/** Одне сортування в стеку мультисортування. */
|
|
51
|
-
export interface ServerSortEntry<TSortBy extends string> {
|
|
52
|
-
by: TSortBy
|
|
53
|
-
direction: SortDirection
|
|
54
|
-
}
|
|
55
|
-
|
|
56
|
-
/** Зріз стора для таблиці з мультисортуванням. */
|
|
57
|
-
export interface ServerMultiSortStore<TSortBy extends string> {
|
|
58
|
-
filters: {
|
|
59
|
-
sort: ReadonlyArray<ServerSortEntry<TSortBy>>
|
|
60
|
-
setSort(next: Array<ServerSortEntry<TSortBy>>): void
|
|
61
|
-
}
|
|
62
|
-
data: { rows: readonly unknown[]; isLoading: boolean; isError: boolean }
|
|
63
|
-
}
|
|
64
|
-
|
|
65
|
-
/**
|
|
66
|
-
* Те саме, але сортувань кілька і порядок = пріоритет.
|
|
67
|
-
*
|
|
68
|
-
* Міст двосторонній, як і в одиночного: цикл кліку, стек і номери пріоритету
|
|
69
|
-
* веде TanStack. Умова цього — СВІЙ стовпець під кожен ключ; ті, що не мають
|
|
70
|
-
* чого показувати в таблиці (`owner`, «Паливо, частка»), заведені як приховані
|
|
71
|
-
* (`columnVisibility`). Поки таких стовпців не було, стан доводилось віддавати
|
|
72
|
-
* лише на читання й фільтрувати, а номер пріоритету рахувався по обрізаному
|
|
73
|
-
* масиву — і на екрані розходився зі справжнім порядком.
|
|
74
|
-
*/
|
|
75
|
-
export function useServerMultiSortTable<TId extends string, TSortBy extends string>(
|
|
76
|
-
store: ServerMultiSortStore<TSortBy>,
|
|
77
|
-
columns: ColumnsMap<TId, TSortBy>,
|
|
78
|
-
) {
|
|
79
|
-
const sorting = computed<SortingState>({
|
|
80
|
-
get: () => store.filters.sort.flatMap((entry) => {
|
|
81
|
-
const id = columns.toId[entry.by]
|
|
82
|
-
|
|
83
|
-
return id === undefined ? [] : [{ id, desc: entry.direction === 'desc' }]
|
|
84
|
-
}),
|
|
85
|
-
set: (next) => {
|
|
86
|
-
store.filters.setSort(next.flatMap((item) => {
|
|
87
|
-
if (!columns.isId(item.id)) return []
|
|
88
|
-
|
|
89
|
-
const by = columns.byId[item.id]
|
|
90
|
-
if (!by) return [] // несортована колонка (значення в карті null)
|
|
91
|
-
|
|
92
|
-
return [{ by, direction: item.desc ? 'desc' : 'asc' } as ServerSortEntry<TSortBy>]
|
|
93
|
-
}))
|
|
94
|
-
},
|
|
95
|
-
})
|
|
96
|
-
|
|
97
|
-
return { sorting, ...useTableStates(store) }
|
|
98
|
-
}
|
|
99
|
-
|
|
100
|
-
/** Стани порожньо/помилка/скелетони — і для таблиць без серверного сортування. */
|
|
101
|
-
export function useTableStates(store: {
|
|
102
|
-
data: { rows: readonly unknown[]; isLoading: boolean; isError: boolean }
|
|
103
|
-
}) {
|
|
104
|
-
// Перший показ — скелетони; refetch поверх наявних рядків їх не показує.
|
|
105
|
-
const isInitialLoading = computed(() => store.data.isLoading && store.data.rows.length === 0)
|
|
106
|
-
|
|
107
|
-
// Впав запит — це НЕ «нічого не знайдено»: порожньо — подивились і не знайшли,
|
|
108
|
-
// помилка — не подивились. Один рядок на обидва брехав би про фільтри.
|
|
109
|
-
const isError = computed(() => store.data.isError && store.data.rows.length === 0)
|
|
110
|
-
const isEmpty = computed(() =>
|
|
111
|
-
!store.data.isLoading && !isError.value && store.data.rows.length === 0,
|
|
112
|
-
)
|
|
113
|
-
|
|
114
|
-
const skeletonRowsCount = MAX_SKELETON_ROWS
|
|
115
|
-
|
|
116
|
-
return { isInitialLoading, isEmpty, isError, skeletonRowsCount }
|
|
117
|
-
}
|
|
1
|
+
// Міст «наш стор ↔ TanStack» для серверних таблиць: сортування + стани порожньо/
|
|
2
|
+
// завантаження. Рядки приходять порціями при прокрутці (useVirtualTable).
|
|
3
|
+
|
|
4
|
+
import type { SortingState } from '@tanstack/vue-table'
|
|
5
|
+
import { computed } from 'vue'
|
|
6
|
+
import type { SortDirection } from '../api/types'
|
|
7
|
+
import type { ColumnsMap } from '../helpers/tableFields.helper'
|
|
8
|
+
|
|
9
|
+
// Тип — у контракті API (`_shared/api/types`); тут лише для звичних імпортів фіч.
|
|
10
|
+
export type { SortDirection }
|
|
11
|
+
|
|
12
|
+
/** Зріз стора, потрібний серверній таблиці. Сторі фіч його вже мають. */
|
|
13
|
+
export interface ServerTableStore<TSortBy extends string> {
|
|
14
|
+
filters: {
|
|
15
|
+
sortBy: TSortBy | null
|
|
16
|
+
sortDirection: SortDirection | null
|
|
17
|
+
setSort(by: TSortBy | null, dir?: SortDirection): void
|
|
18
|
+
}
|
|
19
|
+
data: { rows: readonly unknown[]; isLoading: boolean; isError: boolean }
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
// Скелетонів більше екрана не треба — далі вони лише миготять.
|
|
23
|
+
const MAX_SKELETON_ROWS = 8
|
|
24
|
+
|
|
25
|
+
export function useServerTable<TId extends string, TSortBy extends string>(
|
|
26
|
+
store: ServerTableStore<TSortBy>,
|
|
27
|
+
columns: ColumnsMap<TId, TSortBy>,
|
|
28
|
+
) {
|
|
29
|
+
const sorting = computed<SortingState>({
|
|
30
|
+
get: () => {
|
|
31
|
+
const { sortBy, sortDirection } = store.filters
|
|
32
|
+
if (!sortBy || !sortDirection) return []
|
|
33
|
+
const id = columns.toId[sortBy]
|
|
34
|
+
if (!id) return []
|
|
35
|
+
return [{ id, desc: sortDirection === 'desc' }]
|
|
36
|
+
},
|
|
37
|
+
set: (next) => {
|
|
38
|
+
const first = next[0]
|
|
39
|
+
if (!first) { store.filters.setSort(null); return }
|
|
40
|
+
if (!columns.isId(first.id)) return
|
|
41
|
+
const sortBy = columns.byId[first.id]
|
|
42
|
+
if (!sortBy) return // несортована колонка (значення в карті null)
|
|
43
|
+
store.filters.setSort(sortBy, first.desc ? 'desc' : 'asc')
|
|
44
|
+
},
|
|
45
|
+
})
|
|
46
|
+
|
|
47
|
+
return { sorting, ...useTableStates(store) }
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
/** Одне сортування в стеку мультисортування. */
|
|
51
|
+
export interface ServerSortEntry<TSortBy extends string> {
|
|
52
|
+
by: TSortBy
|
|
53
|
+
direction: SortDirection
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/** Зріз стора для таблиці з мультисортуванням. */
|
|
57
|
+
export interface ServerMultiSortStore<TSortBy extends string> {
|
|
58
|
+
filters: {
|
|
59
|
+
sort: ReadonlyArray<ServerSortEntry<TSortBy>>
|
|
60
|
+
setSort(next: Array<ServerSortEntry<TSortBy>>): void
|
|
61
|
+
}
|
|
62
|
+
data: { rows: readonly unknown[]; isLoading: boolean; isError: boolean }
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* Те саме, але сортувань кілька і порядок = пріоритет.
|
|
67
|
+
*
|
|
68
|
+
* Міст двосторонній, як і в одиночного: цикл кліку, стек і номери пріоритету
|
|
69
|
+
* веде TanStack. Умова цього — СВІЙ стовпець під кожен ключ; ті, що не мають
|
|
70
|
+
* чого показувати в таблиці (`owner`, «Паливо, частка»), заведені як приховані
|
|
71
|
+
* (`columnVisibility`). Поки таких стовпців не було, стан доводилось віддавати
|
|
72
|
+
* лише на читання й фільтрувати, а номер пріоритету рахувався по обрізаному
|
|
73
|
+
* масиву — і на екрані розходився зі справжнім порядком.
|
|
74
|
+
*/
|
|
75
|
+
export function useServerMultiSortTable<TId extends string, TSortBy extends string>(
|
|
76
|
+
store: ServerMultiSortStore<TSortBy>,
|
|
77
|
+
columns: ColumnsMap<TId, TSortBy>,
|
|
78
|
+
) {
|
|
79
|
+
const sorting = computed<SortingState>({
|
|
80
|
+
get: () => store.filters.sort.flatMap((entry) => {
|
|
81
|
+
const id = columns.toId[entry.by]
|
|
82
|
+
|
|
83
|
+
return id === undefined ? [] : [{ id, desc: entry.direction === 'desc' }]
|
|
84
|
+
}),
|
|
85
|
+
set: (next) => {
|
|
86
|
+
store.filters.setSort(next.flatMap((item) => {
|
|
87
|
+
if (!columns.isId(item.id)) return []
|
|
88
|
+
|
|
89
|
+
const by = columns.byId[item.id]
|
|
90
|
+
if (!by) return [] // несортована колонка (значення в карті null)
|
|
91
|
+
|
|
92
|
+
return [{ by, direction: item.desc ? 'desc' : 'asc' } as ServerSortEntry<TSortBy>]
|
|
93
|
+
}))
|
|
94
|
+
},
|
|
95
|
+
})
|
|
96
|
+
|
|
97
|
+
return { sorting, ...useTableStates(store) }
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
/** Стани порожньо/помилка/скелетони — і для таблиць без серверного сортування. */
|
|
101
|
+
export function useTableStates(store: {
|
|
102
|
+
data: { rows: readonly unknown[]; isLoading: boolean; isError: boolean }
|
|
103
|
+
}) {
|
|
104
|
+
// Перший показ — скелетони; refetch поверх наявних рядків їх не показує.
|
|
105
|
+
const isInitialLoading = computed(() => store.data.isLoading && store.data.rows.length === 0)
|
|
106
|
+
|
|
107
|
+
// Впав запит — це НЕ «нічого не знайдено»: порожньо — подивились і не знайшли,
|
|
108
|
+
// помилка — не подивились. Один рядок на обидва брехав би про фільтри.
|
|
109
|
+
const isError = computed(() => store.data.isError && store.data.rows.length === 0)
|
|
110
|
+
const isEmpty = computed(() =>
|
|
111
|
+
!store.data.isLoading && !isError.value && store.data.rows.length === 0,
|
|
112
|
+
)
|
|
113
|
+
|
|
114
|
+
const skeletonRowsCount = MAX_SKELETON_ROWS
|
|
115
|
+
|
|
116
|
+
return { isInitialLoading, isEmpty, isError, skeletonRowsCount }
|
|
117
|
+
}
|
|
@@ -1,51 +1,51 @@
|
|
|
1
|
-
import { ref, type Ref } from 'vue';
|
|
2
|
-
import { handleApiError } from '../errors/useHandleError'
|
|
3
|
-
import {MyFunction} from "../types/common";
|
|
4
|
-
|
|
5
|
-
// Глобальное хранилище состояний для каждой функции
|
|
6
|
-
interface AsyncState {
|
|
7
|
-
isLoading: Ref<boolean>;
|
|
8
|
-
activePromise: Promise<any> | null;
|
|
9
|
-
}
|
|
10
|
-
|
|
11
|
-
const registry = new WeakMap<MyFunction, AsyncState>();
|
|
12
|
-
|
|
13
|
-
export function useSharedAsync<T, Args extends any[]>(
|
|
14
|
-
asyncFn: (...args: Args) => Promise<T>
|
|
15
|
-
) {
|
|
16
|
-
// Есть ли уже состояние для этой функции
|
|
17
|
-
if (!registry.has(asyncFn)) {
|
|
18
|
-
registry.set(asyncFn, {
|
|
19
|
-
isLoading: ref(false),
|
|
20
|
-
activePromise: null
|
|
21
|
-
});
|
|
22
|
-
}
|
|
23
|
-
|
|
24
|
-
// Не null, сверху добавили
|
|
25
|
-
const state = registry.get(asyncFn)!;
|
|
26
|
-
|
|
27
|
-
const handle = async (...args: Args): Promise<T | undefined> => {
|
|
28
|
-
// Если запрос уже выполняется - возвращаем существующий Promise
|
|
29
|
-
if (state.activePromise) return state.activePromise
|
|
30
|
-
|
|
31
|
-
state.isLoading.value = true;
|
|
32
|
-
|
|
33
|
-
// Создаем запрос и сохраняем его в стейт
|
|
34
|
-
state.activePromise = asyncFn(...args)
|
|
35
|
-
.catch((error) => {
|
|
36
|
-
handleApiError(error);
|
|
37
|
-
return undefined;
|
|
38
|
-
})
|
|
39
|
-
.finally(() => {
|
|
40
|
-
state.isLoading.value = false;
|
|
41
|
-
state.activePromise = null; // Очищаем после завершения
|
|
42
|
-
});
|
|
43
|
-
|
|
44
|
-
return state.activePromise;
|
|
45
|
-
};
|
|
46
|
-
|
|
47
|
-
return {
|
|
48
|
-
isLoading: state.isLoading,
|
|
49
|
-
handle
|
|
50
|
-
};
|
|
51
|
-
}
|
|
1
|
+
import { ref, type Ref } from 'vue';
|
|
2
|
+
import { handleApiError } from '../errors/useHandleError'
|
|
3
|
+
import {MyFunction} from "../types/common";
|
|
4
|
+
|
|
5
|
+
// Глобальное хранилище состояний для каждой функции
|
|
6
|
+
interface AsyncState {
|
|
7
|
+
isLoading: Ref<boolean>;
|
|
8
|
+
activePromise: Promise<any> | null;
|
|
9
|
+
}
|
|
10
|
+
|
|
11
|
+
const registry = new WeakMap<MyFunction, AsyncState>();
|
|
12
|
+
|
|
13
|
+
export function useSharedAsync<T, Args extends any[]>(
|
|
14
|
+
asyncFn: (...args: Args) => Promise<T>
|
|
15
|
+
) {
|
|
16
|
+
// Есть ли уже состояние для этой функции
|
|
17
|
+
if (!registry.has(asyncFn)) {
|
|
18
|
+
registry.set(asyncFn, {
|
|
19
|
+
isLoading: ref(false),
|
|
20
|
+
activePromise: null
|
|
21
|
+
});
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
// Не null, сверху добавили
|
|
25
|
+
const state = registry.get(asyncFn)!;
|
|
26
|
+
|
|
27
|
+
const handle = async (...args: Args): Promise<T | undefined> => {
|
|
28
|
+
// Если запрос уже выполняется - возвращаем существующий Promise
|
|
29
|
+
if (state.activePromise) return state.activePromise
|
|
30
|
+
|
|
31
|
+
state.isLoading.value = true;
|
|
32
|
+
|
|
33
|
+
// Создаем запрос и сохраняем его в стейт
|
|
34
|
+
state.activePromise = asyncFn(...args)
|
|
35
|
+
.catch((error) => {
|
|
36
|
+
handleApiError(error);
|
|
37
|
+
return undefined;
|
|
38
|
+
})
|
|
39
|
+
.finally(() => {
|
|
40
|
+
state.isLoading.value = false;
|
|
41
|
+
state.activePromise = null; // Очищаем после завершения
|
|
42
|
+
});
|
|
43
|
+
|
|
44
|
+
return state.activePromise;
|
|
45
|
+
};
|
|
46
|
+
|
|
47
|
+
return {
|
|
48
|
+
isLoading: state.isLoading,
|
|
49
|
+
handle
|
|
50
|
+
};
|
|
51
|
+
}
|
|
@@ -1,77 +1,77 @@
|
|
|
1
|
-
// Віртуалізація серверної таблиці з підвантаженням порцій (`useServerInfiniteList`):
|
|
2
|
-
// у DOM лише видимі рядки, наступна порція — коли дійшли до кінця завантаженого.
|
|
3
|
-
//
|
|
4
|
-
// Таблиця рендерить сама: `items` — які рядки малювати, `padTop` / `padBottom` —
|
|
5
|
-
// висота розпірок над і під ними (TableVirtualPad), `measure` — на корінь рядка,
|
|
6
|
-
// щоб висоту брати справжню, а не оцінку.
|
|
7
|
-
|
|
8
|
-
import { useVirtualizer } from '@tanstack/vue-virtual'
|
|
9
|
-
import { computed, onMounted, onUnmounted, watch, type Ref } from 'vue'
|
|
10
|
-
|
|
11
|
-
/** Те, що потрібно від стора нескінченного списку. */
|
|
12
|
-
export interface InfiniteListStore {
|
|
13
|
-
data: { isLoading: boolean; loadMore(): void; setShown(isShown: boolean): void }
|
|
14
|
-
/** Параметри вибірки: інші — прокрутка на початок. */
|
|
15
|
-
params: unknown
|
|
16
|
-
}
|
|
17
|
-
|
|
18
|
-
/** Висота рядка до виміру — середня; точну дає measure. */
|
|
19
|
-
const DEFAULT_ESTIMATE = 64
|
|
20
|
-
/** За скільки рядків до кінця просимо наступну порцію: щоб не впиратися в порожнечу. */
|
|
21
|
-
const PREFETCH_ROWS = 30
|
|
22
|
-
|
|
23
|
-
export function useVirtualTable(options: {
|
|
24
|
-
/** Таблиця; скролиться її батько — область прокрутки UiTableCard. */
|
|
25
|
-
table: Readonly<Ref<HTMLTableElement | null>>
|
|
26
|
-
/** Рядки в порядку показу; ключ — `id`. */
|
|
27
|
-
rows: () => ReadonlyArray<{ id: string }>
|
|
28
|
-
list: InfiniteListStore
|
|
29
|
-
estimateSize?: number
|
|
30
|
-
}) {
|
|
31
|
-
const { list } = options
|
|
32
|
-
|
|
33
|
-
// Запит увімкнений, лише поки таблиця на екрані (див. useServerInfiniteList).
|
|
34
|
-
onMounted(() => list.data.setShown(true))
|
|
35
|
-
onUnmounted(() => list.data.setShown(false))
|
|
36
|
-
|
|
37
|
-
// Елемент прокрутки читаємо в самому computed: картка перемальовує таблицю
|
|
38
|
-
// (порожньо → дані), і без перерахунку опцій віртуалізатор слухав би прокрутку
|
|
39
|
-
// вже неіснуючого елемента.
|
|
40
|
-
const scrollEl = computed(() => options.table.value?.parentElement ?? null)
|
|
41
|
-
const virtualizer = useVirtualizer(computed(() => {
|
|
42
|
-
const element = scrollEl.value
|
|
43
|
-
const rows = options.rows()
|
|
44
|
-
|
|
45
|
-
return {
|
|
46
|
-
count: rows.length,
|
|
47
|
-
getScrollElement: () => element,
|
|
48
|
-
estimateSize: () => options.estimateSize ?? DEFAULT_ESTIMATE,
|
|
49
|
-
overscan: 8,
|
|
50
|
-
getItemKey: (index: number) => rows[index]?.id ?? index,
|
|
51
|
-
}
|
|
52
|
-
}))
|
|
53
|
-
|
|
54
|
-
const items = computed(() => virtualizer.value.getVirtualItems())
|
|
55
|
-
const padTop = computed(() => items.value[0]?.start ?? 0)
|
|
56
|
-
const padBottom = computed(() => {
|
|
57
|
-
const last = items.value.at(-1)
|
|
58
|
-
return last ? virtualizer.value.getTotalSize() - last.end : 0
|
|
59
|
-
})
|
|
60
|
-
|
|
61
|
-
/** На корінь рядка (`:ref`): компонент чи елемент — висоту беремо справжню. */
|
|
62
|
-
function measure(target: unknown): void {
|
|
63
|
-
const node = target instanceof Element ? target : (target as { $el?: unknown } | null)?.$el
|
|
64
|
-
if (node instanceof Element) virtualizer.value.measureElement(node)
|
|
65
|
-
}
|
|
66
|
-
|
|
67
|
-
// Дійшли до кінця завантаженого — наступна порція. І коли закінчився запит:
|
|
68
|
-
// просьба посеред іншого ігнорується, а індекс уже не зміниться — список застряг би.
|
|
69
|
-
watch([() => items.value.at(-1)?.index, () => list.data.isLoading], ([lastIndex, isLoading]) => {
|
|
70
|
-
if (!isLoading && lastIndex !== undefined && lastIndex >= options.rows().length - PREFETCH_ROWS) list.data.loadMore()
|
|
71
|
-
})
|
|
72
|
-
|
|
73
|
-
// Інша вибірка (фільтр, пошук, сортування) — з першого рядка, а не з місця в старій.
|
|
74
|
-
watch(() => list.params, () => virtualizer.value.scrollToOffset(0), { deep: true })
|
|
75
|
-
|
|
76
|
-
return { items, padTop, padBottom, measure }
|
|
77
|
-
}
|
|
1
|
+
// Віртуалізація серверної таблиці з підвантаженням порцій (`useServerInfiniteList`):
|
|
2
|
+
// у DOM лише видимі рядки, наступна порція — коли дійшли до кінця завантаженого.
|
|
3
|
+
//
|
|
4
|
+
// Таблиця рендерить сама: `items` — які рядки малювати, `padTop` / `padBottom` —
|
|
5
|
+
// висота розпірок над і під ними (TableVirtualPad), `measure` — на корінь рядка,
|
|
6
|
+
// щоб висоту брати справжню, а не оцінку.
|
|
7
|
+
|
|
8
|
+
import { useVirtualizer } from '@tanstack/vue-virtual'
|
|
9
|
+
import { computed, onMounted, onUnmounted, watch, type Ref } from 'vue'
|
|
10
|
+
|
|
11
|
+
/** Те, що потрібно від стора нескінченного списку. */
|
|
12
|
+
export interface InfiniteListStore {
|
|
13
|
+
data: { isLoading: boolean; loadMore(): void; setShown(isShown: boolean): void }
|
|
14
|
+
/** Параметри вибірки: інші — прокрутка на початок. */
|
|
15
|
+
params: unknown
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
/** Висота рядка до виміру — середня; точну дає measure. */
|
|
19
|
+
const DEFAULT_ESTIMATE = 64
|
|
20
|
+
/** За скільки рядків до кінця просимо наступну порцію: щоб не впиратися в порожнечу. */
|
|
21
|
+
const PREFETCH_ROWS = 30
|
|
22
|
+
|
|
23
|
+
export function useVirtualTable(options: {
|
|
24
|
+
/** Таблиця; скролиться її батько — область прокрутки UiTableCard. */
|
|
25
|
+
table: Readonly<Ref<HTMLTableElement | null>>
|
|
26
|
+
/** Рядки в порядку показу; ключ — `id`. */
|
|
27
|
+
rows: () => ReadonlyArray<{ id: string }>
|
|
28
|
+
list: InfiniteListStore
|
|
29
|
+
estimateSize?: number
|
|
30
|
+
}) {
|
|
31
|
+
const { list } = options
|
|
32
|
+
|
|
33
|
+
// Запит увімкнений, лише поки таблиця на екрані (див. useServerInfiniteList).
|
|
34
|
+
onMounted(() => list.data.setShown(true))
|
|
35
|
+
onUnmounted(() => list.data.setShown(false))
|
|
36
|
+
|
|
37
|
+
// Елемент прокрутки читаємо в самому computed: картка перемальовує таблицю
|
|
38
|
+
// (порожньо → дані), і без перерахунку опцій віртуалізатор слухав би прокрутку
|
|
39
|
+
// вже неіснуючого елемента.
|
|
40
|
+
const scrollEl = computed(() => options.table.value?.parentElement ?? null)
|
|
41
|
+
const virtualizer = useVirtualizer(computed(() => {
|
|
42
|
+
const element = scrollEl.value
|
|
43
|
+
const rows = options.rows()
|
|
44
|
+
|
|
45
|
+
return {
|
|
46
|
+
count: rows.length,
|
|
47
|
+
getScrollElement: () => element,
|
|
48
|
+
estimateSize: () => options.estimateSize ?? DEFAULT_ESTIMATE,
|
|
49
|
+
overscan: 8,
|
|
50
|
+
getItemKey: (index: number) => rows[index]?.id ?? index,
|
|
51
|
+
}
|
|
52
|
+
}))
|
|
53
|
+
|
|
54
|
+
const items = computed(() => virtualizer.value.getVirtualItems())
|
|
55
|
+
const padTop = computed(() => items.value[0]?.start ?? 0)
|
|
56
|
+
const padBottom = computed(() => {
|
|
57
|
+
const last = items.value.at(-1)
|
|
58
|
+
return last ? virtualizer.value.getTotalSize() - last.end : 0
|
|
59
|
+
})
|
|
60
|
+
|
|
61
|
+
/** На корінь рядка (`:ref`): компонент чи елемент — висоту беремо справжню. */
|
|
62
|
+
function measure(target: unknown): void {
|
|
63
|
+
const node = target instanceof Element ? target : (target as { $el?: unknown } | null)?.$el
|
|
64
|
+
if (node instanceof Element) virtualizer.value.measureElement(node)
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
// Дійшли до кінця завантаженого — наступна порція. І коли закінчився запит:
|
|
68
|
+
// просьба посеред іншого ігнорується, а індекс уже не зміниться — список застряг би.
|
|
69
|
+
watch([() => items.value.at(-1)?.index, () => list.data.isLoading], ([lastIndex, isLoading]) => {
|
|
70
|
+
if (!isLoading && lastIndex !== undefined && lastIndex >= options.rows().length - PREFETCH_ROWS) list.data.loadMore()
|
|
71
|
+
})
|
|
72
|
+
|
|
73
|
+
// Інша вибірка (фільтр, пошук, сортування) — з першого рядка, а не з місця в старій.
|
|
74
|
+
watch(() => list.params, () => virtualizer.value.scrollToOffset(0), { deep: true })
|
|
75
|
+
|
|
76
|
+
return { items, padTop, padBottom, measure }
|
|
77
|
+
}
|