` 源码解析：分面过滤数值范围（min/max）的生成与记忆化实现)
前端UI组件【免费下载链接】table Headless UI for building powerful tables datagrids for TS/JS - React-Table, Vue-Table, Solid-Table, Svelte-Table项目地址https://gitcode.com/gh_mirrors/ta/table点击查看免费下载createFacetedMinMaxValues()是 TanStack Table本仓库 table-core 核心包中用于**分面过滤Faceted Filtering**的数值范围辅助函数工厂。它接收表格与列 ID返回一个被记忆化的读取函数该函数根据当前分面行模型推导出该列可用数值的[min, max]区间供范围滑块、数值输入框等过滤 UI 直接消费。读完本文你将掌握该函数的完整签名、底层算法、记忆化机制、__global__全局分面语义以及如何将它注册到tableFeatures并接入客户端或服务端分面场景。函数签名与核心职责关联文档createFacetedMinMaxValues 函数参考给出的完整签名如下function createFacetedMinMaxValuesTFeatures, TData(): (table, columnId) () [number, number] | undefined;类型参数类型参数约束默认值含义TFeaturesextendsTableFeatures无表格功能特性集合类型TDataextendsRowDataany行数据类型返回值柯里化工厂该函数是柯里化的三层结构每次调用返回一个更具体的函数第一次调用无参数返回(table, columnId) () [number, number] | undefined——一个针对指定表格与列的闭包工厂第二次调用传入table: TableTFeatures, TData类型见Table与columnId: string返回一个零参数读取函数第三次调用真正读取返回[number, number] | undefined——即[最小数值, 最大数值]元组当数据为空或列中没有可转换为数值的单元格时返回undefined。从 源码实现 看第二层返回的读取函数通过tableMemo包装export function createFacetedMinMaxValuesTFeatures, TData(): ( table: TableTFeatures, TData, columnId: string, ) () undefined | [number, number] { return (_table, columnId) { const table _table as unknown as Table_InternalTFeatures, TData return tableMemo({ feature: columnFacetingFeature, fn: (flatRows) _createFacetedMinMaxValues(table, columnId, flatRows), fnName: table.getFacetedMinMaxValues, memoDeps: () { /* 依赖收集 */ }, table, }) } }要点记忆化发生在第三层——只要依赖分面行模型的flatRows没有变化反复读取会直接返回缓存结果不会重复扫描数据。记忆化依赖从分面行模型取数createFacetedMinMaxValues的 memo 依赖决定了它何时重算其逻辑在memoDeps中普通列依赖column.getFacetedRowModel().flatRows。分面行模型会应用其他列的过滤条件、但排除本列自身的过滤条件因此当其他列的过滤状态变化时本列的范围会自动重算__global__全局上下文依赖table.getGlobalFacetedRowModel().flatRows全局分面行模型会应用列过滤条件但排除全局过滤自身列不存在时回退到table.getPreFilteredRowModel().flatRows即使用未过滤的行。这两条路径分别由工具函数column_getFacetedRowModel与table_getGlobalFacetedRowModel提供实现在 columnFacetingFeature.utils.ts。该文件同时展示了分面 getter 的工厂解析与缓存模式每个列 ID 对应的工厂函数只解析一次缓存在table._rowModels.facetedMinMaxValues映射中若table.options.features.facetedMinMaxValues未注册工厂则回退为() undefined。底层算法Number() 强制转换与 NaN 跳过真正执行范围计算的是内部函数_createFacetedMinMaxValues核心算法如下if (!flatRows.length) return undefined const columnIds columnId __global__ ? table .getAllLeafColumns() .filter((column) column_getCanGlobalFilter(column)) .map((column) column.id) : [columnId] let facetedMinValue Number.POSITIVE_INFINITY let facetedMaxValue Number.NEGATIVE_INFINITY let foundAny false for (let i 0; i flatRows.length; i) { for (let c 0; c columnIds.length; c) { const value Number(flatRows[i]!.getValue(columnIds[c]!)) if (Number.isNaN(value)) continue foundAny true if (value facetedMinValue) facetedMinValue value if (value facetedMaxValue) facetedMaxValue value } } if (!foundAny) return undefined return [facetedMinValue, facetedMaxValue]由此可以归纳出几个可验证的实现事实空行集flatRows.length 0时直接返回undefinedNumber()强制转换单元格值一律通过Number()转换因此数字字符串如40会被当作数值参与计算null会被转换为0NaN 跳过任何Number()结果为NaN的单元格如非数字文本被跳过不影响范围无有效数值若所有单元格都转换失败foundAny false返回undefined单行数据返回[x, x]即 min 与 max 相等全局分面当columnId __global__时聚合范围横跨所有可参与全局过滤的叶子列通过column_getCanGlobalFilter过滤并在所有行上求全局最小/最大值。注册与接入tableFeatures 与 row-model 槽要启用分面 min/max 功能需要将相关特性与工厂注册到tableFeatures。根据官方指南 Column Faceting Guide 与核心技能文档 column-faceting SKILL标准客户端配置如下import { columnFacetingFeature, columnFilteringFeature, createFacetedMinMaxValues, createFacetedRowModel, createFacetedUniqueValues, createFilteredRowModel, filterFns, tableFeatures, } from tanstack/table-core export const features tableFeatures({ columnFilteringFeature, filteredRowModel: createFilteredRowModel(), // 客户端过滤所需 filterFns, columnFacetingFeature, facetedRowModel: createFacetedRowModel(), // 分面行模型 facetedUniqueValues: createFacetedUniqueValues(), // 唯一值/计数 facetedMinMaxValues: createFacetedMinMaxValues(), // 数值范围 })常见错误提示仅仅注册columnFacetingFeature而不注册facetedMinMaxValues等 row-model 槽getter 将退化为返回undefinedfacetedUniqueValues退化返回空MapfacetedRowModel退化返回预过滤行模型。columnFacetingFeature本身不记忆化而是由各个内置createFaceted*工厂内部记忆化这一点在 columnFacetingFeature.ts 的注释中明确说明——这样做是为了避免冻结数据独立变化的自定义工厂。公开 API 消费注册后即可通过列 API 与表 API 读取范围类型定义见 columnFacetingFeature.types.ts// 单列范围应用于其他列过滤、排除本列过滤后的行 const range table.getColumn(age)?.getFacetedMinMaxValues() // 全局过滤范围聚合所有可全局过滤列 const globalRange table.getGlobalFacetedMinMaxValues() // 直接驱动范围滑块 const [min, max] table.getColumn(age)?.getFacetedMinMaxValues() ?? [0, 1]指南文档给出了典型的范围滑块接入方式const [min, max] column.getFacetedMinMaxValues() ?? [0, 1] return ( input typerange min{min} max{max} value{currentValue} onChange{(event) column.setFilterValue(Number(event.target.value))} / )注意min/max 仅描述可供过滤 UI 选择的数值区间行是否匹配由该列配置的 filter function 决定。测试验证真实实现的行为边界仓库中的两组测试用例对上述行为提供了直接佐证createFacetedRowModels.test.ts真实实现测试覆盖了数字列返回[min, max]数字字符串经Number()强转5/15→[5, 15]NaN 值跳过not-a-number被忽略返回[3, 7]无数字列返回undefined空数据返回undefined单行返回[42, 42]以及Number(null)为0的既有行为[0, 40]。该文件还验证了引用稳定性输入不变时重复读取返回同一引用而其他列过滤变化后立即重算如setColumnFilters后[30, 40]columnFacetingFeature.test.ts单元测试验证了工厂按列与全局上下文只解析一次facetedMinMaxValues被调用 2 次status与__global__确认了 getter 层的缓存语义。自定义服务端分面工厂当过滤在服务端完成时浏览器加载的行不足以计算完整范围。此时可以自定义facetedMinMaxValues工厂工厂接收(table, columnId)返回一个每次读取都会执行的函数表不缓存其结果因此应通过 signal、store 或table.options.meta读取最新服务端数据。自定义工厂同样会收到内部__global__列 ID可按需分支const features tableFeatures({ columnFacetingFeature, facetedMinMaxValues: (table, columnId) () { if (columnId __global__) { return table.options.meta?.serverFacets?.globalMinMax } return table.options.meta?.serverFacets?.minMaxValues[columnId] }, })若要匹配内置列分面语义服务端查询同样应应用其他列的过滤、排除本列自身的过滤从而在当前分面中保留备选选项、并允许多个分面互相收窄。小结createFacetedMinMaxValues()是分面过滤体系中数值范围的标准化产出者它通过柯里化工厂 tableMemo实现按需计算与引用稳定通过Number()强转与 NaN 跳过保证了对异构单元格的容错通过__global__特殊列 ID 支撑全局过滤的跨列聚合。无论是客户端范围滑块还是服务端分面元数据接入理解其签名、注册方式与底层算法都能帮助你准确预测它何时返回undefined、何时返回[min, max]从而写出更健壮的过滤 UI。相关代码可在 createFacetedMinMaxValues.ts自 src/index.ts 导出及分面特性目录packages/table-core/src/features/column-faceting/下继续深入阅读。赞分享前端UI组件【免费下载链接】table Headless UI for building powerful tables datagrids for TS/JS - React-Table, Vue-Table, Solid-Table, Svelte-Table项目地址https://gitcode.com/gh_mirrors/ta/table点击查看免费下载相关推荐TanStack Table Ember 分面Faceting指南构建多选过滤、数值范围与分桶过滤界面的完整实战TanStack Table Ember 分面Faceting指南构建多选过滤、数值范围与分桶过滤界面的完整实战 导读 分面Faceting是构建现代前端UI组件TanStack Table for Preact 列分面Column Faceting实战指南构建可计数、可搜索、可范围化的过滤 UITanStack Table for Preact 列分面Column Faceting实战指南构建可计数、可搜索、可范围化的过滤 UI 列分面Face前端UI组件Pot跨平台翻译软件终极指南如何轻松实现划词翻译与OCR识别Pot跨平台翻译软件终极指南如何轻松实现划词翻译与OCR识别 还在为阅读外文资料而烦恼吗Pot Desktop是一款完全免费的跨平台翻译神器集成了划词翻译前端UI组件上一篇AndroidResideMenu 项目常见问题解决方案下一篇HtmlTextView 项目常见问题解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 TanStack Table `createFacetedMinMaxValues()` 源码解析：分面过滤数值范围（min/max）的生成与记忆化实现
前端UI组件【免费下载链接】table Headless UI for building powerful tables datagrids for TS/JS - React-Table, Vue-Table, Solid-Table, Svelte-Table项目地址https://gitcode.com/gh_mirrors/ta/table点击查看免费下载createFacetedMinMaxValues()是 TanStack Table本仓库 table-core 核心包中用于**分面过滤Faceted Filtering**的数值范围辅助函数工厂。它接收表格与列 ID返回一个被记忆化的读取函数该函数根据当前分面行模型推导出该列可用数值的[min, max]区间供范围滑块、数值输入框等过滤 UI 直接消费。读完本文你将掌握该函数的完整签名、底层算法、记忆化机制、__global__全局分面语义以及如何将它注册到tableFeatures并接入客户端或服务端分面场景。函数签名与核心职责关联文档createFacetedMinMaxValues 函数参考给出的完整签名如下function createFacetedMinMaxValuesTFeatures, TData(): (table, columnId) () [number, number] | undefined;类型参数类型参数约束默认值含义TFeaturesextendsTableFeatures无表格功能特性集合类型TDataextendsRowDataany行数据类型返回值柯里化工厂该函数是柯里化的三层结构每次调用返回一个更具体的函数第一次调用无参数返回(table, columnId) () [number, number] | undefined——一个针对指定表格与列的闭包工厂第二次调用传入table: TableTFeatures, TData类型见Table与columnId: string返回一个零参数读取函数第三次调用真正读取返回[number, number] | undefined——即[最小数值, 最大数值]元组当数据为空或列中没有可转换为数值的单元格时返回undefined。从 源码实现 看第二层返回的读取函数通过tableMemo包装export function createFacetedMinMaxValuesTFeatures, TData(): ( table: TableTFeatures, TData, columnId: string, ) () undefined | [number, number] { return (_table, columnId) { const table _table as unknown as Table_InternalTFeatures, TData return tableMemo({ feature: columnFacetingFeature, fn: (flatRows) _createFacetedMinMaxValues(table, columnId, flatRows), fnName: table.getFacetedMinMaxValues, memoDeps: () { /* 依赖收集 */ }, table, }) } }要点记忆化发生在第三层——只要依赖分面行模型的flatRows没有变化反复读取会直接返回缓存结果不会重复扫描数据。记忆化依赖从分面行模型取数createFacetedMinMaxValues的 memo 依赖决定了它何时重算其逻辑在memoDeps中普通列依赖column.getFacetedRowModel().flatRows。分面行模型会应用其他列的过滤条件、但排除本列自身的过滤条件因此当其他列的过滤状态变化时本列的范围会自动重算__global__全局上下文依赖table.getGlobalFacetedRowModel().flatRows全局分面行模型会应用列过滤条件但排除全局过滤自身列不存在时回退到table.getPreFilteredRowModel().flatRows即使用未过滤的行。这两条路径分别由工具函数column_getFacetedRowModel与table_getGlobalFacetedRowModel提供实现在 columnFacetingFeature.utils.ts。该文件同时展示了分面 getter 的工厂解析与缓存模式每个列 ID 对应的工厂函数只解析一次缓存在table._rowModels.facetedMinMaxValues映射中若table.options.features.facetedMinMaxValues未注册工厂则回退为() undefined。底层算法Number() 强制转换与 NaN 跳过真正执行范围计算的是内部函数_createFacetedMinMaxValues核心算法如下if (!flatRows.length) return undefined const columnIds columnId __global__ ? table .getAllLeafColumns() .filter((column) column_getCanGlobalFilter(column)) .map((column) column.id) : [columnId] let facetedMinValue Number.POSITIVE_INFINITY let facetedMaxValue Number.NEGATIVE_INFINITY let foundAny false for (let i 0; i flatRows.length; i) { for (let c 0; c columnIds.length; c) { const value Number(flatRows[i]!.getValue(columnIds[c]!)) if (Number.isNaN(value)) continue foundAny true if (value facetedMinValue) facetedMinValue value if (value facetedMaxValue) facetedMaxValue value } } if (!foundAny) return undefined return [facetedMinValue, facetedMaxValue]由此可以归纳出几个可验证的实现事实空行集flatRows.length 0时直接返回undefinedNumber()强制转换单元格值一律通过Number()转换因此数字字符串如40会被当作数值参与计算null会被转换为0NaN 跳过任何Number()结果为NaN的单元格如非数字文本被跳过不影响范围无有效数值若所有单元格都转换失败foundAny false返回undefined单行数据返回[x, x]即 min 与 max 相等全局分面当columnId __global__时聚合范围横跨所有可参与全局过滤的叶子列通过column_getCanGlobalFilter过滤并在所有行上求全局最小/最大值。注册与接入tableFeatures 与 row-model 槽要启用分面 min/max 功能需要将相关特性与工厂注册到tableFeatures。根据官方指南 Column Faceting Guide 与核心技能文档 column-faceting SKILL标准客户端配置如下import { columnFacetingFeature, columnFilteringFeature, createFacetedMinMaxValues, createFacetedRowModel, createFacetedUniqueValues, createFilteredRowModel, filterFns, tableFeatures, } from tanstack/table-core export const features tableFeatures({ columnFilteringFeature, filteredRowModel: createFilteredRowModel(), // 客户端过滤所需 filterFns, columnFacetingFeature, facetedRowModel: createFacetedRowModel(), // 分面行模型 facetedUniqueValues: createFacetedUniqueValues(), // 唯一值/计数 facetedMinMaxValues: createFacetedMinMaxValues(), // 数值范围 })常见错误提示仅仅注册columnFacetingFeature而不注册facetedMinMaxValues等 row-model 槽getter 将退化为返回undefinedfacetedUniqueValues退化返回空MapfacetedRowModel退化返回预过滤行模型。columnFacetingFeature本身不记忆化而是由各个内置createFaceted*工厂内部记忆化这一点在 columnFacetingFeature.ts 的注释中明确说明——这样做是为了避免冻结数据独立变化的自定义工厂。公开 API 消费注册后即可通过列 API 与表 API 读取范围类型定义见 columnFacetingFeature.types.ts// 单列范围应用于其他列过滤、排除本列过滤后的行 const range table.getColumn(age)?.getFacetedMinMaxValues() // 全局过滤范围聚合所有可全局过滤列 const globalRange table.getGlobalFacetedMinMaxValues() // 直接驱动范围滑块 const [min, max] table.getColumn(age)?.getFacetedMinMaxValues() ?? [0, 1]指南文档给出了典型的范围滑块接入方式const [min, max] column.getFacetedMinMaxValues() ?? [0, 1] return ( input typerange min{min} max{max} value{currentValue} onChange{(event) column.setFilterValue(Number(event.target.value))} / )注意min/max 仅描述可供过滤 UI 选择的数值区间行是否匹配由该列配置的 filter function 决定。测试验证真实实现的行为边界仓库中的两组测试用例对上述行为提供了直接佐证createFacetedRowModels.test.ts真实实现测试覆盖了数字列返回[min, max]数字字符串经Number()强转5/15→[5, 15]NaN 值跳过not-a-number被忽略返回[3, 7]无数字列返回undefined空数据返回undefined单行返回[42, 42]以及Number(null)为0的既有行为[0, 40]。该文件还验证了引用稳定性输入不变时重复读取返回同一引用而其他列过滤变化后立即重算如setColumnFilters后[30, 40]columnFacetingFeature.test.ts单元测试验证了工厂按列与全局上下文只解析一次facetedMinMaxValues被调用 2 次status与__global__确认了 getter 层的缓存语义。自定义服务端分面工厂当过滤在服务端完成时浏览器加载的行不足以计算完整范围。此时可以自定义facetedMinMaxValues工厂工厂接收(table, columnId)返回一个每次读取都会执行的函数表不缓存其结果因此应通过 signal、store 或table.options.meta读取最新服务端数据。自定义工厂同样会收到内部__global__列 ID可按需分支const features tableFeatures({ columnFacetingFeature, facetedMinMaxValues: (table, columnId) () { if (columnId __global__) { return table.options.meta?.serverFacets?.globalMinMax } return table.options.meta?.serverFacets?.minMaxValues[columnId] }, })若要匹配内置列分面语义服务端查询同样应应用其他列的过滤、排除本列自身的过滤从而在当前分面中保留备选选项、并允许多个分面互相收窄。小结createFacetedMinMaxValues()是分面过滤体系中数值范围的标准化产出者它通过柯里化工厂 tableMemo实现按需计算与引用稳定通过Number()强转与 NaN 跳过保证了对异构单元格的容错通过__global__特殊列 ID 支撑全局过滤的跨列聚合。无论是客户端范围滑块还是服务端分面元数据接入理解其签名、注册方式与底层算法都能帮助你准确预测它何时返回undefined、何时返回[min, max]从而写出更健壮的过滤 UI。相关代码可在 createFacetedMinMaxValues.ts自 src/index.ts 导出及分面特性目录packages/table-core/src/features/column-faceting/下继续深入阅读。赞分享前端UI组件【免费下载链接】table Headless UI for building powerful tables datagrids for TS/JS - React-Table, Vue-Table, Solid-Table, Svelte-Table项目地址https://gitcode.com/gh_mirrors/ta/table点击查看免费下载相关推荐TanStack Table Ember 分面Faceting指南构建多选过滤、数值范围与分桶过滤界面的完整实战TanStack Table Ember 分面Faceting指南构建多选过滤、数值范围与分桶过滤界面的完整实战 导读 分面Faceting是构建现代前端UI组件TanStack Table for Preact 列分面Column Faceting实战指南构建可计数、可搜索、可范围化的过滤 UITanStack Table for Preact 列分面Column Faceting实战指南构建可计数、可搜索、可范围化的过滤 UI 列分面Face前端UI组件Pot跨平台翻译软件终极指南如何轻松实现划词翻译与OCR识别Pot跨平台翻译软件终极指南如何轻松实现划词翻译与OCR识别 还在为阅读外文资料而烦恼吗Pot Desktop是一款完全免费的跨平台翻译神器集成了划词翻译前端UI组件上一篇AndroidResideMenu 项目常见问题解决方案下一篇HtmlTextView 项目常见问题解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考