技能 Apple HIG: Navigation Components
📦

Apple HIG: Navigation Components

安全

实现 Apple 标准搜索和导航

获取 Apple 批准的搜索字段、页面控制和路径控制实现,遵循《人机界面指南》。确保您的应用导航在 iOS、macOS 和其他 Apple 平台上感觉原生且直观。

支持: Claude Codex Code(CC)
🥉 74 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“Apple HIG: Navigation Components”。 Where should search go in an iOS app with a tab bar?

预期结果:

对于带有标签栏的 iOS 应用,您有三个主要选项:1) 将搜索作为标签栏尾部的视觉上独特的标签(使搜索始终可见),2) 在底部工具栏中搜索(扩展字段或动画到字段的按钮),3) 在内容中内联搜索。当搜索是优先项且有空间时,Apple 建议放置在底部,因为更容易触达。考虑搜索字段是应该初始聚焦(键盘立即出现)还是未聚焦(促进发现),这取决于您应用的目标。

正在使用“Apple HIG: Navigation Components”。 What's the difference between page controls and path controls?

预期结果:

页面控制显示一排表示平面线性序列中页面的圆点指示器(如引导屏幕或照片库)。它们帮助用户在有序列表中的同级内容之间导航。路径控制显示所选项目的文件系统路径,显示从根磁盘到父文件夹再到当前项目的层次结构。路径控制仅限 macOS 用于文件导航(如 Finder 的路径栏),而页面控制用于 iOS/iPadOS 上离散内容页面的分页。

正在使用“Apple HIG: Navigation Components”。 How do I add search scope tokens like in Mail?

预期结果:

标记是搜索词的视觉表示,用户可以将其选择和编辑为过滤器。要在搜索字段中实现标记:1) 定义常见搜索词或项目(如 Mail 中的特定联系人或 Messages 中的照片过滤器),2) 应用视觉处理将术语封装为可选择的项目,3) 让标记过滤额外的搜索词,4) 考虑将标记与搜索建议配对,以便用户发现可用的标记,5) 使用 SwiftUI 的可搜索 API 或 UISearchTextField 支持标记。标记通过将搜索聚焦到特定属性来明确搜索意图。

安全审计

安全
v1 • 2/25/2026

All 200 static analysis findings are false positives from pattern matching on Markdown documentation content. This skill contains only Apple Human Interface Guidelines reference documentation with no executable code. The detected 'external_commands' patterns are inline code formatting (backticks in Markdown), 'network' patterns are legitimate documentation links to developer.apple.com, and 'blocker' patterns match words in UI component names and API references. This is safe documentation content.

3
已扫描文件
352
分析行数
0
发现项
1
审计总数
未发现安全问题
审计者: claude

质量评分

45
架构
100
可维护性
87
内容
50
社区
100
安全
74
规范符合性

你能构建什么

在 iOS 应用中实现搜索

iOS 开发者需要为应用添加搜索功能。他们使用此技能来了解搜索应放置在标签栏、工具栏还是内联位置,以及如何实现范围控制来过滤结果。

为照片库添加分页

开发照片库应用需要页面控制进行导航。他们查阅此技能来了解正确的页面控制放置位置、指示器自定义以及 iOS 与 watchOS 的平台特定行为。

设计 macOS 文件浏览器

Mac 开发者正在构建文件浏览器,需要路径控制进行面包屑导航。他们参考此技能来了解标准与弹出式路径控制的区别,以及在窗口主体与工具栏中的正确放置位置。

试试这些提示

基础搜索指导
iOS 应用中搜索字段应该放在哪里?应用底部有一个标签栏。
平台特定的页面控制
iOS 和 watchOS 的页面控制有什么区别?我正在开发一个同时面向两个平台的健身应用。
范围控制和标记
我正在开发一个类似 Mail 的应用。如何实现用于搜索过滤的范围控制和标记?
路径控制实现
我需要在 macOS 文档应用中显示文件层次结构导航。应该使用标准还是弹出式路径控制?应该放在哪里?

最佳实践

  • 用户输入时立即开始搜索,提供即时、持续优化的结果,而不是等待表单提交
  • 将搜索字段放置在用户期望的位置 - 通常在列表、工具栏或导航栏的顶部 - 并提供有占位符文本描述可以搜索的内容
  • 默认使用更广泛的搜索范围,让用户通过范围控制缩小范围,在优化前提供完整结果集的上下文

避免

  • 避免在搜索字段中使用通用占位符文本(如"搜索")- 它无法提供关于可搜索内容的有效上下文
  • 不要将页面控制用于层次结构导航 - 它们仅适用于所有页面权重相等的平面线性页面序列
  • 切勿将路径控制放在工具栏或状态栏中 - 它们属于窗口主体,如 Finder 窗口底部的路径栏

常见问题

此技能涵盖哪些平台?
此技能涵盖所有 Apple 平台:iOS、iPadOS、macOS、tvOS、watchOS 和 visionOS。它记录了搜索字段、页面控制和路径控制的平台特定考虑和行为(适用时)。
此技能是否提供代码示例?
不,此技能提供来自 Apple 人机界面指南的设计指导和最佳实践。它引用了 SwiftUI 和 UIKit 实现的官方 Apple API 文档,但不自行生成代码。
范围控制和标记有什么区别?
范围控制是分段控制,允许用户在搜索之前或期间选择搜索类别(如 Mail 中的全部与当前邮箱)。标记是特定搜索词的视觉表示,作为过滤器(如按特定联系人过滤)。您可以同时使用两者来实现强大的搜索过滤功能。
在标签栏中何时使用聚焦搜索与未聚焦搜索?
当您想要快速、临时的搜索体验时使用聚焦搜索(键盘立即出现)。使用未聚焦搜索(字段出现但键盘等待)来促进发现和探索,尤其是在内容丰富的应用(如 Music 或 TV)中。
我可以在 iOS 上使用路径控制吗?
不,根据 Apple 的 HIG,路径控制仅限 macOS。对于 iOS 文件层次结构导航,请考虑改用导航控制器、标签栏或侧边栏来表示层次关系。
多少个页面指示器算太多?
Apple 建议避免使用超过约 10 个页面指示器,因为它们会变得难以一眼辨认。如果您的应用需要超过 10 个同级页面,请考虑使用不同的排列方式,例如网格,让人们可以按任意顺序导航内容。