macOS 介面 深入了解 B · 官方指南或詞彙 平台: macOS

Token Field

Token 欄位

Token 欄位(Token Field)會把每個辨識成功的值變成可單獨移除的項目,使用者也能繼續輸入更多內容。

動手試試看
也有人這樣說 Token FieldToken 欄位tokenized fieldrecipient fieldNSTokenField

動手試試看

生活中的例子

電子郵件欄位把有效地址轉成 Token 項目。寄出前會標示無效地址。

主要部分

  1. 01持續顯示的標籤
  2. 02輸入控制項
  3. 03提示或格式
  4. 04驗證訊息

什麼時候用

App 能辨識多個結構化值時,可以使用。每個值都要能驗證、自動完成、個別選取和移除。

什麼時候不要用

不要把自由文字、單一值、語意不明的未完成輸入,或無法清楚容納完整標籤與驗證錯誤的項目切成 Token。

程式裡的名稱

AppKit NSTokenField

上線前要檢查

檢查支援的 macOS 版本,以及 AppKit 或 SwiftUI 整合。檢查符合平台慣例的焦點與鍵盤操作。再檢查 VoiceOver、完整鍵盤控制、視窗縮放和多視窗狀態。需要時,也要檢查還原、多語系與減少動態效果。

可以直接複製的需求

預期成果:在原生 macOS 應用程式中使用或檢查 Token 欄位 (Token Field),並遵守平台慣例。 使用者情境:電子郵件欄位把有效地址轉成 Token 項目。寄出前會標示無效地址。 macOS 概念或控制項:Token 欄位 (Token Field)。 適用理由:App 能辨識多個結構化值時,可以使用。每個值都要能驗證、自動完成、個別選取和移除。 不應使用的情況:不要把自由文字、單一值、語意不明的未完成輸入,或無法清楚容納完整標籤與驗證錯誤的項目切成 Token。 平台要求:列出支援的 macOS 版本。說明哪些部分由 AppKit 或 SwiftUI 負責,以及兩者如何連接。定義視窗、選單、焦點、鍵盤、狀態保存、還原與多視窗行為。 平台無障礙與韌性:使用正確的無障礙功能介面(Accessibility API)。檢查 VoiceOver 與完整鍵盤控制(Full Keyboard Access)。支援多語系、對比與減少動態效果,並在重新開啟後保留使用者狀態。 驗收條件:在支援的 macOS 版本,用鍵盤與 VoiceOver 檢查行為。視窗縮放、焦點、狀態還原,以及 AppKit 或 SwiftUI 整合都符合 macOS 慣例。 證據與限制(證據邊界):它只代表該來源的官方說法。其他平台或團隊可能有不同用法。 待確認:支援的 macOS 版本、AppKit 或 SwiftUI 架構、視窗模式、沙盒與應用程式權限限制、資料保留規則,以及無障礙目標。

檢查這份需求

請 AI 程式助手檢查目前如何使用 Token 欄位 (Token Field)。 定義:Token 欄位(Token Field)會把每個辨識成功的值變成可單獨移除的項目,使用者也能繼續輸入更多內容。 正式環境檢查:檢查支援的 macOS 版本,以及 AppKit 或 SwiftUI 整合。檢查符合平台慣例的焦點與鍵盤操作。再檢查 VoiceOver、完整鍵盤控制、視窗縮放和多視窗狀態。需要時,也要檢查還原、多語系與減少動態效果。 修改程式前,先列出看到的證據、缺口、嚴重程度,以及最小且安全的修正。

B
這個術語有多正式?

官方指南或詞彙

列出的平台、框架、專案或專業組織,有發布這個術語的官方指南。

它只代表該來源的官方說法。其他平台或團隊可能有不同用法。

適用範圍
只包含來源有說明的內容:正式名稱、定義、平台 API、實作、使用指南
文件狀態
穩定
查證日期
2026-07-30

證據來源與適用範圍

正式來源 · Apple · 穩定 NSTokenField 適用範圍: 正式名稱、定義、平台 API、實作、使用指南 本頁用途: 只支援寫明的範圍 來源涵蓋內容: 正式名稱, 定義, 平台 API, 實作, 使用指南 背景資料 Apple Human Interface Guidelines — Designing for macOS 本頁用途: 提供背景,不是正式定義

自行複製

瀏覽器無法自動複製。請選取下方文字,再自行複製。