feat(abc:st): columns support null, undefined (#1559)

Author: cipchk

packages/abc/st/st-column-source.ts

@@ -402,8 +402,9 @@ export class STColumnSource {
     list: STColumn[],
     options: STColumnSourceProcessOptions
   ): { columns: _STColumn[]; headers: _STHeader[][]; headerWidths: string[] | null } {
-    if (!list || list.length === 0) throw new Error(`[st]: the columns property muse be define!`);
-
+    if (!list || list.length === 0) {
+      return { columns: [], headers: [], headerWidths: null };
+    }
     const { noIndex } = this.cog;
     let checkboxCount = 0;
     let radioCount = 0;

packages/abc/st/st.component.html

@@ -33,7 +33,7 @@
   [nzFrontPagination]="false"
   [nzBordered]="bordered"
   [nzSize]="size"
-  [nzLoading]="_loading"
+  [nzLoading]="noColumns || _loading"
   [nzLoadingDelay]="loadingDelay"
   [nzLoadingIndicator]="loadingIndicator"
   [nzTitle]="header!"
@@ -54,6 +54,7 @@
   [nzShowTotal]="totalTpl"
   [nzWidthConfig]="_widthConfig"
   (contextmenu)="onContextmenu($event)"
+  [class.st__no-column]="noColumns"
 >
   <thead *ngIf="showHeader">
     <tr *ngFor="let row of _headers; let rowFirst = first">

packages/abc/st/st.component.ts

@@ -162,7 +162,7 @@ export class STComponent implements AfterViewInit, OnChanges, OnDestroy {
     this.updateTotalTpl();
   }
   @Input() data!: string | STData[] | Observable<STData[]>;
-  @Input() columns: STColumn[] = [];
+  @Input() columns?: STColumn[] | null;
   @Input() contextmenu?: STContextmenuFn | null;
   @Input() @InputNumber() ps = 10;
   @Input() @InputNumber() pi = 1;
@@ -244,6 +244,10 @@ export class STComponent implements AfterViewInit, OnChanges, OnDestroy {
     return this._data;
   }
 
+  get noColumns(): boolean {
+    return this.columns == null;
+  }
+
   constructor(
     @Optional() @Inject(ALAIN_I18N_TOKEN) i18nSrv: AlainI18NService,
     private cdr: ChangeDetectorRef,

packages/abc/st/st.interfaces.ts

@@ -82,7 +82,7 @@ export interface STReq {
    */
   allInBody?: boolean;
   /**
-   * 是否延迟加载数据，即渲染结束后不会主动发起请求，默认：`false`
+   * 是否延迟加载数据，即渲染结束后不会主动发起请求，在适当的时机调用 `resetColumns` 来渲染，默认：`false`
    */
   lazyLoad?: boolean;
   /**

packages/abc/st/style/index.less

@@ -154,6 +154,16 @@
     }
   }
 
+  &__no-column {
+    .@{ant-prefix}-table {
+      height: @st-no-column-height;
+
+      &-content {
+        display: none;
+      }
+    }
+  }
+
   @media screen and (min-width: @nz-table-rep-min-width) {
     &__width {
       &-strict {

packages/abc/st/test/st-column-source.spec.ts

@@ -49,15 +49,12 @@ describe('st: column-source', () => {
     page = new PageObject();
   }
 
-  it('should be throw error when is empty columns', () => {
-    expect(() => {
-      genModule({});
-      srv.process(null!, { widthMode: null!, resizable: {}, safeType: 'safeHtml' });
-    }).toThrow();
-    expect(() => {
-      genModule({});
-      srv.process([], options);
-    }).toThrow();
+  it('should be support empty columns', () => {
+    genModule({});
+    const res = srv.process([], options);
+    expect(res.columns.length).toBe(0);
+    expect(res.headers.length).toBe(0);
+    expect(res.headerWidths).toBe(null);
   });
 
   describe('[columns property]', () => {

packages/abc/theme-default.less

@@ -5,6 +5,7 @@
 @st-resizable-handle-width: 1px;
 @st-resizable-handle-height: 60%;
 @st-resizable-handle-color: @border-color-base;
+@st-no-column-height: 100px;
 
 // sv
 // --