@aplus-frontend/ui 0.0.1-beta.32 → 0.0.1-beta.34

package/es/src/ap-table/hooks/use-table-paging.d.ts

@@ -0,0 +1,57 @@
+import { Ref } from 'vue';
+import { RequestData } from '../interface';
+import { ApFormExpose } from '../../ap-form';
+import { TablePaginationConfig } from 'ant-design-vue';
+
+export type UseTablePagingParams<DataType, ParamsType> = {
+    request: (params: any) => Promise<RequestData<DataType>>;
+    /**
+     * 是否手动执行，页面初始化后不执行网络请求，需要手动触发
+     * @param params
+     * @returns
+     */
+    manual?: boolean;
+    /**
+     * @description 默认情况下，请求第几页
+     * @default 1
+     */
+    defaultCurrent?: number;
+    /**
+     * 默认每页请求的数据条数
+     * @default 10
+     */
+    defaultPageSize?: number;
+    /**
+     * 额外的默认请求参数，这个参数变更不会触发网络请求
+     */
+    defaultParams?: ParamsType;
+    /**
+     * 数据请求前格式化请求参数
+     * @param values
+     * @returns
+     */
+    formatParams?: (values: any) => any;
+    /**
+     * 特殊类型参数类型对照表（会根据该对照表运行默认的参数格式化）
+     */
+    paramsValueTypeMap?: Record<string, any>;
+    /**
+     * 重设表单需要忽略的字段
+     */
+    resetFieldsIgnores?: string[];
+};
+export declare const useTablePaging: <DataType = any, ParamsType = Record<string, any>>({ manual, defaultCurrent, defaultPageSize, request, defaultParams, formatParams, paramsValueTypeMap, resetFieldsIgnores }: UseTablePagingParams<DataType, ParamsType>) => {
+    formRef: Ref<ApFormExpose<any> | undefined>;
+    submit: () => void;
+    reset: () => void;
+    refresh: () => void;
+    refreshByDelete: (n: number) => void;
+    data: Ref<{
+        total: number;
+        records: DataType[];
+        loading: boolean;
+    }>;
+    current: Ref<number>;
+    pageSize: Ref<number>;
+    onChange: (p: TablePaginationConfig) => void;
+};

package/es/src/ap-table/interface.d.ts

