cloudpivot-sheet-filter 1.0.2 → 1.0.4

package/README.md

@@ -11,32 +11,39 @@
 ### 通过 CDN 使用
 
 #### ES 模块方式
+
 ```javascript
-const sheetFilter, { FilterOperators } = import('https://cdn.jsdelivr.net/npm/cloudpivot-sheet-filter/+esm');
+import("https://cdn.jsdelivr.net/npm/cloudpivot-sheet-filter/+esm").then(
+  ({ default: sheetFilter, FilterOperators }) => {
+    // 此处写自己的代码...
+  },
+);
 ```
 
 ## 基本使用
 
 ```javascript
 // 导入模块
-import sheetFilter, { FilterOperators } from 'cloudpivot-sheet-filter';
-
-// 子表筛选定义
-var sheetF = null;
-
-// 子表筛选类实例化
-sheetF = new sheetFilter();
-
-// 添加筛选条件：检结果等于NG
-// 第一个参数 'Radio1719304490857' 是子表内的控件的编码
-sheetF.addFilter('Radio1719304490857', FilterOperators.EQ, 'NG');
-
-// 启用筛选
-// 第一个参数 this.Sheet1719303475853 是子表的对象
-sheetF.filter(this.Sheet1719303475853, true);
-
-// 关闭筛选
-// sheetF.filter(this.Sheet1719303475853, false);
+import("https://cdn.jsdelivr.net/npm/cloudpivot-sheet-filter/+esm").then(
+  ({ default: sheetFilter, FilterOperators }) => {
+    // 子表筛选定义
+    var sheetF = null;
+
+    // 子表筛选类实例化
+    sheetF = new sheetFilter();
+
+    // 添加筛选条件：检结果等于NG
+    // 第一个参数 'Radio1719304490857' 是子表内的控件的编码
+    sheetF.addFilter("Radio1719304490857", FilterOperators.EQ, "NG");
+
+    // 启用筛选
+    // 第一个参数 this.Sheet1719303475853 是子表的对象
+    sheetF.filter(this.Sheet1719303475853, true);
+
+    // 关闭筛选
+    // sheetF.filter(this.Sheet1719303475853, false);
+  },
+);
 ```
 
 ## 高级用法
@@ -47,7 +54,7 @@ sheetF.filter(this.Sheet1719303475853, true);
 
 ```javascript
 // 添加筛选条件
-sheetF.addFilter('Radio1719304490857', FilterOperators.EQ, 'NG');
+sheetF.addFilter("Radio1719304490857", FilterOperators.EQ, "NG");
 
 // 预筛选，获取筛选结果但不修改子表
 const previewResult = sheetF.previewFilter(this.Sheet1719303475853);
@@ -56,7 +63,7 @@ const previewResult = sheetF.previewFilter(this.Sheet1719303475853);
 if (previewResult !== null) {
   // 有筛选结果，显示switch开关
   showFilterSwitch(true);
-  
+
   // 用户点击switch开关时应用筛选
   applyFilterButton.onclick = () => {
     sheetF.applyFilter(this.Sheet1719303475853, previewResult);
@@ -64,7 +71,7 @@ if (previewResult !== null) {
 } else {
   // 无筛选结果，隐藏switch开关或禁用
   showFilterSwitch(false);
-  alert('当前筛选条件无匹配结果，无法进行筛选操作');
+  alert("当前筛选条件无匹配结果，无法进行筛选操作");
 }
 ```
 
