@dazhicheng/ui 1.5.33 → 1.5.35

package/dist/components/tt-select/src/hooks/useSelectTableEvent.d.ts

@@ -0,0 +1,178 @@
+import { ElSelect } from 'element-plus';
+import { ComputedRef, MaybeRef, Ref } from 'vue';
+import { VxeGridDefines, VxeGridPropTypes } from 'vxe-table';
+import { TtSelectProps } from '../props';
+import { TtSelectModelUnionType, TtSelectModelValueType, TtSelectSelectOptions, TtSelectDataOptions } from '../types';
+import { default as SelectTable } from './components/SelectTable.vue';
+/**
+ * 定义选项类型，包含表格、选择器、数据、分页等相关的引用和方法
+ */
+type OptType = {
+    /**
+     * 表格组件实例引用
+     */
+    tableRef: InstanceType<typeof SelectTable>;
+    /**
+     * 选择器组件实例引用
+     */
+    selectRef: Ref<InstanceType<typeof ElSelect> | null>;
+    /**
+     * 选择器选中的值
+     */
+    selectValue: Ref<TtSelectModelValueType>;
+    /**
+     * 设置选择器选中的值
+     * @param val 选中的值
+     * @param opt 选中的选项
+     */
+    setSelectValue: (val: TtSelectModelValueType, opt?: TtSelectSelectOptions, isEmitChange?: boolean) => void;
+    /**
+     * 选项列表
+     */
+    options: Ref<TtSelectDataOptions[]>;
+    /**
+     * 选中的选项
+     */
+    selectOption: Ref<TtSelectSelectOptions>;
+    /**
+     * 是否多选
+     */
+    multiple: boolean;
+    /**
+     * 重新加载数据的方法
+     * @param bool 是否重置数据
+     */
+    reload: (bool?: boolean) => void;
+    /**
+     * 数据是否已加载
+     */
+    isLoaded: Ref<boolean>;
+    /**
+     * 获取分页配置
+     * @returns 分页配置对象
+     */
+    getPagination: () => VxeGridPropTypes.PagerConfig | undefined;
+    /**
+     * 设置分页配置
+     * @param config 部分分页配置对象
+     */
+    setPagination: (config: Partial<VxeGridPropTypes.PagerConfig>) => void;
+    /**
+     * 是否显示分页器
+     */
+    showPager: Ref<boolean>;
+    /**
+     * 是否正在加载数据
+     */
+    loading: Ref<boolean>;
+    /**
+     * 当前活动行的索引
+     */
+    activeIndex: Ref<number>;
+    /**
+     * 设置当前活动行的索引
+     * @param index 索引值
+     */
+    setActiveIndex: (index: number) => void;
+    /**
+     * 是否有下一页数据
+     */
+    hasNextPage: Ref<boolean>;
+    /** 只有一条数据是否选中 */
+    getDefaultSingle: ComputedRef<boolean | undefined>;
+    /** 是否初始化加载数据 */
+    getImmediate: ComputedRef<boolean>;
+    /** 是否展开 */
+    showPopup: Ref<boolean>;
+    /** 设置是否展开 */
+    setShowPopup: (val: boolean) => void;
+    /** 是否需要重新加载数据 */
+    needLoad: ComputedRef<boolean>;
+    /** 选中的值，如果数据源获取后没有绑定值, 清空掉绑定值 */
+    dataNoBindValueClear: boolean | undefined;
+    /** 搜索值是否被清空 */
+    checkedClearSearchValue: boolean | undefined;
+    /** 设置搜索的值 */
+    setSearchValue: (val: string) => void;
+    /** 搜索的值 */
+    searchValue: Ref<string>;
+    /** 是否需要每次展开都获取数据 */
+    isExpandLoadData: MaybeRef<boolean | undefined>;
+    /** 当下拉选择器未被激活并且persistent设置为false，选择器会被删除 */
+    persistent: boolean;
+    /** 获取选项是否禁用 */
+    updateOptionsDisabled: () => void;
+    /** 是否选中第一条数据 */
+    getIsSelectFirstOption: ComputedRef<boolean | undefined>;
+};
+type EmitType = {
+    (e: "visible-change", visible: boolean): void;
+    (e: "scroll", event: VxeGridDefines.ScrollEventParams): void;
+    (e: "scroll-boundary", event: VxeGridDefines.ScrollBoundaryEventParams): void;
+    (e: "focus"): void;
+    (e: "blur"): void;
+    (e: "clear"): void;
+    (e: "remove-tag", tagValue: TtSelectModelUnionType): void;
+};
+/**
+ * 用于处理选择表格事件的钩子函数
+ * @param props 组件属性
+ * @param opt 选项配置
+ * @returns 包含表格事件、选择器事件和键盘事件的对象
+ */
+export declare function useSelectTableEvent(props: ComputedRef<TtSelectProps>, opt: OptType, emit: EmitType): {
+    gridEvent: {
+        /**
+         * 单选框改变事件处理函数
+         */
+        radioChange: ({ oldValue, row }: VxeGridDefines.RadioChangeEventParams) => Promise<void>;
+        /**
+         * 复选框改变事件处理函数
+         */
+        checkboxChange: ({ checked, row }: VxeGridDefines.CheckboxChangeEventParams) => Promise<void>;
+        /**
+         * 表格滚动事件处理函数
+         */
+        scroll: (event: VxeGridDefines.ScrollEventParams) => void;
+        scrollBoundary: (event: VxeGridDefines.ScrollBoundaryEventParams) => void;
+        /**
+         * 全选复选框改变事件处理函数
+         */
+        checkboxAll: ({ checked }: VxeGridDefines.CheckboxAllEventParams) => void;
+        /**
+         * 键盘按下事件处理函数
+         * @param event 键盘事件对象
+         */
+        keydown: (event: KeyboardEvent) => void;
+    };
+    selectEvent: {
+        /**
+         * 清空选择器事件处理函数
+         */
+        clear: () => void;
+        /**
+         * 选择器可见性改变事件处理函数
+         * @param bool 是否可见
+         */
+        visibleChange: (bool: boolean) => void;
+        /**
+         * 择器值改变事件处理函数（el 删除/清除会触发）
+         * beforeChangeCheck(val, row)：val 为当前操作的值，row 为当前操作的响应式对象
+         * @param val 选中的选项（el-select 的 v-model：单选为对象，多选为对象数组）
+         */
+        change: (val: TtSelectSelectOptions) => Promise<void>;
+        /**
+         * 选择器键盘按下捕获事件处理函数
+         * @param event 键盘事件对象
+         */
+        keydownCapture: (event: KeyboardEvent) => void;
+        removeTag: (tagValue: TtSelectModelUnionType) => void;
+    };
+    keyboardEvent: {
+        ArrowUp: () => void;
+        ArrowDown: () => void;
+        Enter: () => void;
+    };
+    defaultDataSelect: (val: any, isNeedScrollToTop?: boolean, isSrcollBoundary?: boolean, isEmitChange?: boolean) => void;
+};
+export {};

