bkui-vue 0.0.1-beta.23 → 0.0.1-beta.230

package/lib/table/props.d.ts

@@ -1,6 +1,81 @@
 import { ExtractPropTypes } from 'vue';
+import { ROW_HOVER, SORT_OPTION } from './const';
+export declare enum SortScope {
+    CURRENT = "current",
+    ALL = "all"
+}
+export declare type ColumnFilterListItem = {
+    text?: string;
+    value?: string;
+};
+export declare type IOverflowTooltip = {
+    content: string | Function;
+    disabled?: boolean;
+    watchCellResize?: boolean;
+    mode?: string;
+};
+export declare type ISortOption = {
+    [key: string]: SORT_OPTION;
+};
+export declare const IColumnType: {
+    label: import("vue-types").VueTypeDef<any>;
+    field: import("vue-types").VueTypeDef<any>;
+    render: import("vue-types").VueTypeDef<any>;
+    width: import("vue-types").VueTypeDef<string | number>;
+    minWidth: import("vue-types").VueTypeDef<string | number> & {
+        default: string | number;
+    };
+    columnKey: import("vue-types").VueTypeValidableDef<string> & {
+        default: string;
+    } & {
+        default: string;
+    };
+    showOverflowTooltip: import("vue-types").VueTypeDef<boolean | IOverflowTooltip> & {
+        default: boolean | (() => IOverflowTooltip);
+    };
+    type: import("vue-types").VueTypeDef<string> & {
+        default: string;
+    };
+    resizable: import("vue-types").VueTypeValidableDef<boolean> & {
+        default: boolean;
+    } & {
+        default: boolean;
+    };
+    fixed: import("vue-types").VueTypeDef<string | boolean> & {
+        default: string | boolean;
+    };
+    sort: import("vue-types").VueTypeDef<string | boolean | {
+        sortFn: any;
+        sortScope: (string | object | (() => string) | ((props: Record<string, unknown>) => string)) & string;
+        value: (string | object | (() => string) | ((props: Record<string, unknown>) => string)) & string;
+    }> & {
+        default: string | boolean | (() => {
+            sortFn: any;
+            sortScope: (string | object | (() => string) | ((props: Record<string, unknown>) => string)) & string;
+            value: (string | object | (() => string) | ((props: Record<string, unknown>) => string)) & string;
+        });
+    };
+    filter: import("vue-types").VueTypeDef<string | boolean | {
+        list: any[] | (object & (() => any[]));
+        filterFn: any;
+        match: string;
+        filterScope: (string | object | (() => string) | ((props: Record<string, unknown>) => string)) & string;
+        btnSave: (string | boolean | object | (() => string | boolean) | ((props: Record<string, unknown>) => string | boolean)) & (string | boolean);
+        btnReset: (string | boolean | object | (() => string | boolean) | ((props: Record<string, unknown>) => string | boolean)) & (string | boolean);
+    }> & {
+        default: string | boolean | (() => {
+            list: any[] | (object & (() => any[]));
+            filterFn: any;
+            match: string;
+            filterScope: (string | object | (() => string) | ((props: Record<string, unknown>) => string)) & string;
+            btnSave: (string | boolean | object | (() => string | boolean) | ((props: Record<string, unknown>) => string | boolean)) & (string | boolean);
+            btnReset: (string | boolean | object | (() => string | boolean) | ((props: Record<string, unknown>) => string | boolean)) & (string | boolean);
+        });
+    };
+    colspan: import("vue-types").VueTypeDef<any>;
+    rowspan: import("vue-types").VueTypeDef<any>;
+};
 export declare const tableProps: {
-    onRowClick: FunctionConstructor;
     /**
      * 渲染列表
      */
@@ -10,7 +85,9 @@ export declare const tableProps: {
     /**
      * Table 列渲染
      */
-    columns: import("vue-types").VueTypeDef<Column[]>;
+    columns: import("vue-types").VueTypeDef<Column[]> & {
+        default: () => Column[];
+    };
     /**
      * 当前选中列
      * 当设置选中多列时（columnPick = multi），配置为数组[index1, index2, index3]，只能选中单列时，可以为数值或者数组[index]
@@ -26,18 +103,26 @@ export declare const tableProps: {
     };
     /**
      * 设置表格高度
-     * 默认：auto，依赖外层高度
+     * 默认：auto 根据行数自动填充高度
+     * 100%，依赖初始化时父级容器高度
      */
     height: import("vue-types").VueTypeDef<string | number> & {
         default: string | number;
     };
     /**
      * 设置表格最小高度
-     * 默认：auto，依赖外层高度
+     * 默认：300
      */
     minHeight: import("vue-types").VueTypeDef<string | number> & {
         default: string | number;
     };
+    /**
+     * 设置表格最d大高度
+     * 默认：auto，依赖外层高度
+     */
+    maxHeight: import("vue-types").VueTypeDef<string | number> & {
+        default: string | number;
+    };
     /**
      * 行高，可以为固定数值类型
      * 可以是函数，返回当前行的高度，返回值为数值类型
@@ -61,6 +146,10 @@ export declare const tableProps: {
     } & {
         default: boolean;
     };
+    /**
+     * table header config
+     */
+    thead: import("vue-types").VueTypeShape<Thead>;
     /**
      * 是否启用虚拟渲染 & 滚动
      * 当数据量很大时，启用虚拟渲染可以解决压面卡顿问题
@@ -74,8 +163,8 @@ export declare const tableProps: {
      * 表格边框显示设置，可以是一个组合
      * 生效规则: 除非单独设置 none,否则会追加每个设置
      */
-    border: import("vue-types").VueTypeDef<string[]> & {
-        default: () => string[];
+    border: import("vue-types").VueTypeDef<string | string[]> & {
+        default: string | (() => string[]);
     };
     /**
      * 分页配置
@@ -97,15 +186,189 @@ export declare const tableProps: {
     } & {
         default: boolean;
     };
+    /**
+     * 空数据展示
+     */
+    emptyText: import("vue-types").VueTypeValidableDef<string> & {
+        default: string;
+    } & {
+        default: string;
+    };
+    /**
+     * bk-table-setting-content
+     */
+    settings: import("vue-types").VueTypeDef<boolean | Settings> & {
+        default: boolean | (() => Settings);
+    };
+    /**
+     * 行的 class 的回调方法，也可以使用一个固定的 Object 为所有行设置一样的 Style
+     */
+    rowClass: import("vue-types").VueTypeDef<any> & {
+        default: any;
+    };
+    /**
+     * 行的 style 的回调方法，也可以使用一个固定的 Object 为所有行设置一样的 Style
+     */
+    rowStyle: import("vue-types").VueTypeDef<any> & {
+        default: any;
+    };
+    /**
+     * 单元格的 style 的回调方法，也可以使用一个固定的 Object 为所有单元格设置一样的 Style
+     */
+    cellStyle: import("vue-types").VueTypeDef<any> & {
+        default: any;
+    };
+    /**
+     * 单元格的 className 的回调方法，也可以使用字符串为所有单元格设置一个固定的 className
+     */
+    cellClass: import("vue-types").VueTypeDef<any> & {
+        default: any;
+    };
+    /**
+     * 表格底部loading加载效果，可以配合表格scroll-bottom事件使用
+     * 详细配置可参考bk-loading组件
+     */
+    scrollLoading: import("vue-types").VueTypeDef<boolean | {
+        [key: string]: any;
+    }> & {
+        default: boolean | (() => {
+            [key: string]: any;
+        });
+    };
+    /**
+     * 仅对 type=selection 的列有效，类型为 Boolean，为 true 则会在数据更新之后保留之前选中的展开收起操作（需指定 row-key）
+     */
+    reserveExpand: import("vue-types").VueTypeValidableDef<boolean> & {
+        default: boolean;
+    } & {
+        default: boolean;
+    };
+    /**
+     * 仅对设置了selection的情况下生效
+     * 用于初始化或者更新row已选中状态
+     * 内部使用逻辑为：row[selectionKey]，可以为多级选择，但是多级选择只支持 row.child.child
+     */
+    selectionKey: import("vue-types").VueTypeValidableDef<string> & {
+        default: string;
+    } & {
+        default: string;
+    };
+    /**
+   * 提供自定义判定当前行是否选中
+   * 如果设置了此属性，其他判定均不生效
+   * ({ row, cell, data }) => bool
+   */
+    isSelectedFn: import("vue-types").VueTypeValidableDef<(...args: any[]) => any> & {
+        default: (...args: any[]) => any;
+    } & {
+        default: (...args: any[]) => any;
+    };
+    /**
+     * 行数据的 Key，用来优化 Table 的渲染
+     * 此key用于渲染table row的key，便于大数据渲染时的性能优化
+     * 在使用 reserve-selection, reserve-expand 功能的情况下，该属性是必填的。
+     * 类型为 String 时，支持多层访问：user.info.id，同时支持 user.info[0].id
+     */
+    rowKey: import("vue-types").VueTypeDef<any> & {
+        default: any;
+    };
+    /**
+     * 当内容过长被隐藏时显示 tooltip, 此处为全局配置, 如果只配置此处，整个table都启用
+     * column内部可以单个配置覆盖此配置
+     */
+    showOverflowTooltip: import("vue-types").VueTypeDef<boolean | IOverflowTooltip> & {
+        default: boolean | (() => IOverflowTooltip);
+    };
+    /**
+     * 为避免不必要的数据修改导致的不可控组件更新
+     * 默认组件不会对传入组件的data进行任何修改
+     * 设置此属性为true则会对源数据进行同步（如：启用selection，勾选时想要自动同步到源数据）
+     * 目前只会对指定了selectionKey的情况下才会对指定的字段数据进行更新，同时需要指定 rowKey，保证匹配到的row是正确的目标对象
+     */
+    asyncData: import("vue-types").VueTypeValidableDef<boolean> & {
+        default: boolean;
+    } & {
+        default: boolean;
+    };
+    /**
+     * 鼠标划过行样式行为
+     * @param { ROW_HOVER.AUTO }
+     * @param { ROW_HOVER.HIGHLIGHT }
+     */
+    rowHover: import("vue-types").VueTypeDef<ROW_HOVER> & {
+        default: ROW_HOVER;
+    };
+    /**
+     * 默认的排序列的 prop 和顺序。它的 prop 属性指定默认的排序的列，order指定默认排序的顺序
+     */
+    defaultSort: import("vue-types").VueTypeShape<ISortOption> & {
+        default: () => Partial<ISortOption>;
+    };
+    /**
+     * 配合 column selection 使用
+     * 用于配置渲染行数据的勾选框是否可用
+     * 可以直接为 true|false，全部启用或者禁用
+     * 如果是函数，则返回 true|false
+     * ({ row, index, isCheckAll }) => boolean
+     */
+    isRowSelectEnable: import("vue-types").VueTypeDef<any> & {
+        default: any;
+    };
+};
+/**
+ * 配置自定义行高选项
+ */
+export declare type SizeItem = {
+    value?: string;
+    label?: string;
+    height?: number;
+};
+export declare type Settings = {
+    fields?: Field[];
+    checked?: string[];
+    limit?: number;
+    size?: string;
+    sizeList?: SizeItem[];
+    showLineHeight?: boolean;
+};
+export declare type Field = {
+    label: string;
+    field?: string;
+    disabled?: boolean;
 };
 export declare type Column = {
     label: Function | string;
-    field: Function | string;
+    field?: Function | string;
     render?: Function | string;
     width?: number | string;
+    minWidth?: number | string;
+    columnKey?: string;
+    showOverflowTooltip?: boolean | IOverflowTooltip;
+    type?: string;
+    fixed?: string | boolean;
+    resizable?: boolean;
+    sort?: {
+        sortFn?: Function;
+        sortScope?: string;
+        value?: string;
+    } | boolean | string;
+    filter?: {
+        list?: any;
+        filterFn?: Function;
+    } | boolean | string;
+    colspan?: Function | Number;
+    rowspan?: Function | Number;
+};
+export declare type Thead = {
+    height?: Number;
+    isShow?: boolean;
+    cellFn?: Function;
 };
 export declare type GroupColumn = {
     calcWidth?: number;
+    resizeWidth?: number;
+    isHidden?: boolean;
+    listeners?: Map<string, any>;
 } & Column;
 export declare type Columns = ReadonlyArray<Column>;
 export declare type TablePropTypes = Readonly<ExtractPropTypes<typeof tableProps>>;
@@ -115,4 +378,16 @@ export declare type IColumnActive = {
 };
 export declare type IReactiveProp = {
     activeColumns: IColumnActive[];
+    rowActions: Record<string, any>;
+    scrollTranslateY: Number;
+    scrollTranslateX: Number;
+    pos: Record<string, any>;
+    settings: any;
+    setting: any;
+    defaultSort: Record<string, any>;
+};
+export declare type Colgroups = Column & {
+    calcWidth: number;
+    resizeWidth: number;
+    listeners: Map<string, Function>;
 };

package/lib/table/render.d.ts

@@ -1,29 +1,44 @@
-import { SetupContext } from 'vue';
 import { TablePlugins } from './plugins/index';
 import { GroupColumn, IColumnActive, IReactiveProp, TablePropTypes } from './props';
 export default class TableRender {
     props: TablePropTypes;
-    context: SetupContext;
+    context: any;
     reactiveProp: any;
     colgroups: GroupColumn[];
+    uuid: string;
+    events: Map<string, any[]>;
     plugins: TablePlugins;
-    constructor(props: TablePropTypes, ctx: SetupContext, reactiveProp: IReactiveProp, colgroups: GroupColumn[]);
+    constructor(props: any, ctx: any, reactiveProp: IReactiveProp, colgroups: GroupColumn[]);
     get propActiveCols(): IColumnActive[];
     /**
      * 渲染Table Head
      * @param activeColumns 当前选中的列
      * @returns
      */
-    renderTableHeadSchema(): JSX.Element;
+    renderTableHeadSchema(): (string | JSX.Element)[];
     /**
      * 渲染Table主体
      * @param activeColumns 当前选中的列
      * @returns
      */
-    renderTableBodySchema(rows: any[]): JSX.Element;
+    renderTableBodySchema(rows: any[]): any;
     renderTableFooter(options: any): JSX.Element;
+    getRowHeight: (row?: any, rowIndex?: number) => any;
+    /**
+     * 注册监听事件
+     * @param eventName
+     * @param watcher
+     */
+    on(eventName: string, watcher: Function): this;
+    destroy(): void;
+    /**
+     * 派发事件
+     * @param eventName
+     * @param args
+     */
+    private emitEvent;
     private handlePageLimitChange;
-    private hanlePageChange;
+    private handlePageChange;
     /**
      * 指定列选中状态
      * @param index 指定选中的列Index
@@ -35,6 +50,14 @@ export default class TableRender {
      * @param index 当前选中列Index
      */
     private handleColumnHeadClick;
+    /**
+     * 获取排序设置表头
+     * @param column 当前渲染排序列
+     * @param index 排序列所在index
+     * @returns
+     */
+    private getSortCell;
+    private getFilterCell;
     /**
      * 渲染Table Header
      * @returns
@@ -45,6 +68,9 @@ export default class TableRender {
      * @returns
      */
     private renderTBody;
+    private renderExpandRow;
+    private getColumnClass;
+    private getHeadColumnClass;
     /**
      * table row click handle
      * @param e
@@ -53,6 +79,19 @@ export default class TableRender {
      * @param rows
      */
     private handleRowClick;
+    /**
+     * table row click handle
+     * @param e
+     * @param row
+     * @param index
+     * @param rows
+     */
+    private handleRowDblClick;
+    private getExpandCell;
+    private handleRowExpandClick;
+    private renderCellCallbackFn;
+    private renderCheckboxColumn;
+    private renderExpandColumn;
     /**
      * 渲染表格Cell内容
      * @param row 当前行
@@ -71,4 +110,12 @@ export default class TableRender {
    * @returns
    */
     private renderColGroup;
+    /**
+     * 过滤当前可渲染的列
+     */
+    private get filterColgroups();
+    /**
+     * 当前Table Setting
+     */
+    private get setting();
 }