macOS 界面 深入了解 B · 官方指南或术语 平台: macOS

macOS Search Field

macOS 搜索字段

macOS 搜索框(Search Field)是专门用来搜索的文本框,提供系统查询和清除控件,也可以显示最近搜索。

看看怎样运作
也有人这样说 macOS Search FieldmacOS 搜索字段search fieldNSSearchFieldsearchable

看看怎样运作

原创情境示例macOS 搜索字段

另一个例子

输入文件名立即筛选来源列表,按 Escape 清除查询并恢复所有项目。

主要部分

  1. 01持续显示的标签
  2. 02输入控件
  3. 03提示或格式
  4. 04验证信息

什么时候用

当输入文字会搜索或筛选明确的数据集合,而且结果能快速更新,也能清楚显示无结果和已清除状态时使用。

什么时候不要用

不要把搜索字段外观用于命令、任意筛选或精确数据输入;实时查询如果很慢或会在没有提示时改变结果也不适合。

代码里的名称

AppKit NSSearchField / SwiftUI searchable

上线前要检查

检查支持的 macOS 版本,以及 AppKit 或 SwiftUI 集成。检查符合平台惯例的焦点与键盘操作。再检查 VoiceOver、全键盘控制、窗口缩放和多窗口状态。需要时,也要检查恢复、多语言与减少动态效果。

可以直接复制的需求

预期结果:在原生 macOS 应用中使用或检查 macOS 搜索字段 (macOS Search Field),并遵守平台惯例。 用户场景:输入文件名立即筛选来源列表,按 Escape 清除查询并恢复所有项目。 macOS 概念或控件:macOS 搜索字段 (macOS Search Field)。 适用理由:当输入文字会搜索或筛选明确的数据集合,而且结果能快速更新,也能清楚显示无结果和已清除状态时使用。 不应使用的情况:不要把搜索字段外观用于命令、任意筛选或精确数据输入;实时查询如果很慢或会在没有提示时改变结果也不适合。 平台要求:列出支持的 macOS 版本。说明哪些部分由 AppKit 或 SwiftUI 负责,以及两者如何连接。定义窗口、菜单、焦点、键盘、状态保存、恢复与多窗口行为。 平台无障碍与韧性:使用正确的无障碍功能接口(Accessibility API)。检查 VoiceOver 与全键盘控制(Full Keyboard Access)。支持多语言、对比度与减少动态效果,并在重新打开后保留用户状态。 验收标准:在支持的 macOS 版本,用键盘与 VoiceOver 检查行为。窗口缩放、焦点、状态恢复,以及 AppKit 或 SwiftUI 集成都符合 macOS 惯例。 证据与限制(证据边界):它只代表该来源的官方说法。其他平台或团队可能有不同用法。 待确认:支持的 macOS 版本、AppKit 或 SwiftUI 架构、窗口模式、沙盒与应用权限限制、数据保留规则,以及无障碍目标。

检查这份需求

请 AI 编程助手检查当前如何使用 macOS 搜索字段 (macOS Search Field)。 定义:macOS 搜索框(Search Field)是专门用来搜索的文本框,提供系统查询和清除控件,也可以显示最近搜索。 生产环境检查:检查支持的 macOS 版本,以及 AppKit 或 SwiftUI 集成。检查符合平台惯例的焦点与键盘操作。再检查 VoiceOver、全键盘控制、窗口缩放和多窗口状态。需要时,也要检查恢复、多语言与减少动态效果。 修改程序前,先列出看到的证据、缺口、严重程度,以及最小且安全的修正。

B
这个术语有多正式?

官方指南或术语

列出的平台、框架、项目或专业组织,发布了这个术语的官方指南。

它只代表该来源的官方说法。其他平台或团队可能有不同用法。

适用范围
只包含来源有说明的内容:正式名称、定义、平台 API、实现、使用指南
文档状态
稳定
核验日期
2026-07-30

证据来源与适用范围

正式来源 · Apple · 稳定 Search fields 适用范围: 正式名称、定义、平台 API、实现、使用指南 本页用途: 只支持写明的范围 来源涵盖内容: 正式名称, 定义, 平台 API, 实现, 使用指南 背景资料 Apple Human Interface Guidelines — Designing for macOS 本页用途: 提供背景,不是正式定义

自行复制

浏览器无法自动复制。请选择下方文字,再自行复制。