foggy-data-viewer 1.0.1-beta.34 → 1.0.1-beta.35

package/README.md

@@ -139,16 +139,19 @@ function handlePageChange(page: number, pageSize: number) {
 | columns | `EnhancedColumnSchema[]` | - | 列配置（必填） |
 | data | `any[]` | - | 表格数据（必填） |
 | total | `number` | - | 总数据量（必填） |
-| loading | `boolean` | `false` | 加载状态 |
-| pageSize | `number` | `50` | 每页显示数量 |
-| showFilters | `boolean` | `true` | 是否显示筛选器 |
-| serverSummary | `object \| null` | `null` | 服务端汇总数据 |
-| initialSlice | `SliceCondition[]` | - | 初始筛选条件 |
-| filterOptionsLoader | `Function` | - | 筛选选项加载器 |
-
-### DataTable Events
-
-| 事件名 | 参数 | 说明 |
+| loading | `boolean` | `false` | 加载状态 |
+| pageSize | `number` | `50` | 每页显示数量 |
+| showFilters | `boolean` | `true` | 是否显示筛选器 |
+| localFilter | `boolean` | `true` | 是否把列头筛选条件应用到当前 `data` |
+| serverSummary | `object \| null` | `null` | 服务端汇总数据 |
+| initialSlice | `SliceCondition[]` | - | 初始筛选条件 |
+| filterOptionsLoader | `Function` | - | 筛选选项加载器 |
+
+`DataTableWithSearch` 在 `schema + fetchData` 服务端查询模式下默认 `localFilter=false`：列头筛选仍会提交给 `fetchData`，但返回数据不会再被前端二次过滤，避免聚合字段、派生字段、字典展示字段被简单本地比较误删。需要纯前端过滤时，可显式设置 `localFilter=true` 或 `schema.localFilter=true`。
+
+### DataTable Events
+
+| 事件名 | 参数 | 说明 |
 |--------|------|------|
 | page-change | `(page, pageSize)` | 分页变化 |
 | sort-change | `(field, order)` | 排序变化 |

package/dist/components/DataTable.vue.d.ts

@@ -34,6 +34,8 @@ interface Props {
     showPager?: boolean;
     /** 初始过滤条件（来自后端缓存） */
     initialSlice?: SliceRequestDef[];
+    /** 是否把表头过滤条件应用到当前 data；服务端查询模式通常应关闭 */
+    localFilter?: boolean;
     /** 后端返回的全量汇总数据 */
     serverSummary?: Record<string, unknown> | null;
     /** 过滤选项加载器（用于维度列） */
@@ -121,6 +123,7 @@ declare const __VLS_component: import("vue").DefineComponent<Props, {
     pageSize: number;
     showFilters: boolean;
     showPager: boolean;
+    localFilter: boolean;
     density: TableDensity;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;

package/dist/components/DataTableWithSearch.vue.d.ts

@@ -28,6 +28,11 @@ interface Props {
     showPager?: boolean;
     /** 初始筛选条件 */
     initialSlice?: SliceRequestDef[];
+    /**
+     * 是否把 DataTable 表头过滤条件应用到当前页 data。
+     * schema + fetchData 模式默认 false，避免后端过滤后再被前端二次裁剪。
+     */
+    localFilter?: boolean;
     /** 服务端汇总数据 */
     serverSummary?: Record<string, unknown> | null;
     /** 过滤选项加载器 */
@@ -203,6 +208,7 @@ declare const __VLS_component: import("vue").DefineComponent<Props, {
     pageSize: number;
     showFilters: boolean;
     showPager: boolean;
+    localFilter: boolean;
     searchLayout: "horizontal" | "vertical";
     showSearchActions: boolean;
     filterMergeMode: "replace" | "merge";