@@ -74,9 +81,9 @@ if (previewResult !== null) {
 // 链式调用添加多个筛选条件
 // 每个 addFilter 的第一个参数都是子表内的控件的编码
 sheetF
-  .addFilter('Radio1719304490857', FilterOperators.EQ, 'NG')  // 控件编码：Radio1719304490857
-  .addFilter('Number1719304500123', FilterOperators.GT, 100)  // 控件编码：Number1719304500123
-  .addFilter('Date1719304510456', FilterOperators.LTE, new Date());  // 控件编码：Date1719304510456
+  .addFilter("Radio1719304490857", FilterOperators.EQ, "NG") // 控件编码：Radio1719304490857
+  .addFilter("Number1719304500123", FilterOperators.GT, 100) // 控件编码：Number1719304500123
+  .addFilter("Date1719304510456", FilterOperators.LTE, new Date()); // 控件编码：Date1719304510456
 ```
 
 ### 设置筛选逻辑
@@ -90,7 +97,7 @@ sheetF.setOrLogic();
 
 // 获取当前筛选逻辑
 const logic = sheetF.getLogic();
-console.log('当前筛选逻辑:', logic); // 'AND' 或 'OR'
+console.log("当前筛选逻辑:", logic); // 'AND' 或 'OR'
 ```
 
 ### 清除筛选条件
@@ -105,18 +112,18 @@ sheetF.clearFilters();
 ```javascript
 // 检查是否已筛选
 const isFiltered = sheetF.isFiltered();
-console.log('是否已筛选:', isFiltered); // true 或 false
+console.log("是否已筛选:", isFiltered); // true 或 false
 ```
 
 ## 操作符说明
 
-| 操作符 | 描述 | 值 |
-|-------|------|----|
-| FilterOperators.EQ | 等于 | 'eq' |
-| FilterOperators.NEQ | 不等于 | 'neq' |
-| FilterOperators.LT | 小于 | 'lt' |
+| 操作符              | 描述     | 值    |
+| ------------------- | -------- | ----- |
+| FilterOperators.EQ  | 等于     | 'eq'  |
+| FilterOperators.NEQ | 不等于   | 'neq' |
+| FilterOperators.LT  | 小于     | 'lt'  |
 | FilterOperators.LTE | 小于等于 | 'lte' |
-| FilterOperators.GT | 大于 | 'gt' |
+| FilterOperators.GT  | 大于     | 'gt'  |
 | FilterOperators.GTE | 大于等于 | 'gte' |
 
 ## API 文档
@@ -124,6 +131,7 @@ console.log('是否已筛选:', isFiltered); // true 或 false
 ### sheetFilter 类
 
 #### 构造函数
+
 ```javascript
 const sheetF = new sheetFilter();
 ```
@@ -131,45 +139,60 @@ const sheetF = new sheetFilter();
 #### 方法
 
 ##### setAndLogic()
+
 设置筛选逻辑为 AND（默认）。
 
 ##### setOrLogic()
+
 设置筛选逻辑为 OR。
 
 ##### getLogic()
+
 返回当前筛选逻辑，'AND' 或 'OR'。
 
 ##### isFiltered()
+
 返回筛选状态，true 表示已筛选，false 表示未筛选。
 
 ##### clearFilters()
+
 清除所有筛选条件。
 
 ##### addFilter(columnKey, operator, value)
+
 添加筛选条件。
+
 - `columnKey`: 子表内的控件的编码（字符串）
 - `operator`: 操作符（字符串或 FilterOperators 常量）
 - `value`: 筛选值（任意类型）
 - 返回值：当前实例，支持链式调用
 
 ##### filter(key, enable)
+
 执行筛选操作。
+
 - `key`: 子表的对象
 - `enable`: true 启用筛选，false 关闭筛选
 
 ##### previewFilter(key)
+
 预筛选子表，获取筛选结果但不修改子表对象。
+
 - `key`: 子表的对象
 - 返回值：筛选结果 `{ index: [], value: [] }` 或 `null`（无匹配结果）
 
 ##### applyFilter(key, filteredList)
+
 应用筛选，根据预筛选结果修改子表对象。
+
 - `key`: 子表的对象
 - `filteredList`: 预筛选结果（可选，如果不提供则自动执行预筛选）
 - 返回值：`true` 成功应用筛选，`false` 筛选失败
 
 ##### cancelFilter(key)
+
 取消筛选，恢复原始子表数据。
+
 - `key`: 子表的对象
 - 返回值：`true` 成功取消筛选，`false` 取消失败
 
@@ -177,7 +200,7 @@ const sheetF = new sheetFilter();
 
 ```javascript
 // 导入模块
-import sheetFilter, { FilterOperators } from 'cloudpivot-sheet-filter';
+import sheetFilter, { FilterOperators } from "cloudpivot-sheet-filter";
 
 // 实例化
 const sheetF = new sheetFilter();
@@ -188,21 +211,21 @@ sheetF.setOrLogic();
 // 添加多个筛选条件
 // 第一个参数都是子表内的控件的编码
 sheetF
-  .addFilter('Radio1719304490857', FilterOperators.EQ, 'NG')  // 控件编码：Radio1719304490857
-  .addFilter('Number1719304500123', FilterOperators.GT, 100);  // 控件编码：Number1719304500123
+  .addFilter("Radio1719304490857", FilterOperators.EQ, "NG") // 控件编码：Radio1719304490857
+  .addFilter("Number1719304500123", FilterOperators.GT, 100); // 控件编码：Number1719304500123
 
 // 启用筛选
 // 第一个参数 this.Sheet1719303475853 是子表的对象
 sheetF.filter(this.Sheet1719303475853, true);
 
 // 检查筛选状态
-console.log('是否已筛选:', sheetF.isFiltered());
+console.log("是否已筛选:", sheetF.isFiltered());
 
 // 稍后关闭筛选
 setTimeout(() => {
   // 第一个参数 this.Sheet1719303475853 是子表的对象
   sheetF.filter(this.Sheet1719303475853, false);
-  console.log('筛选已关闭');
+  console.log("筛选已关闭");
 }, 5000);
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudpivot-sheet-filter",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "子表筛选工具 - Cloudpivot子表筛选解决方案",
   "main": "dist/index.esm.js",
   "module": "dist/index.esm.js",