hig-components-search

Apple HIG：导航组件

提问前，请检查 .claude/apple-design-context.md。使用已有上下文，仅询问其中尚未涵盖的信息。

关键原则

1. 搜索：易于发现，即时反馈。 根据平台和使用场景选择位置，包括 iOS 上的底部搜索／标签栏入口。在可行时，随着用户输入显示结果；远程搜索应使用防抖和取消机制。

2. 页面控件：在扁平的页面序列中定位。 适用于权重相同的离散页面（如引导页、照片图库）。显示当前页和总页数。

3. 路径控件：文件层级导航。 macOS 路径控件会显示目录结构中的位置，并允许跳转到任意上级目录。

4. 搜索范围可缩小大型结果集。 类别明确时，可考虑使用范围控件；默认使用较宽泛的范围，避免不必要的控件。

5. 为搜索提供清晰的空状态。 显示有帮助的信息，提示用户修正搜索或尝试其他方式，而不是显示空白屏幕。

6. 页面控件不用于层级导航。 页面控件仅适用于扁平的线性序列。层级导航应使用导航堆栈、边栏或分栏视图；标签栏则用于表示同级目的地。

7. 路径控件应简洁。 仅显示有意义的层级段。用户可以点击任意层级段直接导航。

8. 支持使用键盘搜索。 Command-F 和系统搜索快捷键应能启动搜索。

参考索引

参考资料	主题	主要内容
search-fields.md	搜索字段	范围、标记、即时结果、位置
page-controls.md	页面控件	圆点指示器、扁平页面序列
path-controls.md	路径控件	面包屑、上级目录导航

输出格式

1. 组件建议 -- 建议使用搜索字段、页面控件或路径控件，并说明原因。
2. 行为规范 -- 交互模式（输入时搜索、滑动翻页、点击路径导航）。
3. 平台差异 -- iOS、iPadOS、macOS、visionOS 之间的差异。

要询问的问题

1. 要搜索或导航的内容是什么类型？
2. 目标平台有哪些？
3. 数据集有多大？
4. 搜索是否是主要交互方式？

相关技能

• hig-components-menus -- 承载搜索和导航控件的工具栏与菜单栏
• hig-components-controls -- 搜索界面中的文本字段、选择器和分段控件
• hig-components-dialogs -- 用于扩展搜索或筛选的弹出框和工作表
• hig-patterns -- 导航模式与信息架构
• hig-foundations -- 导航组件的排版与布局

---

由 Raintree Technology 构建 · 更多开发者工具

适用场景

当需要执行概述中所述的工作流或操作时，可使用此技能。

示例

用户请求：

此任务请使用 @hig-components-search：提供 Apple HIG 对导航相关组件的指导，包括搜索字段、页面控件和路径控件。

限制

• 仅当任务明确符合上述范围时，才使用此技能。
• 不要将输出视为针对特定环境进行验证、测试或专家审核的替代品。
• 如果缺少必要的输入、权限、安全边界或成功标准，请暂停并要求澄清。