bkui-vue 0.0.1-beta.99 → 0.0.2-beta.1

package/lib/table/props.d.ts

@@ -1,12 +1,127 @@
-import { ExtractPropTypes } from 'vue';
+import { ExtractPropTypes, Slot } from 'vue';
+import { ROW_HOVER, SORT_OPTION } from './const';
 export declare enum SortScope {
     CURRENT = "current",
     ALL = "all"
 }
-export declare type ColumnFilterListItem = {
+export type ColumnFilterListItem = {
     text?: string;
     value?: string;
 };
+export declare enum OverflowModeEnum {
+    STATIC = "static",
+    AUTO = "auto"
+}
+export declare const overflowModeType: import("vue-types").VueTypeDef<"auto" | "static">;
+export declare enum ColumnTypeEnum {
+    SELECTION = "selection",
+    INDEX = "index",
+    EXPAND = "expand",
+    NONE = "none"
+}
+export declare enum TableAlignEnum {
+    LEFT = "left",
+    RIGHT = "right",
+    CENTER = "center",
+    NONE = ""
+}
+export declare const columnType: import("vue-types").VueTypeDef<"none" | "selection" | "index" | "expand">;
+export declare const TableAlign: import("vue-types").VueTypeDef<"" | "right" | "left" | "center">;
+export declare enum FullEnum {
+    FULL = "full",
+    FUZZY = "fuzzy"
+}
+export declare const fullType: import("vue-types").VueTypeDef<"full" | "fuzzy">;
+export declare enum SettingSizeEnum {
+    SMALL = "small",
+    MEDIUM = "medium",
+    LARGE = "large"
+}
+export declare const settingSizeType: import("vue-types").VueTypeDef<"small" | "medium" | "large">;
+export declare enum FixedEnum {
+    LEFT = "left",
+    RIGHT = "right"
+}
+export declare const fixedType: import("vue-types").VueTypeValidableDef<"right" | "left">;
+export type IOverflowTooltip = {
+    content: string | Function;
+    disabled?: boolean;
+    watchCellResize?: boolean;
+    mode?: `${OverflowModeEnum}`;
+};
+export type ISortOption = {
+    [key: string]: SORT_OPTION;
+};
+export declare enum ColumnPickEnum {
+    MULTI = "multi",
+    SINGLE = "single",
+    DISABLED = "disabled"
+}
+export declare enum ResizerWay {
+    DEBOUNCE = "debounce",
+    THROTTLE = "throttle"
+}
+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<"none" | "selection" | "index" | "expand">;
+    resizable: import("vue-types").VueTypeValidableDef<boolean> & {
+        default: boolean;
+    } & {
+        default: boolean;
+    };
+    fixed: import("vue-types").VueTypeDef<boolean | "right" | "left"> & {
+        default: boolean | "right" | "left";
+    };
+    sort: import("vue-types").VueTypeDef<string | boolean | {
+        sortFn: any;
+        sortScope: (object | "all" | "current" | (() => "all" | "current") | ((props: Record<string, unknown>) => "all" | "current")) & ("all" | "current");
+        value: string;
+    }> & {
+        default: string | boolean | (() => {
+            sortFn: any;
+            sortScope: (object | "all" | "current" | (() => "all" | "current") | ((props: Record<string, unknown>) => "all" | "current")) & ("all" | "current");
+            value: string;
+        });
+    };
+    filter: import("vue-types").VueTypeDef<string | boolean | {
+        list: any[] | (object & (() => any[]));
+        filterFn: any;
+        match: "full" | "fuzzy";
+        checked: any[] | (object & (() => any[]));
+        filterScope: (object | "all" | "current" | (() => "all" | "current") | ((props: Record<string, unknown>) => "all" | "current")) & ("all" | "current");
+        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: "full" | "fuzzy";
+            checked: any[] | (object & (() => any[]));
+            filterScope: (object | "all" | "current" | (() => "all" | "current") | ((props: Record<string, unknown>) => "all" | "current")) & ("all" | "current");
+            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>;
+    align: import("vue-types").VueTypeDef<"" | "right" | "left" | "center">;
+    className: import("vue-types").VueTypeDef<any>;
+};
+export type TableColumnProps = Partial<ExtractPropTypes<typeof IColumnType>>;
 export declare const tableProps: {
     /**
      * 渲染列表
@@ -30,8 +145,8 @@ export declare const tableProps: {
      * 支持：单列（single），多列（multi），禁用（disabled）
      * 默认：disabled
      */
-    columnPick: import("vue-types").VueTypeDef<string> & {
-        default: string;
+    columnPick: import("vue-types").VueTypeDef<"disabled" | "single" | "multi"> & {
+        default: "disabled" | "single" | "multi";
     };
     /**
      * 设置表格高度
@@ -95,8 +210,8 @@ export declare const tableProps: {
      * 表格边框显示设置，可以是一个组合
      * 生效规则: 除非单独设置 none,否则会追加每个设置
      */
-    border: import("vue-types").VueTypeDef<string[]> & {
-        default: () => string[];
+    border: import("vue-types").VueTypeDef<string | ("col" | "none" | "row" | "horizontal" | "outer")[]> & {
+        default: string | (() => ("col" | "none" | "row" | "horizontal" | "outer")[]);
     };
     /**
      * 分页配置
@@ -110,6 +225,17 @@ export declare const tableProps: {
             [key: string]: any;
         });
     };
+    /**
+     * 分页组件高度
+     * 在设置了分页配置之后才会生效
+     * 用于配置分页组件的高度，在不同项目中，分页组件高度会影响表格高度计算
+     * 这里设置为可配置项，避免自计算导致的性能问题以及不确定性样式问题
+     */
+    paginationHeight: import("vue-types").VueTypeValidableDef<number> & {
+        default: number;
+    } & {
+        default: number;
+    };
     /**
      * 是否启用远程分页
      */
@@ -123,14 +249,26 @@ export declare const tableProps: {
      */
     emptyText: import("vue-types").VueTypeValidableDef<string> & {
         default: string;
-    } & {
-        default: string;
     };
     /**
      * bk-table-setting-content
      */
-    settings: import("vue-types").VueTypeDef<boolean | Settings> & {
-        default: boolean | (() => Settings);
+    settings: import("vue-types").VueTypeDef<boolean | {
+        fields: Field[] | (() => Field[]);
+        checked: string[] | (() => string[]);
+        limit: number;
+        size: "small" | "medium" | "large";
+        sizeList: SizeItem[] | (object & (() => SizeItem[]));
+        showLineHeight: (boolean | object | (() => boolean) | ((props: Record<string, unknown>) => boolean)) & boolean;
+    }> & {
+        default: boolean | (() => {
+            fields: Field[] | (() => Field[]);
+            checked: string[] | (() => string[]);
+            limit: number;
+            size: "small" | "medium" | "large";
+            sizeList: SizeItem[] | (object & (() => SizeItem[]));
+            showLineHeight: (boolean | object | (() => boolean) | ((props: Record<string, unknown>) => boolean)) & boolean;
+        });
     };
     /**
      * 行的 class 的回调方法，也可以使用一个固定的 Object 为所有行设置一样的 Style
@@ -176,68 +314,178 @@ export declare const tableProps: {
         default: boolean;
     };
     /**
-     * 行数据的 Key，用来优化 Table 的渲染；
+     * 仅对设置了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，此种情况请使用 Function
+     * 类型为 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;
+    };
+    /**
+     * 当外层容器尺寸改变时，当前组件用什么方式进行重新计算
+     * 默认为 throttle，按照指定频率重新计算
+     * 可选值：debounce，在指定时间范围内只执行一次重新计算
+     */
+    resizerWay: import("vue-types").VueTypeDef<"debounce" | "throttle">;
+    /**
+     * 是否监表格尺寸变化而响应式重新计算渲染
+     */
+    observerResize: import("vue-types").VueTypeValidableDef<boolean> & {
+        default: boolean;
+    } & {
+        default: boolean;
+    };
+    align: import("vue-types").VueTypeDef<"" | "right" | "left" | "center">;
+    headerAlign: import("vue-types").VueTypeDef<"" | "right" | "left" | "center">;
+    /**
+     * 插入至表格第一行之前的内容容器样式
+     * 默认样式为固定在第一行
+     * 需要跟随滚动或者其他样式，可以通过此配置进行覆盖
+     */
+    prependStyle: import("vue-types").VueTypeDef<import("vue").CSSProperties> & {
+        default: () => import("vue").CSSProperties;
+    };
 };
 /**
  * 配置自定义行高选项
  */
-export declare type SizeItem = {
+export type SizeItem = {
     value?: string;
     label?: string;
     height?: number;
 };
-export declare type Settings = {
+export type Settings = {
     fields?: Field[];
     checked?: string[];
     limit?: number;
     size?: string;
     sizeList?: SizeItem[];
+    showLineHeight?: boolean;
 };
-export declare type Field = {
+export type Field = {
     label: string;
     field?: string;
+    disabled?: boolean;
 };
-export declare type Column = {
+export type Column = {
     label: Function | string;
     field?: Function | string;
-    render?: Function | string;
+    render?: Function | string | Slot;
     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;
+        checked?: any;
     } | boolean | string;
+    colspan?: Function | Number;
+    rowspan?: Function | Number;
+    textAlign?: String;
+    className?: string | Function;
+    align?: string;
 };
-export declare type Thead = {
+export type Thead = {
     height?: Number;
     isShow?: boolean;
     cellFn?: Function;
 };
-export declare type GroupColumn = {
+export 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>>;
-export declare type IColumnActive = {
+export type Columns = ReadonlyArray<Column>;
+export type TablePropTypes = Readonly<ExtractPropTypes<typeof tableProps>>;
+export type IColumnActive = {
     index: number;
     active: boolean;
 };
-export declare type IReactiveProp = {
+export 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 type Colgroups = Column & {
+    calcWidth: number;
+    resizeWidth: number;
+    listeners: Map<string, Function>;
 };

package/lib/table/render.d.ts

@@ -1,4 +1,6 @@
-import { TablePlugins } from './plugins/index';
+import { ComputedRef, Ref } from 'vue';
+import type { Language } from '../locale';
+import { TablePlugins } from './plugins';
 import { GroupColumn, IColumnActive, IReactiveProp, TablePropTypes } from './props';
 export default class TableRender {
     props: TablePropTypes;
@@ -7,18 +9,21 @@ export default class TableRender {
     colgroups: GroupColumn[];
     uuid: string;
     events: Map<string, any[]>;
+    styleRef: ComputedRef<{
+        hasScrollY: boolean;
+    }>;
+    t: ComputedRef<Language['table']>;
+    activeSortIndex: Ref<number>;
     plugins: TablePlugins;
-    constructor(props: any, ctx: any, reactiveProp: IReactiveProp, colgroups: GroupColumn[]);
+    constructor(props: any, ctx: any, reactiveProp: IReactiveProp, colgroups: GroupColumn[], styleRef: any, t: ComputedRef<Language['table']>);
     get propActiveCols(): IColumnActive[];
     /**
      * 渲染Table Head
-     * @param activeColumns 当前选中的列
-     * @returns
      */
     renderTableHeadSchema(): (string | JSX.Element)[];
     /**
      * 渲染Table主体
-     * @param activeColumns 当前选中的列
+     * @param rows 表格数据
      * @returns
      */
     renderTableBodySchema(rows: any[]): any;
@@ -27,9 +32,9 @@ export default class TableRender {
     /**
      * 注册监听事件
      * @param eventName
-     * @param wartcher
+     * @param watcher
      */
-    on(eventName: string, wartcher: Function): this;
+    on(eventName: string, watcher: Function): this;
     destroy(): void;
     /**
      * 派发事件
@@ -38,7 +43,7 @@ export default class TableRender {
      */
     private emitEvent;
     private handlePageLimitChange;
-    private hanlePageChange;
+    private handlePageChange;
     /**
      * 指定列选中状态
      * @param index 指定选中的列Index
@@ -48,6 +53,7 @@ export default class TableRender {
     /**
      * 点击选中一列事件
      * @param index 当前选中列Index
+     * @param column 当前选中列
      */
     private handleColumnHeadClick;
     /**
@@ -63,6 +69,13 @@ export default class TableRender {
      * @returns
      */
     private renderHeader;
+    /**
+     * 获取用户自定义class
+     * @param column
+     * @param row
+     * @private
+     */
+    private getColumnCustomClass;
     /**
      * 渲染Table Body
      * @returns
@@ -87,12 +100,19 @@ export default class TableRender {
      * @param rows
      */
     private handleRowDblClick;
+    private handleRowEnter;
+    private handleRowLeave;
     private getExpandCell;
     private handleRowExpandClick;
+    private renderCellCallbackFn;
+    private renderCheckboxColumn;
+    private renderExpandColumn;
     /**
      * 渲染表格Cell内容
      * @param row 当前行
      * @param column 当前列
+     * @param index 当前列
+     * @param rows 当前列
      * @returns
      */
     private renderCell;
@@ -103,14 +123,14 @@ export default class TableRender {
      */
     private isColActive;
     /**
-   * 渲染表格Col分组
-   * @returns
-   */
+     * 渲染表格Col分组
+     * @returns
+     */
     private renderColGroup;
     /**
      * 过滤当前可渲染的列
      */
-    private get filterColgroups();
+    private get filterColGroups();
     /**
      * 当前Table Setting
      */