stk-table-vue 0.11.8 → 0.11.9

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 (53) hide show
  1. package/README.md +173 -173
  2. package/lib/index-C40Rz-HL.js +1 -1
  3. package/lib/src/StkTable/StkTable.vue.d.ts +1 -7
  4. package/lib/src/StkTable/useFixedStyle.d.ts +2 -2
  5. package/lib/stk-table-vue.js +57 -51
  6. package/lib/style.css +1 -1
  7. package/package.json +84 -84
  8. package/src/StkTable/StkTable.vue +1746 -1750
  9. package/src/StkTable/components/DragHandle.vue +9 -9
  10. package/src/StkTable/components/Filter/Dropdown/index.ts +16 -16
  11. package/src/StkTable/components/Filter/Dropdown/index.vue +185 -185
  12. package/src/StkTable/components/Filter/Filter.less +129 -129
  13. package/src/StkTable/components/Filter/Filter.vue +61 -61
  14. package/src/StkTable/components/Filter/index.ts +6 -6
  15. package/src/StkTable/components/Filter/types.ts +18 -18
  16. package/src/StkTable/components/Filter/useFilter.ts +90 -90
  17. package/src/StkTable/components/SortIcon.vue +6 -6
  18. package/src/StkTable/components/TreeNodeCell.vue +19 -19
  19. package/src/StkTable/components/TriangleIcon.vue +3 -3
  20. package/src/StkTable/const.ts +50 -50
  21. package/src/StkTable/features/const.ts +1 -1
  22. package/src/StkTable/features/index.ts +1 -1
  23. package/src/StkTable/features/useAreaSelection.ts +780 -780
  24. package/src/StkTable/index.ts +9 -9
  25. package/src/StkTable/registerFeature.ts +35 -35
  26. package/src/StkTable/style.less +723 -723
  27. package/src/StkTable/types/highlightDimOptions.ts +26 -26
  28. package/src/StkTable/types/index.ts +393 -393
  29. package/src/StkTable/useAutoResize.ts +87 -87
  30. package/src/StkTable/useColResize.ts +202 -202
  31. package/src/StkTable/useFixedCol.ts +139 -139
  32. package/src/StkTable/useFixedStyle.ts +75 -74
  33. package/src/StkTable/useGetFixedColPosition.ts +63 -63
  34. package/src/StkTable/useHighlight.ts +249 -249
  35. package/src/StkTable/useKeyboardArrowScroll.ts +114 -114
  36. package/src/StkTable/useMaxRowSpan.ts +50 -50
  37. package/src/StkTable/useMergeCells.ts +138 -131
  38. package/src/StkTable/useRowExpand.ts +80 -80
  39. package/src/StkTable/useScrollRowByRow.ts +96 -96
  40. package/src/StkTable/useScrollbar.ts +169 -169
  41. package/src/StkTable/useSorter.ts +259 -259
  42. package/src/StkTable/useTableColumns.ts +129 -129
  43. package/src/StkTable/useThDrag.ts +96 -96
  44. package/src/StkTable/useTrDrag.ts +100 -100
  45. package/src/StkTable/useTree.ts +151 -151
  46. package/src/StkTable/useVirtualScroll.ts +554 -546
  47. package/src/StkTable/useWheeling.ts +23 -23
  48. package/src/StkTable/utils/constRefUtils.ts +29 -29
  49. package/src/StkTable/utils/index.ts +324 -324
  50. package/src/StkTable/utils/useTriggerRef.ts +33 -33
  51. package/src/VirtualTree.vue +622 -622
  52. package/src/VirtualTreeSelect.vue +367 -367
  53. package/src/vite-env.d.ts +10 -10