package/dist/components/tt-select/src/props.d.ts

@@ -0,0 +1,190 @@
+import { TipConfig } from '../../../directives/disabled-tip';
+import { SelectProps } from 'element-plus';
+import { ExtractPropTypes, PropType } from 'vue';
+import { VxeGridProps } from 'vxe-table';
+import { TtSelectModelUnionType, TtSelectModelValueType, TtSelectConfigProps, TtSelectDataOptions } from './types';
+export declare const configDefault: TtSelectConfigProps;
+export type TtSelectGridProps = VxeGridProps & {
+    /** 是否展示checkbox */
+    showCheckbox?: boolean;
+};
+export declare const selectProps: {
+    /**
+     * 绑定值
+     */
+    modelValue: {
+        type: PropType<TtSelectModelValueType>;
+        default: undefined;
+    };
+    /**
+     * el-select 的Props
+     */
+    selectProps: {
+        type: PropType<Partial<Omit<SelectProps, "modelValue">>>;
+        default: () => {};
+    };
+    /**
+     * vxe-grid 的Props
+     */
+    gridProps: {
+        type: PropType<TtSelectGridProps>;
+        default: () => {};
+    };
+    /**
+     * 渲染的类型
+     * @property select 下拉
+     * @property grid 表格
+     * @property tree 树
+     * @default select
+     */
+    renderType: {
+        type: PropType<"select" | "grid" | "tree" | "table">;
+        default: string;
+    };
+    /** 数据相关的配置 */
+    configProps: {
+        type: PropType<TtSelectConfigProps>;
+        default: () => TtSelectConfigProps;
+    };
+    extra: {
+        type: PropType<Record<string, any>>;
+        default: () => {};
+    };
+    /**
+     * 改变前置函数
+     * @param val 改变后的值
+     * @param oVal 改变前的值
+     * @param option 配置项
+     * @returns 是否改变
+     */
+    beforeChange: {
+        type: PropType<(val: TtSelectModelUnionType, oVal: TtSelectModelUnionType, option?: TtSelectDataOptions) => Promise<boolean>>;
+        default: null;
+    };
+    /** 是否加载 */
+    loading: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 是否禁用 */
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 文本占位符 */
+    placeholder: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 禁用提示 */
+    disabledTip: {
+        type: PropType<TipConfig | TipConfig[]>;
+        default: undefined;
+    };
+    maxCollapseTags: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    /**
+     * 外部值改变是否立即触发emit
+     * @deprecated 兼容旧代码，新开发不要使用
+     */
+    immediateEmitChange: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 是否显示边框 */
+    border: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+};
+export type TtSelectProps = ExtractPropTypes<typeof selectProps>;
+export declare const selectTableProps: {
+    /** configProps */
+    configProps: {
+        type: PropType<TtSelectProps["configProps"]>;
+        default: () => {};
+    };
+    /** 表格的参数 */
+    grid: {
+        type: PropType<TtSelectProps["gridProps"]>;
+        default: () => {};
+    };
+    /** 数据源 */
+    list: {
+        type: PropType<Record<string, any>[]>;
+        default: () => never[];
+    };
+    /** 是否加载中 */
+    loading: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 是否分页 */
+    showPager: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 分页参数 */
+    pagination: {
+        type: PropType<VxeGridProps["pagerConfig"]>;
+        default: () => {};
+    };
+    /** 是否多选 */
+    multiple: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 禁用的方法 */
+    disableFn: {
+        type: PropType<TtSelectConfigProps["disableFn"]>;
+        default: null;
+    };
+    /** 选中的值 */
+    selectValue: {
+        type: PropType<TtSelectModelValueType>;
+        default: () => never[];
+    };
+    /** 下拉框的宽度 */
+    selectWidth: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /** 删除Field */
+    deleteField: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 设置分页配置 */
+    setPagination: {
+        type: PropType<(pagination: VxeGridProps["pagerConfig"]) => void>;
+        default: null;
+    };
+    /** 获取分页参数 */
+    getPagination: {
+        type: PropType<() => VxeGridProps["pagerConfig"]>;
+        default: null;
+    };
+    /** reload */
+    reload: {
+        type: PropType<(bool?: boolean) => Promise<void>>;
+        default: null;
+    };
+    /** 是否加载下一页 */
+    hasNextPage: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 是否展示复选框 */
+    showCheckbox: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** multiple 属性设置为 true 时，代表多选场景下用户最多可以选择的项目数， 为 0 则不限制 */
+    multipleLimit: {
+        type: NumberConstructor;
+        default: number;
+    };
+};
+export type TtSelectTableProps = ExtractPropTypes<typeof selectTableProps>;

