yc-pro-components 0.0.47 → 0.0.48

package/es/components/index.mjs

@@ -47,6 +47,7 @@ export { useVirtualScroll } from './virtual-table/src/use-virtual-scroll.mjs';
 export { DEFAULT_CDN_CONFIG, DEFAULT_YC_CONFIG, YC_CONFIG_KEY } from './yc-config-provider/src/type.mjs';
 export { useYcAuth, useYcCdn, useYcCdnUrl, useYcComponentConfig, useYcConfig, useYcPerms, useYcShowPageSearch, useYcTranslate } from './yc-config-provider/src/useYcConfig.mjs';
 export { useHeaderFilter } from './yc-plus-page/src/use-header-filter.mjs';
+export { useLocalHeaderFilter } from './yc-plus-page/src/use-local-header-filter.mjs';
 export { DEFAULT_OPERATORS, NO_VALUE_OPERATORS, OPERATOR_CATALOG, OPERATOR_LABELS } from './yc-plus-page/src/constants.mjs';
 export { default as ReSelectV2, default as YcSelectV2 } from './yc-select-v2/src/index.vue.mjs';
 export { findNodeById, findNodeByPath, findNodePosition, insertAsChild, insertAsSibling, insertNodeAtPosition, removeNode, reorderNodeChildren, reorderSiblingNodes } from './yc-plus-tree/src/treeDataUtils.mjs';

package/es/components/yc-plus-page/index.d.ts

@@ -4,6 +4,8 @@ import { DefineComponent } from 'vue';
 export type { YcPlusPageProps, FieldCatalogItem, FieldCatalog, OperatorOption, HeaderFilterConfig, ColumnHeaderFilterConfig, HeaderFilterPayload, HeaderFilterResetPayload, FilterItem, HeaderFiltersState, OrderByItem, RequestResponse } from './src/type';
 export { useHeaderFilter } from './src/use-header-filter';
 export type { UseHeaderFilterOptions, UseHeaderFilterReturn } from './src/use-header-filter';
+export { useLocalHeaderFilter } from './src/use-local-header-filter';
+export type { LocalFilterColumnConfig, UseLocalHeaderFilterOptions, UseLocalHeaderFilterReturn } from './src/use-local-header-filter';
 export { OPERATOR_CATALOG, OPERATOR_LABELS, NO_VALUE_OPERATORS, DEFAULT_OPERATORS } from './src/constants';
 export type YcPlusPageInstance = InstanceType<typeof YcPlusPageComponent>;
 export declare const YcPlusPage: DefineComponent;

package/es/components/yc-plus-page/index.mjs

@@ -1,6 +1,7 @@
 import YcPlusPageComponent from './src/index.vue.mjs';
 import YcTableHeaderFilterCellComponent from './src/header-filter-cell.vue.mjs';
 export { useHeaderFilter } from './src/use-header-filter.mjs';
+export { useLocalHeaderFilter } from './src/use-local-header-filter.mjs';
 export { DEFAULT_OPERATORS, NO_VALUE_OPERATORS, OPERATOR_CATALOG, OPERATOR_LABELS } from './src/constants.mjs';
 
 const YcPlusPage = YcPlusPageComponent;

package/es/components/yc-plus-page/src/header-filter-cell.vue.mjs

@@ -1,6 +1,6 @@
 import _sfc_main from './header-filter-cell.vue2.mjs';
 import _export_sfc from '../../../_virtual/_plugin-vue_export-helper.mjs';
 
-var YcTableHeaderFilterCellComponent = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-bf34a631"], ["__file", "header-filter-cell.vue"]]);
+var YcTableHeaderFilterCellComponent = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-e0442d8a"], ["__file", "header-filter-cell.vue"]]);
 
 export { YcTableHeaderFilterCellComponent as default };

package/es/components/yc-plus-page/src/header-filter-cell.vue2.mjs

@@ -1,4 +1,4 @@
-import { defineComponent, computed, reactive, ref, watch, onMounted, onBeforeUnmount, openBlock, createElementBlock, createCommentVNode, createElementVNode, normalizeClass, withModifiers, createBlock, resolveDynamicComponent, Fragment, unref, withCtx, toDisplayString, createTextVNode, mergeProps, createVNode, renderList, normalizeStyle, h } from 'vue';
+import { defineComponent, computed, reactive, ref, watch, onMounted, onBeforeUnmount, openBlock, createElementBlock, withModifiers, createCommentVNode, createElementVNode, normalizeClass, createBlock, resolveDynamicComponent, Fragment, unref, withCtx, toDisplayString, createTextVNode, mergeProps, createVNode, renderList, normalizeStyle, h } from 'vue';
 import { ElTooltip, ElIcon, ElPopover, ElButton, ElTimePicker, ElTimeSelect, ElDatePicker, ElInput } from 'element-plus';
 import { QuestionFilled } from '@element-plus/icons-vue';
 import { NO_VALUE_OPERATORS } from './constants.mjs';