package/README.md CHANGED
@@ -1,173 +1,173 @@
1
- <p align="center">
2
- <a href="https://ja-plus.github.io/stk-table-vue/">
3
- <img src="./docs-src/public/assets/logo.svg" width="152">
4
- </a>
5
- <h3 align='center'>Stk Table Vue</h3>
6
- <p align="center">
7
- <a href="https://www.npmjs.com/package/stk-table-vue"><img src="https://img.shields.io/npm/v/stk-table-vue"></a>
8
- <a href="https://www.npmjs.com/package/stk-table-vue"><img src="https://img.shields.io/npm/dw/stk-table-vue"></a>
9
- <a href="https://github.com/ja-plus/stk-table-vue/stargazers"><img src="https://img.shields.io/github/stars/ja-plus/stk-table-vue.svg"></a>
10
- <a href="https://raw.githubusercontent.com/ja-plus/stk-table-vue/master/LICENSE"><img src="https://img.shields.io/npm/l/stk-table-vue"></a>
11
- <a href="https://github.com/ja-plus/stk-table-vue"><img src="https://img.shields.io/npm/types/stk-table-vue"></a>
12
- </p>
13
- </p>
14
-
15
- Stk Table Vue(Sticky Table) is a high-performance virtual list component based on Vue.
16
-
17
- Smooth performance with tens of thousands of rows
18
-
19
- Used for real-time data display, with data highlighting and dynamic effects.
20
-
21
- Support Vue3 and Vue2.7
22
-
23
-
24
- ## Documentation
25
- ### [Stk Table Vue Official](https://ja-plus.github.io/stk-table-vue/)
26
-
27
-
28
- ## Repo:
29
- - [Github](https://github.com/ja-plus/stk-table-vue)
30
- - [Gitee](https://gitee.com/japlus/stk-table-vue)
31
-
32
- ## Demo
33
- [<span style="font-size: 16px;font-weight: bold;">Online Demo in stackblitz</span>](https://stackblitz.com/edit/vitejs-vite-ad91hh?file=src%2FDemo%2Findex.vue)
34
-
35
- ## Usage
36
- > npm install stk-table-vue
37
-
38
- ```html
39
- <script setup>
40
- import { StkTable } from 'stk-table-vue'
41
- import { ref, useTemplateRef } from 'vue'
42
- const stkTableRef = ref<InstanceType<typeof StkTable>>();
43
- // or Vue 3.5 useTemplateRef
44
- const stkTableRef = useTemplateRef('stkTableRef');
45
-
46
- // highlight row
47
- stkTableRef.value.setHighlightDimRow([rowKey],{
48
- method: 'css'|'animation',// default animation。
49
- className: 'custom-class-name', // method css。
50
- keyframe: [{backgroundColor:'#aaa'}, {backgroundColor: '#222'}],//same as https://developer.mozilla.org/zh-CN/docs/Web/API/Web_Animations_API/Keyframe_Formats
51
- duration: 2000,。
52
- });
53
- // highlight cell
54
- stkTableRef.value.setHighlightDimCell(rowKey, colDataIndex, {
55
- method: 'css'|'animation',
56
- className:'custom-class-name', // method css。
57
- keyframe: [{backgroundColor:'#aaa'}, {backgroundColor: '#222'}], // method animation。
58
- duration: 2000,。
59
- });
60
-
61
- const columns = [
62
- {title: 'name', dataIndex: 'name'},
63
- {title: 'age', dataIndex: 'age'},
64
- {title: 'address', dataIndex: 'address'},
65
- ];
66
-
67
- const dataSource = [
68
- {id: 1, name: 'John', age: 32, address: 'New York'},
69
- {id: 2, name: 'Jim', age: 42, address: 'London'},
70
- {id: 3, name: 'Joe', age: 52, address: 'Tokyo'},
71
- {id: 4, name: 'Jack', age: 62, address: 'Sydney'},
72
- {id: 5, name: 'Jill', age: 72, address: 'Paris'},
73
- ]
74
-
75
- </script>
76
-
77
- <template>
78
- <StkTable ref='stkTableRef' row-key="id" :data-source="dataSource" :columns="columns"></StkTable>
79
- </template>
80
-
81
- ```
82
-
83
- ### Vue2.7 Usage
84
- [Vue2.7 Usage](https://ja-plus.github.io/stk-table-vue/main/start/vue2-usage.html)
85
-
86
- ## API
87
- * [Props](https://ja-plus.github.io/stk-table-vue/main/api/table-props.html)
88
-
89
- * [Emits](https://ja-plus.github.io/stk-table-vue/main/api/emits.html)
90
-
91
- * [Slots](https://ja-plus.github.io/stk-table-vue/main/api/slots.html)
92
-
93
- * [Expose](https://ja-plus.github.io/stk-table-vue/main/api/expose.html)
94
-
95
- * [StkTableColumn: Define column type](https://ja-plus.github.io/stk-table-vue/main/api/stk-table-column.html)
96
-
97
- * [Highlight: setHighlightDimCell & setHighlightDimRow](https://ja-plus.github.io/stk-table-vue/main/api/expose.html#sethighlightdimcell)
98
-
99
-
100
- ### Example
101
- ```vue
102
- <template>
103
- <StkTable
104
- ref="stkTable"
105
- row-key="name"
106
- v-model:columns="columns"
107
- :style="{height:props.height}"
108
- theme='dark'
109
- height='200px'
110
- bordered="h"
111
- :row-height="28"
112
- :show-overflow="false"
113
- :show-header-overflow="false"
114
- :sort-remote="false"
115
- col-resizable
116
- header-drag
117
- virtual
118
- virtual-x
119
- no-data-full
120
- col-resizable
121
- auto-resize
122
- fixed-col-shadow
123
- :col-min-width="10"
124
- :headless="false"
125
- :data-source="dataSource"
126
- @current-change="onCurrentChange"
127
- @row-menu="onRowMenu"
128
- @header-row-menu="onHeaderRowMenu"
129
- @row-click="onRowClick"
130
- @row-dblclick="onRowDblclick"
131
- @sort-change="handleSortChange"
132
- @cell-click="onCellClick"
133
- @header-cell-click="onHeaderCellClick"
134
- @scroll="onTableScroll"
135
- @scroll-x="onTableScrollX"
136
- @col-order-change="onColOrderChange"
137
- />
138
- </template>
139
- <script setup>
140
- import { h, defineComponent } from 'vue';
141
- const columns = [
142
- {
143
- title: 'Name',
144
- dataIndex: 'name',
145
- fixed: 'left',
146
- width: '200px',
147
- headerClassName: 'my-th',
148
- className: 'my-td',
149
- sorter: true,
150
- customHeaderCell: function FunctionalComponent(props){
151
- return h(
152
- 'span',
153
- { style: 'overflow:hidden;text-overflow:ellipsis;white-space:nowrap' },
154
- props.col.title + '(render) text-overflow,',
155
- );
156
- },
157
- customCell: defineComponent({
158
- setup(){
159
- //...
160
- return () => <div></div> // vue jsx
161
- }
162
- })
163
- },
164
- ]
165
- </script>
166
- ```
167
-
168
- ## Compare
169
- Compare performance with other vue table [vue-table-compare](https://github.com/ja-plus/vue-table-compare)
170
-
171
-
172
- ## Other
173
- * `$*$`
1
+ <p align="center">
2
+ <a href="https://ja-plus.github.io/stk-table-vue/">
3
+ <img src="./docs-src/public/assets/logo.svg" width="152">
4
+ </a>
5
+ <h3 align='center'>Stk Table Vue</h3>
6
+ <p align="center">
7
+ <a href="https://www.npmjs.com/package/stk-table-vue"><img src="https://img.shields.io/npm/v/stk-table-vue"></a>
8
+ <a href="https://www.npmjs.com/package/stk-table-vue"><img src="https://img.shields.io/npm/dw/stk-table-vue"></a>
9
+ <a href="https://github.com/ja-plus/stk-table-vue/stargazers"><img src="https://img.shields.io/github/stars/ja-plus/stk-table-vue.svg"></a>
10
+ <a href="https://raw.githubusercontent.com/ja-plus/stk-table-vue/master/LICENSE"><img src="https://img.shields.io/npm/l/stk-table-vue"></a>
11
+ <a href="https://github.com/ja-plus/stk-table-vue"><img src="https://img.shields.io/npm/types/stk-table-vue"></a>
12
+ </p>
13
+ </p>
14
+
15
+ Stk Table Vue(Sticky Table) is a high-performance virtual list component based on Vue.
16
+
17
+ Smooth performance with tens of thousands of rows
18
+
19
+ Used for real-time data display, with data highlighting and dynamic effects.
20
+
21
+ Support Vue3 and Vue2.7
22
+
23
+
24
+ ## Documentation
25
+ ### [Stk Table Vue Official](https://ja-plus.github.io/stk-table-vue/)
26
+
27
+
28
+ ## Repo:
29
+ - [Github](https://github.com/ja-plus/stk-table-vue)
30
+ - [Gitee](https://gitee.com/japlus/stk-table-vue)
31
+
32
+ ## Demo
33
+ [<span style="font-size: 16px;font-weight: bold;">Online Demo in stackblitz</span>](https://stackblitz.com/edit/vitejs-vite-ad91hh?file=src%2FDemo%2Findex.vue)
34
+
35
+ ## Usage
36
+ > npm install stk-table-vue
37
+
38
+ ```html
39
+ <script setup>
40
+ import { StkTable } from 'stk-table-vue'
41
+ import { ref, useTemplateRef } from 'vue'
42
+ const stkTableRef = ref<InstanceType<typeof StkTable>>();
43
+ // or Vue 3.5 useTemplateRef
44
+ const stkTableRef = useTemplateRef('stkTableRef');
45
+
46
+ // highlight row
47
+ stkTableRef.value.setHighlightDimRow([rowKey],{
48
+ method: 'css'|'animation',// default animation。
49
+ className: 'custom-class-name', // method css。
50
+ keyframe: [{backgroundColor:'#aaa'}, {backgroundColor: '#222'}],//same as https://developer.mozilla.org/zh-CN/docs/Web/API/Web_Animations_API/Keyframe_Formats
51
+ duration: 2000,。
52
+ });
53
+ // highlight cell
54
+ stkTableRef.value.setHighlightDimCell(rowKey, colDataIndex, {
55
+ method: 'css'|'animation',
56
+ className:'custom-class-name', // method css。
57
+ keyframe: [{backgroundColor:'#aaa'}, {backgroundColor: '#222'}], // method animation。
58
+ duration: 2000,。
59
+ });
60
+
61
+ const columns = [
62
+ {title: 'name', dataIndex: 'name'},
63
+ {title: 'age', dataIndex: 'age'},
64
+ {title: 'address', dataIndex: 'address'},
65
+ ];
66
+
67
+ const dataSource = [
68
+ {id: 1, name: 'John', age: 32, address: 'New York'},
69
+ {id: 2, name: 'Jim', age: 42, address: 'London'},
70
+ {id: 3, name: 'Joe', age: 52, address: 'Tokyo'},
71
+ {id: 4, name: 'Jack', age: 62, address: 'Sydney'},
72
+ {id: 5, name: 'Jill', age: 72, address: 'Paris'},
73
+ ]
74
+
75
+ </script>
76
+
77
+ <template>
78
+ <StkTable ref='stkTableRef' row-key="id" :data-source="dataSource" :columns="columns"></StkTable>
79
+ </template>
80
+
81
+ ```
82
+
83
+ ### Vue2.7 Usage
84
+ [Vue2.7 Usage](https://ja-plus.github.io/stk-table-vue/main/start/vue2-usage.html)
85
+
86
+ ## API
87
+ * [Props](https://ja-plus.github.io/stk-table-vue/main/api/table-props.html)
88
+
89
+ * [Emits](https://ja-plus.github.io/stk-table-vue/main/api/emits.html)
90
+
91
+ * [Slots](https://ja-plus.github.io/stk-table-vue/main/api/slots.html)
92
+
93
+ * [Expose](https://ja-plus.github.io/stk-table-vue/main/api/expose.html)
94
+
95
+ * [StkTableColumn: Define column type](https://ja-plus.github.io/stk-table-vue/main/api/stk-table-column.html)
96
+
97
+ * [Highlight: setHighlightDimCell & setHighlightDimRow](https://ja-plus.github.io/stk-table-vue/main/api/expose.html#sethighlightdimcell)
98
+
99
+
100
+ ### Example
101
+ ```vue
102
+ <template>
103
+ <StkTable
104
+ ref="stkTable"
105
+ row-key="name"
106
+ v-model:columns="columns"
107
+ :style="{height:props.height}"
108
+ theme='dark'
109
+ height='200px'
110
+ bordered="h"
111
+ :row-height="28"
112
+ :show-overflow="false"
113
+ :show-header-overflow="false"
114
+ :sort-remote="false"
115
+ col-resizable
116
+ header-drag
117
+ virtual
118
+ virtual-x
119
+ no-data-full
120
+ col-resizable
121
+ auto-resize
122
+ fixed-col-shadow
123
+ :col-min-width="10"
124
+ :headless="false"
125
+ :data-source="dataSource"
126
+ @current-change="onCurrentChange"
127
+ @row-menu="onRowMenu"
128
+ @header-row-menu="onHeaderRowMenu"
129
+ @row-click="onRowClick"
130
+ @row-dblclick="onRowDblclick"
131
+ @sort-change="handleSortChange"
132
+ @cell-click="onCellClick"
133
+ @header-cell-click="onHeaderCellClick"
134
+ @scroll="onTableScroll"
135
+ @scroll-x="onTableScrollX"
136
+ @col-order-change="onColOrderChange"
137
+ />
138
+ </template>
139
+ <script setup>
140
+ import { h, defineComponent } from 'vue';
141
+ const columns = [
142
+ {
143
+ title: 'Name',
144
+ dataIndex: 'name',
145
+ fixed: 'left',
146
+ width: '200px',
147
+ headerClassName: 'my-th',
148
+ className: 'my-td',
149
+ sorter: true,
150
+ customHeaderCell: function FunctionalComponent(props){
151
+ return h(
152
+ 'span',
153
+ { style: 'overflow:hidden;text-overflow:ellipsis;white-space:nowrap' },
154
+ props.col.title + '(render) text-overflow,',
155
+ );
156
+ },
157
+ customCell: defineComponent({
158
+ setup(){
159
+ //...
160
+ return () => <div></div> // vue jsx
161
+ }
162
+ })
163
+ },
164
+ ]
165
+ </script>
166
+ ```
167
+
168
+ ## Compare
169
+ Compare performance with other vue table [vue-table-compare](https://github.com/ja-plus/vue-table-compare)
170
+
171
+
172
+ ## Other
173
+ * `$*$`
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * name: stk-table-vue
3
- * version: v0.11.8
3
+ * version: v0.11.9
4
4
  * description: High performance realtime virtual table for vue3 and vue2.7
5
5
  * author: japlus
6
6
  * homepage: https://ja-plus.github.io/stk-table-vue/
@@ -418,13 +418,7 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
418
418
  })) | (UniqKey | (PrivateRowDT & {
419
419
  children?: (PrivateRowDT & /*elided*/ any)[];
420
420
  }))[], option?: {
421
- expand
422
- /**
423
- * props cannot be placed in a separate file. It will cause compilation errors with vue 2.7 compiler.
424
- */
425
- ? /**
426
- * props cannot be placed in a separate file. It will cause compilation errors with vue 2.7 compiler.
427
- */: boolean;
421
+ expand?: boolean;
428
422
  }) => void;
429
423
  /**
430
424
  * 获取拖选选中的单元格信息
@@ -1,4 +1,4 @@
1
- import { CSSProperties, ComputedRef, Ref } from 'vue';
1
+ import { ComputedRef, Ref } from 'vue';
2
2
  import { StkTableColumn, TagType } from './types';
3
3
  import { VirtualScrollStore, VirtualScrollXStore } from './useVirtualScroll';
4
4
 
@@ -13,4 +13,4 @@ import { VirtualScrollStore, VirtualScrollXStore } from './useVirtualScroll';
13
13
  * @param virtualX_offsetRight
14
14
  * @returns
15
15
  */
16
- export declare function useFixedStyle<DT extends Record<string, any>>(props: any, isRelativeMode: Ref<boolean>, getFixedColPosition: ComputedRef<(col: StkTableColumn<DT>) => number>, virtualScroll: Ref<VirtualScrollStore>, virtualScrollX: Ref<VirtualScrollXStore>, virtualX_on: Ref<boolean>, virtualX_offsetRight: Ref<number>): (tagType: TagType, col: StkTableColumn<DT>, depth?: number) => CSSProperties | null;
16
+ export declare function useFixedStyle<DT extends Record<string, any>>(props: any, isRelativeMode: Ref<boolean>, getFixedColPosition: ComputedRef<(col: StkTableColumn<DT>) => number>, virtualScroll: Ref<VirtualScrollStore>, virtualScrollX: Ref<VirtualScrollXStore>, virtualX_on: Ref<boolean>, virtualX_offsetRight: Ref<number>): (tagType: TagType, col: StkTableColumn<DT>, depth?: number) => string;