package/dist/components/tt-select/src/types/index.d.ts

@@ -0,0 +1,142 @@
+import { MaybeRef, Ref } from 'vue';
+/**
+ * 定义 TtSelect 组件的数据选项类型
+ * 该类型包含了每个选项的基本信息，如标签、值、原始数据项等
+ */
+export type TtSelectDataOptions = {
+    label?: string;
+    value?: any;
+    item?: Record<string, any>;
+    disabled?: boolean;
+    actionType?: "add" | "remove";
+    [key: string]: any;
+};
+/**
+ * 定义 TtSelect 组件的选中选项类型
+ * 该类型可以是单个选项、选项数组或未定义
+ */
+export type TtSelectSelectOptions = TtSelectDataOptions[] | TtSelectDataOptions | undefined;
+/**
+ * 定义 TtSelect 组件的模型值类型
+ * 该类型可以是字符串、数字、字符串或数字的数组，也可以是 null 或未定义
+ */
+export type TtSelectModelValueType = string | number | boolean | (string | number | boolean)[] | null | undefined;
+/**
+ * 定义 TtSelect 组件的模型值联合类型
+ * 该类型可以是选中选项类型或模型值类型
+ */
+export type TtSelectModelUnionType = TtSelectSelectOptions | TtSelectModelValueType;
+/**
+ * 定义 TtSelect 组件的键盘事件类型
+ * 该类型包含了向上箭头、向下箭头和回车键三种键盘事件
+ */
+export type TtSelectKeyboardType = "ArrowUp" | "ArrowDown" | "Enter";
+export type TtSelectConfigProps = {
+    /** api */
+    api?: (...arg: any[]) => Promise<any>;
+    /** 是否分页 */
+    isPage?: boolean;
+    /** 数据 */
+    data?: TtSelectDataOptions[];
+    /** 是否初始化加载数据 */
+    immediate?: boolean;
+    /** 请求后的回调 */
+    afterFetch?: (res: any) => any;
+    /** 请求前的回调 */
+    beforeFetch?: (params: Record<string, any>) => Promise<Record<string, any>>;
+    /** 当前页数 field */
+    currentPageField?: string;
+    /** 当前页数 field Grpc */
+    currentPageFieldGrpc?: string;
+    /** 当前页的大小 field */
+    pageSizeField?: string;
+    /** 当前页的大小 field Grpc */
+    pageSizeFieldGrpc?: string;
+    /** 总数 field */
+    totalField?: string;
+    /** 总数 field Grpc */
+    totalFieldGrpc?: string;
+    /** 数据的 field, 不分页 */
+    dataField?: string;
+    /** 数据的 field, Grpc */
+    dataFieldGrpc?: string;
+    /** 数据的 field, 分页 */
+    resultField?: string;
+    /** 数据的 field, 分页 Grpc */
+    resultFieldGrpc?: string;
+    /** 搜索的 Field */
+    searchField?: string;
+    /** value field */
+    valueField?: string;
+    /** label field */
+    labelField?: string;
+    /** 是否有下一页数据字段，针对于无总数分页情况 */
+    hasNextPageField?: string;
+    /** delete field */
+    deleteField?: string;
+    /** message field */
+    messageField?: string;
+    /**
+     * 额外参数
+     * @deprecated 请使用 extra 代替
+     */
+    extra?: Record<string, any> | Ref<Record<string, any>>;
+    /** 监听额外参数的字段 */
+    watchExtraField?: string[];
+    /** 默认选中的数据 */
+    defaultChecked?: TtSelectDataOptions[] | TtSelectDataOptions;
+    /** 禁用选项的方法 */
+    disableFn?: (value: any, modelValue?: TtSelectModelValueType, option?: TtSelectDataOptions) => boolean;
+    /**
+     * 连接字符函数
+     * @example (labels: string[]) => labels.join(',')
+     * @default join('-')
+     */
+    joinFn?: (labels: string[]) => string;
+    /** 改变下拉数据源时是否清空选中的值 */
+    changeDataClearable?: boolean;
+    /** 只有一条数据是否默认选中 */
+    defaultSingle?: boolean;
+    /** 是否grpc */
+    isGrpc?: boolean;
+    /** 是否copy */
+    isCopy?: boolean;
+    /**
+     * 自定义选项
+     * @example () => ({ label: '*', value: '*' })
+     */
+    customDefault?: TtSelectDataOptions;
+    /** 默认的数据，传递给接口的数据 */
+    defaultData?: Record<string, any> | Ref<Record<string, any>>;
+    /** 是否过滤空值 */
+    isFilterEmpty?: boolean;
+    /** 是否每次展开下拉弹框都滚动到顶部 */
+    isOpenPopupScrollToTop?: boolean;
+    /** 是否多选折叠 */
+    collapse?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 是否自动计算select宽度 */
+    autoSelectWidth?: boolean;
+    /** 是否使用自定义筛选 */
+    isFilterMethod?: boolean;
+    /** 缓存的key */
+    cacheKey?: string;
+    /** 选中的值，如果数据源获取后没有绑定值, 清空掉绑定值 */
+    dataNoBindValueClear?: boolean;
+    /** 是否选中后清空输入的搜索值 多选情况下 */
+    checkedClearSearchValue?: boolean;
+    /** 多字段绑定 */
+    bindFields?: string[];
+    /** 多字段合并 */
+    mergeFields?: string[];
+    /** 绑定的对象 */
+    model?: Record<string, any> | MaybeRef<Record<string, any>>;
+    /**
+     * 是否需要每次展开加载数据
+     * @default false
+     */
+    isExpandLoadData?: MaybeRef<boolean>;
+    /** 是否选中第一条数据 */
+    isSelectFirstOption?: boolean;
+};