@@ -0,0 +1,155 @@
+import { ColumnType, TableProps } from 'ant-design-vue/es/table';
+import { CompareFn, SortOrder } from 'ant-design-vue/es/table/interface';
+import { ApFormSearchFormProps } from '../ap-form';
+import { ApFormItemDateProps, ApFormItemDateRangeProps, ApFormItemNumberProps, ApFormItemRadioProps, ApFormItemSelectProps, ApFormItemSwitchProps, ApFormItemTextAreaProps, ApFormItemTextProps } from 'src/ap-form/items/interface';
+import { CSSProperties } from 'vue';
+
+type ValueEnmuTyType = {
+    text: string;
+    status?: string;
+    color?: string;
+    disabled?: boolean;
+};
+/**
+ * ApTable默认支持的值类型（将会用于表单生成和默认值格式化）
+ */
+export type ApTableFormFields = {
+    /** 日期选择器 */
+    date: ApFormItemDateProps;
+    /** 日期范围选择器 */
+    dateRange: ApFormItemDateRangeProps;
+    /** 数字输入框 */
+    number: ApFormItemNumberProps;
+    /** 单选 */
+    radio: ApFormItemRadioProps;
+    /** 下拉选择 */
+    select: ApFormItemSelectProps;
+    /** 开关 */
+    switch: ApFormItemSwitchProps;
+    /** 文本输入 */
+    text: ApFormItemTextProps;
+    /** 多行文本输入 */
+    textArea: ApFormItemTextAreaProps;
+};
+type ValueEnum = Record<string, ValueEnmuTyType>;
+export type ExtraProColumnType<T> = Omit<ColumnType<T>, 'children'> & {
+    sorter?: string | boolean | CompareFn<T> | {
+        compare?: CompareFn<T>;
+        /** Config multiple sorter order priority */
+        multiple?: number;
+    };
+};
+export type ApColumnType<ValueType extends keyof ApTableFormFields = 'text'> = ExtraProColumnType<any> & {
+    children?: ApColumnType[];
+    /**
+     * 表单项所占据的格子数（1-24格）
+     */
+    span?: number;
+    /**
+     * 在title之后展示一个icon并触发tooltip
+     */
+    tooltip?: string;
+    /**
+     * 是否可以复制
+     */
+    copyable?: boolean;
+    /**
+     * 是否搜索表单中隐藏
+     */
+    hideInSearch?: boolean;
+    /**
+     * 是否在表格中隐藏
+     */
+    hideInTable?: boolean;
+    /**
+     * 值的枚举，会自动转化把值当成 key 来取出要显示的内容（也会作为select的选项）
+     */
+    valueEnum?: ValueEnum;
+    /**
+     * 自定义查询表单渲染
+     */
+    customRenderFormItem?: () => any;
+    /**
+     * 指定值类型（将会用于默认渲染和查询表单生成）
+     */
+    valueType?: keyof ApTableFormFields;
+    /**
+     * 值类型额外配置的参数（用于查询表单渲染）
+     */
+    fieldProps?: ApTableFormFields[ValueType];
+};
+export type RequestData<T> = {
+    data: T[] | undefined;
+    total?: number;
+} & Record<string, any>;
+export type ApTableProps<RecordType = any, ParamsType = any, ValueType extends keyof ApTableFormFields = 'text'> = Omit<TableProps<RecordType>, 'columns' | 'pagination'> & {
+    /**
+     * 列配置
+     */
+    columns?: ApColumnType<ValueType>[];
+    /**
+     * 是否启用卡片样式
+     */
+    card?: boolean;
+    /**
+     * request请求参数，修改后会自动触发更新
+     */
+    params?: ParamsType;
+    /**
+     * 自定义渲染搜索表单
+     * @param props
+     * @param defaultDom
+     * @returns
+     */
+    searchFormRender?: (props: ApTableProps<RecordType, ParamsType, ValueType>, defaultDom: any) => any;
+    /**
+     * 请求获取dataSource
+     * @param params
+     * @param sort
+     * @param filter
+     * @returns
+     */
+    request?: (params: ParamsType & {
+        pageSize?: number;
+        current?: number;
+    }, sort: Record<string, SortOrder>, filter: Record<string, (string | number)[] | null>) => Promise<Partial<RequestData<RecordType>>>;
+    /**
+     * 数据加载完成后触发
+     * @param data
+     * @returns
+     */
+    onLoad?: (data: RecordType[]) => void;
+    /**
+     * 表格的默认数据源
+     */
+    defaultData?: RecordType[];
+    /**
+     * 表格loading状态变更后触发
+     * @param loading
+     * @returns
+     */
+    onLoadingChange?: (loading: boolean) => void;
+    /**
+     * 查询表单配置，设置为false表示不渲染查询表单
+     */
+    searchForm?: false | ApFormSearchFormProps;
+    /**
+     * 查询表单提交之前，一般用于自定义对查询数据进行变更
+     * @param params
+     * @returns
+     */
+    beforeSearchSubmit?: (params: Partial<ParamsType>) => any;
+    /**
+     * 是否显示分页器（特定的分页器）
+     */
+    pagination?: boolean;
+    /**
+     * 自定义查询表单容器样式
+     */
+    searchFormWrapperStyle?: CSSProperties;
+    /**
+     * 自定义表格样式
+     */
+    tableWrapperStyle?: CSSProperties;
+};
+export {};

package/es/src/ap-table/style/ap-table.css

@@ -0,0 +1,14 @@
+.aplus-ap-table-wrapper {
+  padding: 16px;
+  background-color: #fff;
+}
+.aplus-ap-table__search-wrapper {
+  padding: 16px;
+  padding-bottom: 0;
+  background-color: #fff;
+  margin-bottom: 16px;
+}
+.aplus-ap-table__form-wrapper {
+  padding: 16px;
+  background-color: #fff;
+}

package/es/src/ap-table/utils.d.ts

