feat(abc:st): add delay property (#1854)

xingkoo · web-flow · commit b5d61a90c41b · 2025-06-19T15:10:45.000+08:00
diff --git a/packages/abc/st/index.en-US.md b/packages/abc/st/index.en-US.md
@@ -66,6 +66,7 @@ When an exception is thrown when parsing column data, *INVALID DATA* will be for
 | `[loading]` | Loading status of table, when specifying `null` is controlled by st | `boolean | null` | `null` | - |
 | `[loadingIndicator]` | The spinning indicator | `TemplateRef<void>` | - | ✅ |
 | `[loadingDelay]` | Specifies a delay in milliseconds for loading state (prevent flush) | `number` | `0` | ✅ |
+| [delay] | Whether to delay table rendering, requires manual call to refreshColumns() to render | boolean | false | - |
 | `[scroll]` | Whether table can be scrolled in x/y direction, x or y can be a string that indicates the width and height of table body | `{ y?: string; x?: string }` | - | - |
 | `[virtualScroll]` | Enable virtual scroll mode，work with `[nzScroll]` | `boolean` | `false` | ✅ |
 | `[virtualItemSize]` | The size of the items in the list, same as [cdk itemSize](https://material.angular.io/cdk/scrolling/api) | `number` | `54` | ✅ |
diff --git a/packages/abc/st/index.zh-CN.md b/packages/abc/st/index.zh-CN.md
@@ -66,6 +66,7 @@ module: import { STModule } from '@delon/abc/st';
 | `[loading]` | 页面是否加载中，当指定 `null` 由 st 受控 | `boolean | null` | `null` | - |
 | `[loadingIndicator]` | 加载指示符 | `TemplateRef<void>` | - | ✅ |
 | `[loadingDelay]` | 延迟显示加载效果的时间（防止闪烁） | `number` | `0` | ✅ |
+| `[delay]` | 是否延迟渲染表格,需手动调用`refreshColumns()`渲染 | `boolean` | `false` | - |
 | `[scroll]` | 横向或纵向支持滚动，也可用于指定滚动区域的宽高度：`{ x: "300px", y: "300px" }` | `{ y?: string; x?: string }` | - | - |
 | `[virtualScroll]` | 是否启用虚拟滚动模式，与 `[nzScroll]` 配合使用 | `boolean` | `false` | ✅ |
 | `[virtualItemSize]` | 虚拟滚动时每一列的高度，与 [cdk itemSize](https://material.angular.io/cdk/scrolling/api) 相同 | `number` | `54` | ✅ |
diff --git a/packages/abc/st/st.component.ts b/packages/abc/st/st.component.ts
@@ -322,6 +322,7 @@ export class STComponent implements AfterViewInit, OnChanges {
     this.updateTotalTpl();
   }
   @Input() data?: string | STData[] | Observable<STData[]>;
+  @Input() delay?: boolean = false;
   @Input() columns?: STColumn[] | null;
   @Input() contextmenu?: STContextmenuFn | null;
   @Input({ transform: (v: unknown) => numberAttribute(v, 10) }) ps = 10;
@@ -1073,7 +1074,7 @@ export class STComponent implements AfterViewInit, OnChanges {
   }
 
   ngAfterViewInit(): void {
-    this.refreshColumns();
+    if (!this.delay) this.refreshColumns();
     if (!this.req.lazyLoad) this.loadPageData().subscribe();
     this.inied = true;
   }

Original file line number	Diff line number	Diff line change
`@@ -322,6 +322,7 @@ export class STComponent implements AfterViewInit, OnChanges {`
`322`	`322`	`this.updateTotalTpl();`
`323`	`323`	`}`
`324`	`324`	`@Input() data?: string \| STData[] \| Observable<STData[]>;`
	`325`	`+ @Input() delay?: boolean = false;`
`325`	`326`	`@Input() columns?: STColumn[] \| null;`
`326`	`327`	`@Input() contextmenu?: STContextmenuFn \| null;`
`327`	`328`	`@Input({ transform: (v: unknown) => numberAttribute(v, 10) }) ps = 10;`
`@@ -1073,7 +1074,7 @@ export class STComponent implements AfterViewInit, OnChanges {`
`1073`	`1074`	`}`
`1074`	`1075`
`1075`	`1076`	`ngAfterViewInit(): void {`
`1076`		`- this.refreshColumns();`
	`1077`	`+ if (!this.delay) this.refreshColumns();`
`1077`	`1078`	`if (!this.req.lazyLoad) this.loadPageData().subscribe();`
`1078`	`1079`	`this.inied = true;`
`1079`	`1080`	`}`