Apple 平台导航类组件（搜索框、页控件…

在 iOS/iPadOS/macOS/visionOS 应用里设计搜索、分页浏览或文件路径导航时，按 Apple HIG 选择并规范 search field、page control、path control 的行为。

适用场景

解决思路

1. 先检查是否存在 `.claude/apple-design-context.md`，复用其中已有的上下文，只询问尚未覆盖的信息。
2. 搜索框放在用户预期的位置（列表顶部、工具栏或导航栏），并在用户输入过程中即时显示结果。
3. 为大结果集提供 search scopes（范围按钮），让用户无需编写复杂查询即可过滤结果。
4. 为搜索设计明确的空状态：给出有帮助的提示，建议修正关键词或提供替代方案，而不是显示空白页面。
5. 支持键盘操作：Command-F 和系统搜索快捷键应能激活搜索。
6. 页控件用于扁平的页面序列：适用于离散、权重相同的页面（如引导页、照片画廊），并显示当前页与总页数。
7. 页控件不能用于层级导航：扁平线性序列之外的层级结构应改用导航控制器、标签栏或侧边栏。
8. 路径控件用于文件层级导航（macOS）：显示当前所在目录结构中的位置，并允许跳转到任意祖先层级。
9. 保持路径控件简洁：只展示有意义的路径段，用户可点击任意段直接导航过去。
10. 按固定输出格式交付：1）组件推荐（search field、page control 还是 path control，并说明原因）；2）行为规格（搜索即输入即结果、滑动翻页、点击路径跳转等交互模型）；3）iOS、iPadOS、macOS、visionOS 各平台差异。
11. 按需查阅参考文档：`references/search-fields.md`（搜索范围、token、即时结果、位置）、`references/page-controls.md`（圆点指示器、扁平页面序列）、`references/path-controls.md`（面包屑、祖先导航）。
12. 先向用户确认四个问题：搜索或导航的内容类型是什么、目标平台有哪些、数据集规模多大、搜索是否为主要交互方式。
13. 必要时交叉参考相关技能：`hig-components-menus`（承载搜索与导航控件的工具栏/菜单栏）、`hig-components-controls`（搜索界面中的文本框、选择器、分段控件）、`hig-components-dialogs`（用于展开搜索或过滤的 popover 与 sheet）、`hig-patterns`（导航模式与信息架构）、`hig-foundations`（导航组件的排版与布局）。

适用边界 · 注意事项

• 目标平台不是 Apple 平台（如 Android、Web）时，这套 HIG 具体建议不直接适用。
• 需要层级式导航（目录树、多级跳转）时，不要使用页控件。
• 数据集小或搜索只是次要辅助功能时，不必为其引入 scopes、即时结果等完整搜索交互。