@veltra/sheet 2.7.0 → 2.8.0

package/dist/components/sheet/sheet.js

@@ -57,6 +57,10 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 		colResize: {
 			type: Boolean,
 			default: false
+		},
+		scrollbar: {
+			type: Boolean,
+			default: true
 		}
 	},
 	emits: ["active-sheet-change", "col-resize-end"],

package/dist/components/sheet/use-sheet-grid.js

@@ -72,6 +72,7 @@ function useSheetGrid(options) {
 			header: props.header,
 			editors: props.editors,
 			colResize: props.colResize,
+			scrollbar: props.scrollbar,
 			onContextMenu: handleContextMenu,
 			onEditStart: (addr) => formulaBarRef.value?.mirrorGridEdit(addr),
 			onEditEnd: (addr) => formulaBarRef.value?.exitMirror(addr),
@@ -185,7 +186,8 @@ function useSheetGrid(options) {
 		props.showColHeader,
 		props.header,
 		props.editors,
-		props.colResize
+		props.colResize,
+		props.scrollbar
 	], ([nextRows, nextCols]) => {
 		const sheet = getActiveSheet();
 		if (nextRows != null) sheet.ensureTableSize(nextRows, 0);

package/dist/types/sheet.d.ts

@@ -54,6 +54,11 @@ export interface SheetProps {
    * 关闭；缺省 false 行为不变。变化触发网格重建（构造期选项）
    */
   colResize?: boolean;
+  /**
+   * 画布滚动条（透传 SheetGrid → 引擎内建）：内容溢出的轴在画布右/下缘绘制滚动条
+   * （可拖拽 / 点按跳转）；缺省 true。变化触发网格重建（构造期选项）
+   */
+  scrollbar?: boolean;
 }
 export interface SheetEmits {
   /** 激活 sheet 切换（点击 tab 或宿主调用 workbook.activateSheet） */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veltra/sheet",
-  "version": "2.7.0",
+  "version": "2.8.0",
   "homepage": "https://github.com/cabinet-fe/ultra-ui#readme",
   "bugs": {
     "url": "https://github.com/cabinet-fe/ultra-ui/issues"
@@ -34,7 +34,7 @@
     }
   },
   "dependencies": {
-    "infinitable": "^0.1.0"
+    "infinitable": "^0.1.2"
   },
   "peerDependencies": {
     "@cat-kit/core": ">=1.2.1",

package/src/components/sheet/__test__/sheet-component.test.ts

@@ -84,6 +84,19 @@ afterEach(() => {
 })
 
 describe('USheet 组件', () => {
+  it('scrollbar 透传引擎内建滚动条（缺省开启，false 关闭并触发重建）', async () => {
+    const exposedOn: { value: SheetExposed | undefined } = { value: undefined }
+    mount(() => ({}), exposedOn)
+    await nextTick()
+    // 引擎缺省 true（undefined 即开启），无需显式下发
+    expect(exposedOn.value!.getGrid()!.getTable().options.scrollbar).toBeUndefined()
+
+    const exposedOff: { value: SheetExposed | undefined } = { value: undefined }
+    mount(() => ({ scrollbar: false }), exposedOff)
+    await nextTick()
+    expect(exposedOff.value!.getGrid()!.getTable().options.scrollbar).toBe(false)
+  })
+
   it('挂载后默认选区 A1：名称框显示 A1、fx 输入栏可用', async () => {
     const workbook = createWorkbook()
     const { el } = mount(() => ({ workbook, rows: 10, cols: 6 }))

package/src/components/sheet/sheet.vue

@@ -112,7 +112,8 @@ const props = withDefaults(defineProps<SheetProps>(), {
   showRowHeader: true,
   showColHeader: true,
   readonly: false,
-  colResize: false
+  colResize: false,
+  scrollbar: true
 })
 
 const emit = defineEmits<SheetEmits>()

package/src/components/sheet/use-sheet-grid.ts

@@ -131,6 +131,7 @@ export function useSheetGrid(options: UseSheetGridOptions) {
       header: props.header,
       editors: props.editors,
       colResize: props.colResize,
+      scrollbar: props.scrollbar,
       onContextMenu: handleContextMenu,
       onEditStart: (addr) => formulaBarRef.value?.mirrorGridEdit(addr),
       onEditEnd: (addr) => formulaBarRef.value?.exitMirror(addr),
@@ -273,7 +274,8 @@ export function useSheetGrid(options: UseSheetGridOptions) {
         props.showColHeader,
         props.header,
         props.editors,
-        props.colResize
+        props.colResize,
+        props.scrollbar
       ] as const,
     ([nextRows, nextCols]) => {
       const sheet = getActiveSheet()

package/src/types/sheet.ts

@@ -62,6 +62,11 @@ export interface SheetProps {
    * 关闭；缺省 false 行为不变。变化触发网格重建（构造期选项）
    */
   colResize?: boolean
+  /**
+   * 画布滚动条（透传 SheetGrid → 引擎内建）：内容溢出的轴在画布右/下缘绘制滚动条
+   * （可拖拽 / 点按跳转）；缺省 true。变化触发网格重建（构造期选项）
+   */
+  scrollbar?: boolean
 }
 
 export interface SheetEmits {