package/dist/components/tt-select/src/utils/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 检查对象是否有差异
+ *
+ * @param obj1 对比对象1
+ * @param obj2 对比对象2
+ * @param path 对比路径，默认为空数组 如果是空数组，则对比所有对象
+ * @returns 是否有差异 true:有差异 false:无差异
+ */
+export declare function isEqualObject(obj1: any, obj2: any, path?: string[]): boolean;

package/dist/components/tt-table/index.d.ts

@@ -0,0 +1,127 @@
+/** 操作列按钮组件（用于插槽） */
+export declare const TtTableAction: import('../../../../utils/src').SFCWithInstall<{
+    new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('vue').ExtractPropTypes<{
+        actions: {
+            type: import('vue').PropType<import('.').TtActionItem[]>;
+            default: () => never[];
+        };
+        rowIndex: {
+            type: NumberConstructor;
+            default: undefined;
+        };
+        slotContext: {
+            type: import('vue').PropType<Record<string, any>>;
+            default: undefined;
+        };
+        divider: any;
+        stopButtonPropagation: any;
+        showBtnNums: any;
+        popoverWidth: any;
+    }>> & Readonly<{}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {
+        rowIndex: number;
+        actions: import('.').TtActionItem[];
+        slotContext: Record<string, any>;
+        divider: any;
+        stopButtonPropagation: any;
+        showBtnNums: any;
+        popoverWidth: any;
+    }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, HTMLDivElement, import('vue').ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<import('vue').ExtractPropTypes<{
+        actions: {
+            type: import('vue').PropType<import('.').TtActionItem[]>;
+            default: () => never[];
+        };
+        rowIndex: {
+            type: NumberConstructor;
+            default: undefined;
+        };
+        slotContext: {
+            type: import('vue').PropType<Record<string, any>>;
+            default: undefined;
+        };
+        divider: any;
+        stopButtonPropagation: any;
+        showBtnNums: any;
+        popoverWidth: any;
+    }>> & Readonly<{}>, {}, {}, {}, {}, {
+        rowIndex: number;
+        actions: import('.').TtActionItem[];
+        slotContext: Record<string, any>;
+        divider: any;
+        stopButtonPropagation: any;
+        showBtnNums: any;
+        popoverWidth: any;
+    }>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & import('vue').ComponentOptionsBase<Readonly<import('vue').ExtractPropTypes<{
+    actions: {
+        type: import('vue').PropType<import('.').TtActionItem[]>;
+        default: () => never[];
+    };
+    rowIndex: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    slotContext: {
+        type: import('vue').PropType<Record<string, any>>;
+        default: undefined;
+    };
+    divider: any;
+    stopButtonPropagation: any;
+    showBtnNums: any;
+    popoverWidth: any;
+}>> & Readonly<{}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {
+    rowIndex: number;
+    actions: import('.').TtActionItem[];
+    slotContext: Record<string, any>;
+    divider: any;
+    stopButtonPropagation: any;
+    showBtnNums: any;
+    popoverWidth: any;
+}, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
+    $slots: Readonly<{
+        [slotName: string]: (props: any) => import('vue').VNode;
+        default: () => import('vue').VNode;
+    }> & {
+        [slotName: string]: (props: any) => import('vue').VNode;
+        default: () => import('vue').VNode;
+    };
+})> & Record<string, any>;
+/** 工具栏按钮组件（用于插槽） */
+export declare const TtTableButton: import('../../../../utils/src').SFCWithInstall<import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    actions: {
+        type: import('vue').PropType<import('.').TtActionItem[]>;
+        default: () => never[];
+    };
+    divider: any;
+    stopButtonPropagation: any;
+}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    actions: {
+        type: import('vue').PropType<import('.').TtActionItem[]>;
+        default: () => never[];
+    };
+    divider: any;
+    stopButtonPropagation: any;
+}>> & Readonly<{}>, {
+    actions: import('.').TtActionItem[];
+    divider: any;
+    stopButtonPropagation: any;
+}, {}, {}, {
+    disabledTip: import('vue').Directive;
+}, string, import('vue').ComponentProvideOptions, true, {}, any>> & Record<string, any>;
+/** hooks */
+export { useTableContext, useTableFormContext } from './src/hooks/useTableContext';
+export { useTableFormRender, useTableRender } from './src/hooks/useTableRender';
+/** types */
+export * from './src/types/table';
+export * from './src/types/tableAction';
+export * from './src/types/tableForm';
+export * from './src/types/tableTools';