开发预览更新于 2026-05-10

GlobalSearch 全局搜索

全屏覆盖式应用级搜索，支持分类切换 + 分组列表 + path / badge / shortcut。

基础用法

与 CommandPalette 区别：本组件全屏覆盖（paddingTop 8vh），自带类目过滤芯片 + 标题/路径/badge 三列布局。适合”应用 spotlight”场景；命令面板适合”⌘K 命令搜索”场景。

<CfGlobalSearch
:open="open"
:results="results"
@update:open="setOpen"
@select="onSelect"
/>

<CfGlobalSearch
open={open}
onOpenChange={setOpen}
results={results}
onSelect={onSelect}
/>

18 个跨 5 个类目的结果。点击顶部 chip 过滤；类目数量 ≤ 1 时自动隐藏 chip 行。

<CfGlobalSearch ... :show-categories="true" />

<CfGlobalSearch ... showCategories />

属性	类型	默认值	说明
`open` / `v-model:open`	`boolean`	—
`results`	`GlobalSearchResult[]`	—	`{ id, title, description?, category, badge?, path?, shortcut?, keywords?, disabled? }`
`placeholder` / `emptyText`
`showCategories`	`boolean`	`true`	顶部分类芯片
`closeOnSelect`	`boolean`	`true`

键盘：↑↓ 导航 · ↵ 选中 · Esc 关闭。