トークンフィールド
トークンフィールドは、トークン (人々が簡単に選択して操作できるテキストブロック) を含むテキスト フィールドの一種です。
たとえば、Mail で新しいメッセージを作成する場合、アドレスフィールドはトークンフィールドです。人々が受信者を入力すると、受信者はテキストからトークン形式に変換されます。人々はこれらの受信者のトークンを選択し、ドラッグして並べ替えたり、個別に操作したりできます。
人々がフィールドにテキストを入力するときに、提案されたトークンのリストを人々に提示するようにトークンフィールドを構成できます。たとえば、人々がアドレスフィールドに入力すると、Mail は受信者を提案します。提案された受信者を選択すると、トークンとしてフィールドに挿入されます。
個々のトークンには、下向きの山印文字で示されるコンテキストメニューを含めることもできます。このコンテキストメニューには、トークンまたは編集中のオプションに関する情報を含めることができます。Mail では、受信者トークンには、受信者の編集、受信者を VIP としてマーク、受信者の連絡先カードの表示などのコマンドを含むコンテキストメニューが含まれています。
一部のトークンフィールドには、人々が選択してフィールドにドラッグできる、使用可能なトークンの別のリストが付随しています。たとえば、言語と地域の設定ペインでは、日付と時刻の形式フィールドにこのアプローチが使用されています。トークンフィールドにドラッグできる個々の日付と時刻のトークンを提供し、トークンのコンテキストメニューを使用して人々がフォーマットできます。
トークンは、状況によっては検索語を表すこともできます。検索フィールド を参照してください。
ベストプラクティス
コンテキストメニューで値を追加します。 人々には多くの場合、追加のオプションやトークンに関する情報を含む コンテキストメニュー が役立ちます。
テキストをトークンに変換する追加の方法を提供することを検討してください。 デフォルトでは、人々が入力するテキストは、コンマを入力するたびにトークンに変わります。return など、このアクションを呼び出す追加のショートカットを指定できます。
システムが提案するトークンを表示するまでの遅延をカスタマイズします。 デフォルトでは、提案はすぐに表示されます。ただし、提案の表示が速すぎると、入力中に気を散らす可能性があります。あなたのアプリがトークンを提案する場合は、遅延を快適なレベルに調整することを検討してください。
プラットフォームの考慮事項
iOS、iPadOS、tvOS、watchOS では利用できません。
リソース
開発者用文書
NSTokenField — AppKit (NSTokenField)