@@ -8,7 +8,8 @@ import { useYcCdnUrl } from '../../yc-config-provider/src/useYcConfig.mjs';
 
 const _hoisted_1 = { class: "yc-header-filter-cell__label-text" };
 const _hoisted_2 = { class: "yc-header-filter-cell__label-text" };
-const _hoisted_3 = {
+const _hoisted_3 = { style: { cursor: "pointer", display: "inline-flex", alignItems: "center" } };
+const _hoisted_4 = {
   class: "yc-header-filter-cell__content",
   style: {
     display: "flex",
@@ -18,10 +19,10 @@ const _hoisted_3 = {
     gap: "4px"
   }
 };
-const _hoisted_4 = { class: "yc-header-filter-cell__operators" };
-const _hoisted_5 = ["onClick"];
-const _hoisted_6 = { key: 0 };
-const _hoisted_7 = {
+const _hoisted_5 = { class: "yc-header-filter-cell__operators" };
+const _hoisted_6 = ["onClick"];
+const _hoisted_7 = { key: 0 };
+const _hoisted_8 = {
   class: "yc-header-filter-cell__actions",
   style: {
     display: "flex",
@@ -208,9 +209,14 @@ var _sfc_main = /* @__PURE__ */ defineComponent({
             alignItems: "center",
             gap: "4px",
             cursor: "default"
-          }
+          },
+          onMousedown: _cache[1] || (_cache[1] = withModifiers(() => {
+          }, ["stop"])),
+          onClick: _cache[2] || (_cache[2] = withModifiers(() => {
+          }, ["stop"]))
         },
         [
+          createCommentVNode(" @mousedown.stop / @click.stop \u963B\u6B62 el-table <th> \u7684 handleHeaderClick \u548C\u5217 resize \u4E8B\u4EF6\u7A7F\u900F "),
           createCommentVNode(" \u6807\u7B7E\u5185\u5BB9 "),
           createElementVNode(
             "span",
@@ -335,14 +341,12 @@ var _sfc_main = /* @__PURE__ */ defineComponent({
             placement: "bottom-start",
             width: 220,
             visible: popVisible.value,
+            "onUpdate:visible": _cache[0] || (_cache[0] = ($event) => popVisible.value = $event),
             "popper-class": "yc-header-filter-pop",
             "popper-style": { zIndex: 4e3 }
           }, {
             reference: withCtx(() => [
-              createElementVNode("span", {
-                style: { cursor: "pointer", display: "inline-flex", alignItems: "center" },
-                onClick: _cache[0] || (_cache[0] = withModifiers(($event) => popVisible.value = !popVisible.value, ["stop"]))
-              }, [
+              createElementVNode("span", _hoisted_3, [
                 createVNode(unref(YcSvgIcon), {
                   src: filterIconUrl.value,
                   size: 14,
@@ -351,9 +355,9 @@ var _sfc_main = /* @__PURE__ */ defineComponent({
               ])
             ]),
             default: withCtx(() => [
-              createElementVNode("div", _hoisted_3, [
+              createElementVNode("div", _hoisted_4, [
                 createCommentVNode(" \u64CD\u4F5C\u7B26\u5217\u8868 "),
-                createElementVNode("div", _hoisted_4, [
+                createElementVNode("div", _hoisted_5, [
                   (openBlock(true), createElementBlock(
                     Fragment,
                     null,
@@ -380,8 +384,8 @@ var _sfc_main = /* @__PURE__ */ defineComponent({
                           1
                           /* TEXT */
                         ),
-                        state.selectedOp === op.code ? (openBlock(), createElementBlock("span", _hoisted_6, "\u2713")) : createCommentVNode("v-if", true)
-                      ], 12, _hoisted_5);
+                        state.selectedOp === op.code ? (openBlock(), createElementBlock("span", _hoisted_7, "\u2713")) : createCommentVNode("v-if", true)
+                      ], 12, _hoisted_6);
                     }),
                     128
                     /* KEYED_FRAGMENT */
@@ -390,7 +394,7 @@ var _sfc_main = /* @__PURE__ */ defineComponent({
                 createCommentVNode(" \u503C\u8F93\u5165 "),
                 needValueInput.value ? (openBlock(), createBlock(resolveDynamicComponent(renderValueField), { key: 0 })) : createCommentVNode("v-if", true),
                 createCommentVNode(" \u64CD\u4F5C\u6309\u94AE "),
-                createElementVNode("div", _hoisted_7, [
+                createElementVNode("div", _hoisted_8, [
                   createVNode(unref(ElButton), { onClick: handleReset }, {
                     default: withCtx(() => [
                       createTextVNode("\u91CD\u7F6E")
@@ -415,8 +419,8 @@ var _sfc_main = /* @__PURE__ */ defineComponent({
             /* STABLE */
           }, 8, ["visible"])) : createCommentVNode("v-if", true)
         ],
-        512
-        /* NEED_PATCH */
+        544
+        /* NEED_HYDRATION, NEED_PATCH */
       );
     };
   }

package/es/components/yc-plus-page/src/use-local-header-filter.d.ts

@@ -0,0 +1,93 @@
+import { HeaderFiltersState, OrderByItem, OperatorOption, HeaderFilterPayload, HeaderFilterResetPayload } from './type';
+import { Ref, ComputedRef } from 'vue';
+
+/**
+ * 可筛选列配置
+ */
+export interface LocalFilterColumnConfig {
+    /** 列字段名（对应 el-table-column 的 prop） */
+    prop: string;
+    /** 字段类型，决定可用的操作符集合，默认 'string' */
+    type?: 'string' | 'number' | 'date' | 'boolean';
+}
+/**
+ * useLocalHeaderFilter 配置项
+ */
+export interface UseLocalHeaderFilterOptions {
+    /** 需要启用筛选的列配置，未配置的列不显示筛选 */
+    filterableColumns?: LocalFilterColumnConfig[];
+}
+/**
+ * useLocalHeaderFilter 返回值
+ */
+export interface UseLocalHeaderFilterReturn<T> {
+    /** 经过筛选和排序后的数据，绑定到表格的 :data */
+    filteredData: ComputedRef<T[]>;
+    /** 当前筛选状态，传给 YcTableHeaderFilterCell 的 :filters */
+    headerFiltersState: HeaderFiltersState;
+    /** 当前排序状态，传给 YcTableHeaderFilterCell 的 :order-by */
+    orderByState: OrderByItem[];
+    /** 筛选确认处理，传给 YcTableHeaderFilterCell 的 @confirm */
+    handleFilterConfirm: (payload: HeaderFilterPayload) => void;
+    /** 筛选重置处理，传给 YcTableHeaderFilterCell 的 @reset */
+    handleFilterReset: (payload: HeaderFilterResetPayload) => void;
+    /** 排序切换处理，传给 YcTableHeaderFilterCell 的 @sort-change */
+    handleSortChange: (payload: {
+        field: string;
+        direction?: 'asc' | 'desc';
+    }) => void;
+    /** 根据 prop 获取操作符列表，传给 YcTableHeaderFilterCell 的 :operators */
+    getOpsByProp: (prop: string) => OperatorOption[];
+    /** 重置所有筛选和排序 */
+    resetAllFilters: () => void;
+    /** 是否有激活的筛选条件 */
+    hasActiveFilters: ComputedRef<boolean>;
+}
+/**
+ * 本地数据表头筛选组合式函数
+ *
+ * @param data - 响应式数据源
+ * @param options - 可筛选列配置
+ *
+ * @example
+ * ```ts
+ * import { useLocalHeaderFilter, YcTableHeaderFilterCell } from 'yc-pro-components'
+ *
+ * const {
+ *   filteredData,
+ *   headerFiltersState,
+ *   orderByState,
+ *   handleFilterConfirm,
+ *   handleFilterReset,
+ *   handleSortChange,
+ *   getOpsByProp
+ * } = useLocalHeaderFilter(tableData, {
+ *   filterableColumns: [
+ *     { prop: 'userName', type: 'string' },
+ *     { prop: 'realShortName', type: 'string' },
+ *     { prop: 'weight', type: 'number' }
+ *   ]
+ * })
+ * ```
+ *
+ * 模板中配合 el-table 使用：
+ * ```vue
+ * <el-table :data="filteredData">
+ *   <el-table-column prop="userName">
+ *     <template #header>
+ *       <YcTableHeaderFilterCell
+ *         label="客户名称"
+ *         :column="{ prop: 'userName' }"
+ *         :operators="getOpsByProp('userName')"
+ *         :filters="headerFiltersState.filters"
+ *         :order-by="orderByState"
+ *         @confirm="handleFilterConfirm"
+ *         @reset="handleFilterReset"
+ *         @sort-change="handleSortChange"
+ *       />
+ *     </template>
+ *   </el-table-column>
+ * </el-table>
+ * ```
+ */
+export declare function useLocalHeaderFilter<T = Record<string, unknown>>(data: Ref<T[]> | ComputedRef<T[]>, options?: UseLocalHeaderFilterOptions): UseLocalHeaderFilterReturn<T>;

package/es/components/yc-plus-page/src/use-local-header-filter.mjs

@@ -0,0 +1,145 @@
+import { computed, unref } from 'vue';
+import { useHeaderFilter } from './use-header-filter.mjs';
+
+function compareValues(a, b) {
+  if (a == null && b == null) return 0;
+  if (a == null) return -1;
+  if (b == null) return 1;
+  const numA = Number(a);
+  const numB = Number(b);
+  if (!isNaN(numA) && !isNaN(numB)) return numA - numB;
+  return String(a).localeCompare(String(b), "zh-CN");
+}
+function matchFilter(value, op, filterValue) {
+  const strValue = String(value != null ? value : "").toLowerCase();
+  const strFilter = String(filterValue != null ? filterValue : "").toLowerCase();
+  switch (op) {
+    case "=":
+      return strValue === strFilter;
+    case "!=":
+      return strValue !== strFilter;
+    case "like":
+      return strValue.includes(strFilter);
+    case "not like":
+      return !strValue.includes(strFilter);
+    case ">":
+      return Number(value) > Number(filterValue);
+    case ">=":
+      return Number(value) >= Number(filterValue);
+    case "<":
+      return Number(value) < Number(filterValue);
+    case "<=":
+      return Number(value) <= Number(filterValue);
+    case "is null":
+    case "empty":
+      return value == null || strValue === "";
+    case "is not null":
+    case "not_empty":
+      return value != null && strValue !== "";
+    case "in": {
+      const set = strFilter.split(",").map((s) => s.trim().toLowerCase());
+      return set.includes(strValue);
+    }
+    case "not in": {
+      const set = strFilter.split(",").map((s) => s.trim().toLowerCase());
+      return !set.includes(strValue);
+    }
+    case "between": {
+      const parts = strFilter.split(",").map((s) => Number(s.trim()));
+      const num = Number(value);
+      return parts.length === 2 && !isNaN(num) && !isNaN(parts[0]) && !isNaN(parts[1]) && num >= parts[0] && num <= parts[1];
+    }
+    case "is true":
+      return value === true || strValue === "true" || strValue === "1";
+    case "is false":
+      return value === false || strValue === "false" || strValue === "0";
+    default:
+      return true;
+  }
+}
+function useLocalHeaderFilter(data, options) {
+  const fieldCatalog = computed(() => {
+    const cols = options == null ? void 0 : options.filterableColumns;
+    if (!(cols == null ? void 0 : cols.length)) return {};
+    const catalog = {};
+    for (const col of cols) {
+      catalog[col.prop] = {
+        type: col.type || "string",
+        filter: true,
+        allowedField: col.prop
+      };
+    }
+    return catalog;
+  });
+  const {
+    headerFiltersState,
+    orderByState,
+    upsertHeaderFilter,
+    removeHeaderFilter,
+    setOrderBy,
+    getOpsByProp,
+    isEnabled: _isEnabled
+  } = useHeaderFilter({
+    headerFilterConfig: () => ({
+      enabled: true,
+      fieldCatalog: fieldCatalog.value
+    }),
+    hideHeaderFilter: () => false
+  });
+  const filteredData = computed(() => {
+    let result = [...unref(data) || []];
+    if (headerFiltersState.filters.length > 0) {
+      result = result.filter((row) => {
+        const record = row;
+        return headerFiltersState.filters.every(
+          (filter) => matchFilter(record[filter.field], filter.op, filter.value)
+        );
+      });
+    }
+    if (orderByState.length > 0) {
+      result.sort((a, b) => {
+        const recA = a;
+        const recB = b;
+        for (const order of orderByState) {
+          const cmp = compareValues(recA[order.field], recB[order.field]);
+          if (cmp !== 0) return order.direction === "asc" ? cmp : -cmp;
+        }
+        return 0;
+      });
+    }
+    return result;
+  });
+  const handleFilterConfirm = (payload) => {
+    var _a;
+    const field = String(((_a = payload.column) == null ? void 0 : _a.prop) || "");
+    upsertHeaderFilter(field, payload.op, payload.value);
+  };
+  const handleFilterReset = (payload) => {
+    var _a;
+    const field = String(((_a = payload.column) == null ? void 0 : _a.prop) || "");
+    removeHeaderFilter(field);
+  };
+  const handleSortChange = (payload) => {
+    setOrderBy(payload.field, payload.direction);
+  };
+  const resetAllFilters = () => {
+    headerFiltersState.filters.splice(0);
+    orderByState.splice(0);
+  };
+  const hasActiveFilters = computed(() => {
+    return headerFiltersState.filters.length > 0 || orderByState.length > 0;
+  });
+  return {
+    filteredData,
+    headerFiltersState,
+    orderByState,
+    handleFilterConfirm,
+    handleFilterReset,
+    handleSortChange,
+    getOpsByProp,
+    resetAllFilters,
+    hasActiveFilters
+  };
+}
+
+export { useLocalHeaderFilter };