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

Token Field

令牌字段

令牌输入框(Token Field)会把每个识别成功的值变成可单独删除的项目,用户也能继续输入更多内容。

动手试试看
也有人这样说 Token Field令牌字段tokenized fieldrecipient fieldNSTokenField

动手试试看

生活中的例子

电子邮件字段把有效地址转成令牌。发送前会标记无效地址。

主要部分

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

什么时候用

App 能识别多个结构化值时,可以使用。每个值都要能验证、自动补全、单独选中和删除。

什么时候不要用

不要把自由文本、单个值、含义不明的未完成输入,或无法清楚容纳完整标签与验证错误的项目转换成令牌。

代码里的名称

AppKit NSTokenField

上线前要检查

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

可以直接复制的需求

预期结果:在原生 macOS 应用中使用或检查 令牌字段 (Token Field),并遵守平台惯例。 用户场景:电子邮件字段把有效地址转成令牌。发送前会标记无效地址。 macOS 概念或控件:令牌字段 (Token Field)。 适用理由:App 能识别多个结构化值时,可以使用。每个值都要能验证、自动补全、单独选中和删除。 不应使用的情况:不要把自由文本、单个值、含义不明的未完成输入,或无法清楚容纳完整标签与验证错误的项目转换成令牌。 平台要求:列出支持的 macOS 版本。说明哪些部分由 AppKit 或 SwiftUI 负责,以及两者如何连接。定义窗口、菜单、焦点、键盘、状态保存、恢复与多窗口行为。 平台无障碍与韧性:使用正确的无障碍功能接口(Accessibility API)。检查 VoiceOver 与全键盘控制(Full Keyboard Access)。支持多语言、对比度与减少动态效果,并在重新打开后保留用户状态。 验收标准:在支持的 macOS 版本,用键盘与 VoiceOver 检查行为。窗口缩放、焦点、状态恢复,以及 AppKit 或 SwiftUI 集成都符合 macOS 惯例。 证据与限制(证据边界):它只代表该来源的官方说法。其他平台或团队可能有不同用法。 待确认:支持的 macOS 版本、AppKit 或 SwiftUI 架构、窗口模式、沙盒与应用权限限制、数据保留规则,以及无障碍目标。

检查这份需求

请 AI 编程助手检查当前如何使用 令牌字段 (Token Field)。 定义:令牌输入框(Token Field)会把每个识别成功的值变成可单独删除的项目,用户也能继续输入更多内容。 生产环境检查:检查支持的 macOS 版本,以及 AppKit 或 SwiftUI 集成。检查符合平台惯例的焦点与键盘操作。再检查 VoiceOver、全键盘控制、窗口缩放和多窗口状态。需要时,也要检查恢复、多语言与减少动态效果。 修改程序前,先列出看到的证据、缺口、严重程度,以及最小且安全的修正。

B
这个术语有多正式?

官方指南或术语

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

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

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

证据来源与适用范围

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

自行复制

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