---

name: hig-components-search description: Apple HIG中与导航相关组件的指导，包括搜索栏、页面控件和路径控件。 risk: safe source: community date_added: '2026-02-27'

Apple HIG：导航组件

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

关键原则

1. 搜索：可发现且有即时反馈。 将搜索栏放在用户期望的位置（列表顶部、工具栏/导航栏）。在用户输入时显示结果。

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 构建 · 更多开发者工具

使用场景

当任务明确匹配上述概述中描述的范围时，此技能适用。

限制

• 仅在任务明确匹配上述描述的范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少所需的输入、权限、安全边界或成功标准，请停下来要求澄清。