@@ -0,0 +1,8 @@
+export type FieldValueType = 'multiple' | 'multipleNumber' | 'dayjs' | 'dayjsRange' | 'dayjsDayRange' | 'number' | 'boolean' | 'object';
+export declare const formatParamsValueType: (type: FieldValueType | Record<string, FieldValueType>, value: any, cb: (t: FieldValueType, value: any) => any) => any;
+/**
+ * 解析数值
+ * @param t 值类型
+ * @param value 值
+ */
+export declare const parseFieldValue: (t: FieldValueType, value: any) => any;

package/es/src/base-button/index.d.ts

@@ -0,0 +1,137 @@
+import { default as ModalButton } from './modal-button.vue';
+import { default as PopConfirmButton } from './pop-confirm-button.vue';
+import { CreateComponentPublicInstance, ExtractPropTypes, PropType, ComponentOptionsMixin, VNodeProps, AllowedComponentProps, ComponentCustomProps, ComponentOptionsBase, Plugin } from 'vue';
+export * from './interface';
+export { ModalButton, PopConfirmButton };
+export declare const BaseButton: {
+    new (...args: any[]): CreateComponentPublicInstance<Readonly< ExtractPropTypes<{
+        text: {
+            type: PropType<string>;
+        };
+        color: {
+            type: PropType<"primary" | "success" | "error" | "warning">;
+        };
+        disabled: {
+            type: PropType<boolean>;
+        };
+        onClick: {
+            type: PropType<() => void>;
+        };
+        loading: {
+            type: PropType<boolean>;
+        };
+        preIcon: {
+            type: PropType<string>;
+        };
+        postIcon: {
+            type: PropType<string>;
+        };
+        iconSize: {
+            type: PropType<number>;
+            default: number;
+        };
+    }>>, {}, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, VNodeProps & AllowedComponentProps & ComponentCustomProps & Readonly< ExtractPropTypes<{
+        text: {
+            type: PropType<string>;
+        };
+        color: {
+            type: PropType<"primary" | "success" | "error" | "warning">;
+        };
+        disabled: {
+            type: PropType<boolean>;
+        };
+        onClick: {
+            type: PropType<() => void>;
+        };
+        loading: {
+            type: PropType<boolean>;
+        };
+        preIcon: {
+            type: PropType<string>;
+        };
+        postIcon: {
+            type: PropType<string>;
+        };
+        iconSize: {
+            type: PropType<number>;
+            default: number;
+        };
+    }>>, {
+        iconSize: number;
+    }, true, {}, {}, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly< ExtractPropTypes<{
+        text: {
+            type: PropType<string>;
+        };
+        color: {
+            type: PropType<"primary" | "success" | "error" | "warning">;
+        };
+        disabled: {
+            type: PropType<boolean>;
+        };
+        onClick: {
+            type: PropType<() => void>;
+        };
+        loading: {
+            type: PropType<boolean>;
+        };
+        preIcon: {
+            type: PropType<string>;
+        };
+        postIcon: {
+            type: PropType<string>;
+        };
+        iconSize: {
+            type: PropType<number>;
+            default: number;
+        };
+    }>>, {}, {}, {}, {}, {
+        iconSize: number;
+    }>;
+    __isFragment?: undefined;
+    __isTeleport?: undefined;
+    __isSuspense?: undefined;
+} & ComponentOptionsBase<Readonly< ExtractPropTypes<{
+    text: {
+        type: PropType<string>;
+    };
+    color: {
+        type: PropType<"primary" | "success" | "error" | "warning">;
+    };
+    disabled: {
+        type: PropType<boolean>;
+    };
+    onClick: {
+        type: PropType<() => void>;
+    };
+    loading: {
+        type: PropType<boolean>;
+    };
+    preIcon: {
+        type: PropType<string>;
+    };
+    postIcon: {
+        type: PropType<string>;
+    };
+    iconSize: {
+        type: PropType<number>;
+        default: number;
+    };
+}>>, {}, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, {
+    iconSize: number;
+}, {}, string, {}> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
+    $slots: {
+        icon?(_: {}): any;
+        default?(_: any): any;
+    };
+}) & Plugin<any[]> & (new (...args: any[]) => {
+    $props: {
+        onClick?: (() => void) | undefined;
+    };
+});

package/es/src/basic/help.vue.d.ts

