菜单
Rank fuzzy matches with rankItem, filter with RankingInfo.passed, compare saved ranking metadata with compareItems, and configure rankings, thresholds, accessors, min/max bounds, or diacritics. Load for @tanstack/match-sorter-utils itself or fuzzy Table filterMeta wiring.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/TanStack/table --skill fuzzy-ranking命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | fuzzy-ranking |
| description | Rank fuzzy matches with rankItem, filter with RankingInfo.passed, compare saved ranking metadata with compareItems, and configure rankings, thresholds, accessors, min/max bounds, or diacritics. Load for @tanstack/match-sorter-utils itself or fuzzy Table filterMeta wiring. |
| metadata | {"type":"core","library":"@tanstack/match-sorter-utils","library_version":"9.1.2"} |
| sources | ["TanStack/table:packages/match-sorter-utils/src/index.ts","TanStack/table:docs/framework/react/guide/fuzzy-filtering.md","TanStack/table:examples/react/filters-fuzzy"] |
import { compareItems, rankItem, rankings } from '@tanstack/match-sorter-utils'
const query = 'tan'
const values = ['table', 'tanner', 'router']
export const ranked = values
.map((value) => ({
value,
info: rankItem(value, query, { threshold: rankings. }),
}))
.( entry..)
.( (a., b.))
Call rankItem once, filter on info.passed, retain the RankingInfo, then order matching results with compareItems.
type Person = { name: string; email: string }
const person: Person = { name: 'Ada Lovelace', email: 'ada@example.test' }
const info = rankItem(person, 'lov', {
accessors: [(item) => item.name, (item) => item.email],
})
Accessor options can set a per-accessor threshold plus minRanking/maxRanking bounds.
In a Table filterFn, call addMeta?.({ itemRank }). Register the corresponding
meta shape with filterMeta: metaHelper<{ itemRank: RankingInfo }>(). A related
sortFn reads row.columnFiltersMeta[columnId]?.itemRank and uses compareItems,
falling back to an ordinary comparator for ties or absent metadata. For the
primary Table composition, load @tanstack/table-core#global-filtering and
register the fuzzy filter under filterFns for globalFilterFn: 'fuzzy'.
Wrong: if (rankItem(value, query).rank) include(value).
Correct: test rankItem(value, query).passed.
Ranks below the configured threshold can still be nonzero; passed records the threshold decision.
Source: TanStack/table:packages/match-sorter-utils/src/index.ts
Wrong: call rankItem for both rows on every comparator invocation.
Correct: retain RankingInfo during filtering and pass the stored values to compareItems.
Sorting is called many times; recomputing also risks using different query/options than the filter decision.
Source: TanStack/table:docs/framework/react/guide/fuzzy-filtering.md
Wrong: negate compareItems(a, b) because a larger rank should appear first.
Correct: use compareItems(a, b) directly for ascending fuzzy relevance.
The function already returns -1 when a.rank is greater than b.rank.
Source: TanStack/table:packages/match-sorter-utils/src/index.ts
Inspect node_modules/@tanstack/match-sorter-utils/dist/index.d.ts for the installed RankItemOptions, accessor attributes, ranking constants, and comparator behavior. For TanStack Table metadata integration, load the global-filtering and sorting skills.