Back to Details

hig-components-search

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Apple HIG: Navigation Components

Apple HIG：导航组件

Check for 
.claude/apple-design-context.md
before asking questions. Use existing context and only ask for information not already covered.
在提问前请查看 
.claude/apple-design-context.md
。利用现有上下文，仅询问未被覆盖的信息。

Key Principles

核心原则

  1. Search: discoverable with instant feedback. Place search fields where users expect them (top of list, toolbar/navigation bar). Show results as the user types.
  2. Page controls: position in a flat page sequence. For discrete, equally weighted pages (onboarding, photo gallery). Show current page and total count.
  3. Path controls: file hierarchy navigation. macOS path controls display location within a directory structure and allow jumping to any ancestor.
  4. Search scopes narrow large result sets. Provide scope buttons so users can filter without complex queries.
  5. Clear empty states for search. Helpful message suggesting corrections or alternatives, not a blank screen.
  6. Page controls are not for hierarchical navigation. Flat, linear sequences only. Use navigation controllers, tab bars, or sidebars for hierarchy.
  7. Keep path controls concise. Show meaningful segments only. Users can click any segment to navigate directly.
  8. Support keyboard for search. Command-F and system search shortcuts should activate search.
  1. 搜索：易于发现且提供即时反馈。将搜索框放置在用户预期的位置（列表顶部、工具栏/导航栏）。在用户输入时实时显示结果。
  2. 页面控制器：适用于扁平页面序列。用于离散、权重均等的页面（如引导页、相册）。显示当前页码和总页数。
  3. 路径控制器：文件层级导航。macOS 路径控制器显示在目录结构中的位置，并允许跳转到任意上级目录。
  4. 搜索范围：缩小大型结果集。提供范围按钮，让用户无需复杂查询即可筛选结果。
  5. 搜索空状态：清晰提示。显示有用的提示信息，建议修正或替代方案，而非空白屏幕。
  6. 页面控制器不适用于层级导航。仅适用于扁平、线性序列。层级导航请使用导航控制器、标签栏或侧边栏。
  7. 路径控制器保持简洁。仅显示有意义的分段。用户可点击任意分段直接跳转。
  8. 支持搜索键盘快捷键。Command-F 和系统搜索快捷键应能激活搜索功能。

Reference Index

参考索引

ReferenceTopicKey content
search-fields.mdSearch fieldsScopes, tokens, instant results, placement
page-controls.mdPage controlsDot indicators, flat page sequences
path-controls.mdPath controlsBreadcrumbs, ancestor navigation
参考文档主题核心内容
search-fields.md搜索框范围、标记、即时结果、放置位置
page-controls.md页面控制器点指示器、扁平页面序列
path-controls.md路径控制器面包屑、上级目录导航

Output Format

输出格式

  1. Component recommendation -- search field, page control, or path control, and why.
  2. Behavior specification -- interaction model (search-as-you-type, swipe for pages, click-to-navigate for paths).
  3. Platform differences across iOS, iPadOS, macOS, visionOS.
  1. 组件推荐 —— 搜索框、页面控制器或路径控制器，以及推荐理由。
  2. 行为规范 —— 交互模型（输入即搜索、滑动翻页、点击路径跳转）。
  3. 平台差异 —— iOS、iPadOS、macOS、visionOS 之间的区别。

Questions to Ask

需询问的问题

  1. What type of content is being searched or navigated?
  2. Which platforms?
  3. How large is the dataset?
  4. Is search the primary interaction?
  1. 要搜索或导航的内容类型是什么？
  2. 针对哪些平台？
  3. 数据集规模有多大？
  4. 搜索是否为主要交互方式？

Related Skills

相关技能

  • hig-components-menus -- Toolbars and menu bars hosting search and navigation controls
  • hig-components-controls -- Text fields, pickers, segmented controls in search interfaces
  • hig-components-dialogs -- Popovers and sheets for expanded search or filtering
  • hig-patterns -- Navigation patterns and information architecture
  • hig-foundations -- Typography and layout for navigation components
Built by Raintree Technology · More developer tools
  • hig-components-menus —— 承载搜索和导航控件的工具栏与菜单栏
  • hig-components-controls —— 搜索界面中的文本框、选择器、分段控件
  • hig-components-dialogs —— 用于扩展搜索或筛选的弹出框和表单页
  • hig-patterns —— 导航模式与信息架构
  • hig-foundations —— 导航组件的排版与布局
由 Raintree Technology 构建 · 更多开发者工具