@@ -44,9 +44,9 @@ declare const _default: DefineComponent<{
      * Help text list
      */
     text: {
-        type: PropType<string[] | VNode< RendererNode, RendererElement, {
+        type: PropType<VNode< RendererNode, RendererElement, {
             [key: string]: any;
-        }> | VNodeChild>;
+        }> | string[] | VNodeChild>;
     };
 }, () => import("vue/jsx-runtime").JSX.Element, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly< ExtractPropTypes<{
     /**
@@ -91,9 +91,9 @@ declare const _default: DefineComponent<{
      * Help text list
      */
     text: {
-        type: PropType<string[] | VNode< RendererNode, RendererElement, {
+        type: PropType<VNode< RendererNode, RendererElement, {
             [key: string]: any;
-        }> | VNodeChild>;
+        }> | string[] | VNodeChild>;
     };
 }>>, {
     color: string;

package/es/src/basic/index.d.ts

@@ -0,0 +1,278 @@
+import { CreateComponentPublicInstance, ExtractPropTypes, PropType, VNode, RendererNode, RendererElement, VNodeChild, ComponentOptionsMixin, VNodeProps, AllowedComponentProps, ComponentCustomProps, ComponentOptionsBase, Plugin } from 'vue';
+import { TooltipPlacement } from 'ant-design-vue/es/tooltip';
+export * from './interface';
+export declare const BasicHelp: {
+    new (...args: any[]): CreateComponentPublicInstance<Readonly< ExtractPropTypes<{
+        maxWidth: {
+            type: StringConstructor;
+            default: string;
+        };
+        showIndex: {
+            type: BooleanConstructor;
+        };
+        color: {
+            type: StringConstructor;
+            default: string;
+        };
+        fontSize: {
+            type: StringConstructor;
+            default: string;
+        };
+        placement: {
+            type: PropType<TooltipPlacement>;
+            default: string;
+        };
+        text: {
+            type: PropType< VNode<RendererNode, RendererElement, {
+                [key: string]: any;
+            }> | string[] | VNodeChild>;
+        };
+    }>>, () => import("vue/jsx-runtime").JSX.Element, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, VNodeProps & AllowedComponentProps & ComponentCustomProps & Readonly< ExtractPropTypes<{
+        maxWidth: {
+            type: StringConstructor;
+            default: string;
+        };
+        showIndex: {
+            type: BooleanConstructor;
+        };
+        color: {
+            type: StringConstructor;
+            default: string;
+        };
+        fontSize: {
+            type: StringConstructor;
+            default: string;
+        };
+        placement: {
+            type: PropType<TooltipPlacement>;
+            default: string;
+        };
+        text: {
+            type: PropType< VNode<RendererNode, RendererElement, {
+                [key: string]: any;
+            }> | string[] | VNodeChild>;
+        };
+    }>>, {
+        color: string;
+        placement: TooltipPlacement;
+        fontSize: string;
+        maxWidth: string;
+        showIndex: boolean;
+    }, true, {}, {}, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly< ExtractPropTypes<{
+        maxWidth: {
+            type: StringConstructor;
+            default: string;
+        };
+        showIndex: {
+            type: BooleanConstructor;
+        };
+        color: {
+            type: StringConstructor;
+            default: string;
+        };
+        fontSize: {
+            type: StringConstructor;
+            default: string;
+        };
+        placement: {
+            type: PropType<TooltipPlacement>;
+            default: string;
+        };
+        text: {
+            type: PropType< VNode<RendererNode, RendererElement, {
+                [key: string]: any;
+            }> | string[] | VNodeChild>;
+        };
+    }>>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, {
+        color: string;
+        placement: TooltipPlacement;
+        fontSize: string;
+        maxWidth: string;
+        showIndex: boolean;
+    }>;
+    __isFragment?: undefined;
+    __isTeleport?: undefined;
+    __isSuspense?: undefined;
+} & ComponentOptionsBase<Readonly< ExtractPropTypes<{
+    maxWidth: {
+        type: StringConstructor;
+        default: string;
+    };
+    showIndex: {
+        type: BooleanConstructor;
+    };
+    color: {
+        type: StringConstructor;
+        default: string;
+    };
+    fontSize: {
+        type: StringConstructor;
+        default: string;
+    };
+    placement: {
+        type: PropType<TooltipPlacement>;
+        default: string;
+    };
+    text: {
+        type: PropType< VNode<RendererNode, RendererElement, {
+            [key: string]: any;
+        }> | string[] | VNodeChild>;
+    };
+}>>, () => import("vue/jsx-runtime").JSX.Element, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, {
+    color: string;
+    placement: TooltipPlacement;
+    fontSize: string;
+    maxWidth: string;
+    showIndex: boolean;
+}, {}, string, {}> & VNodeProps & AllowedComponentProps & ComponentCustomProps & Plugin<any[]> & (new (...args: any[]) => {
+    $props: {
+        onClick?: (() => void) | undefined;
+    };
+});
+export declare const BasicTitle: {
+    new (...args: any[]): CreateComponentPublicInstance<Readonly< ExtractPropTypes<{
+        span: {
+            type: PropType<boolean>;
+        };
+        normal: {
+            type: PropType<boolean>;
+        };
+        helpMessage: {
+            type: PropType<string | string[]>;
+            default: string;
+        };
+    }>>, {}, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, VNodeProps & AllowedComponentProps & ComponentCustomProps & Readonly< ExtractPropTypes<{
+        span: {
+            type: PropType<boolean>;
+        };
+        normal: {
+            type: PropType<boolean>;
+        };
+        helpMessage: {
+            type: PropType<string | string[]>;
+            default: string;
+        };
+    }>>, {
+        helpMessage: string | string[];
+    }, true, {}, {}, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly< ExtractPropTypes<{
+        span: {
+            type: PropType<boolean>;
+        };
+        normal: {
+            type: PropType<boolean>;
+        };
+        helpMessage: {
+            type: PropType<string | string[]>;
+            default: string;
+        };
+    }>>, {}, {}, {}, {}, {
+        helpMessage: string | string[];
+    }>;
+    __isFragment?: undefined;
+    __isTeleport?: undefined;
+    __isSuspense?: undefined;
+} & ComponentOptionsBase<Readonly< ExtractPropTypes<{
+    span: {
+        type: PropType<boolean>;
+    };
+    normal: {
+        type: PropType<boolean>;
+    };
+    helpMessage: {
+        type: PropType<string | string[]>;
+        default: string;
+    };
+}>>, {}, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, {
+    helpMessage: string | string[];
+}, {}, string, {}> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
+    $slots: {
+        default?(_: {}): any;
+    };
+}) & Plugin<any[]> & (new (...args: any[]) => {
+    $props: {
+        onClick?: (() => void) | undefined;
+    };
+});
+export declare const BasicArrow: {
+    new (...args: any[]): CreateComponentPublicInstance<Readonly< ExtractPropTypes<{
+        expand: {
+            type: PropType<boolean>;
+        };
+        up: {
+            type: PropType<boolean>;
+        };
+        down: {
+            type: PropType<boolean>;
+        };
+        inset: {
+            type: PropType<boolean>;
+        };
+    }>>, {}, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, VNodeProps & AllowedComponentProps & ComponentCustomProps & Readonly< ExtractPropTypes<{
+        expand: {
+            type: PropType<boolean>;
+        };
+        up: {
+            type: PropType<boolean>;
+        };
+        down: {
+            type: PropType<boolean>;
+        };
+        inset: {
+            type: PropType<boolean>;
+        };
+    }>>, {}, true, {}, {}, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly< ExtractPropTypes<{
+        expand: {
+            type: PropType<boolean>;
+        };
+        up: {
+            type: PropType<boolean>;
+        };
+        down: {
+            type: PropType<boolean>;
+        };
+        inset: {
+            type: PropType<boolean>;
+        };
+    }>>, {}, {}, {}, {}, {}>;
+    __isFragment?: undefined;
+    __isTeleport?: undefined;
+    __isSuspense?: undefined;
+} & ComponentOptionsBase<Readonly< ExtractPropTypes<{
+    expand: {
+        type: PropType<boolean>;
+    };
+    up: {
+        type: PropType<boolean>;
+    };
+    down: {
+        type: PropType<boolean>;
+    };
+    inset: {
+        type: PropType<boolean>;
+    };
+}>>, {}, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, {}, {}, string, {}> & VNodeProps & AllowedComponentProps & ComponentCustomProps & Plugin<any[]> & (new (...args: any[]) => {
+    $props: {
+        onClick?: (() => void) | undefined;
+    };
+});