[HIG] Token fields
쉽게 선택하고 조작하는 텍스트 블록 토큰 필드
본 문서는 Apple의 Human Interface Guideline(이하 HIG) 문서를 한글로 번역한 것입니다. iOS 생태계 내에서 HIG를 읽으시는 분들이 번역본이 없어 불편함을 겪는 것을 알게 되었고, 이에 한글로 번역을 하게 되었습니다. iOS 커뮤니티 Async Swift에서 자율적으로 모인 9명이 함께 번역했으며, 일체의 상업적인 목적을 띄지 않습니다. 이 문서를 학습에 적극적으로 이용해 주시돼, 상업적인 용도로 이용하시는 것은 지양해 주시기 바랍니다. 감사합니다.
Introduction
토큰 필드(token field)는 사람들이 쉽게 선택하고 조작할 수 있는 텍스트 블록인 토큰을 포함하는 텍스트 필드(text field)입니다.
예를 들어 메일에서 새 메일을 작성할 때, 주소 필드를 토큰 필드(token field)라고 할 수 있습니다. 수신인을 입력하면 수신인은 텍스트에서 토큰 형식으로 변환됩니다. 사람들은 수신인 토큰을 선택하고 드래그하여 순서를 변경하거나 개별적인 작업을 할 수 있습니다.
사람들이 텍스트 필드에 내용을 입력할 때 제안된 토큰 목록을 표시하도록 토큰 필드(token field)를 설정할 수 있습니다. 예를 들어 메일은 이메일 주소를 입력할 때 수신인을 제안합니다. 제안된 수신인을 선택하면 필드에 토큰이 적용됩니다.
또한 개별 토큰은 콘텍스트 메뉴(contextual menu)를 포함할 수 있으며, 토큰이나 편집 옵션에 대한 정보를 포함할 수 있습니다. 메일에서 수신자 토큰은 수신인 편집이나 VIP 표시, 연락처 카드 확인 등이 포함된 콘텍스트 메뉴(contextual menu)가 있습니다.
일부 토큰 필드에는 사용 가능한 토큰의 개별 목록이 함께 제공되며 사람들은 토큰을 선택하거나 드래그하여 필드를 채울 수 있습니다. 예를 들어 언어 및 지역 설정의 날짜와 시간 필드에서 해당 방식을 사용하는데 드래그할 수 있는 개별 날짜 및 시간 토큰을 제공하며, 토큰의 콘텍스트 메뉴(contextual menu)를 사용하여 형식을 지정할 수 있습니다.
토큰은 상황에 따라 검색어를 나타낼 수도 있습니다. 관련 내용은 Search fields를 참고하세요.
Best Practices
컨텍스트 메뉴(context menu)를 사용하여 값을 추가합니다. 사람들은 주로 토큰의 추가 옵션이나 정보가 있는 context menu를 유용하게 사용합니다.
텍스트를 토큰으로 변환하는 추가 방법을 제공하는 것이 좋습니다. 기본적으로 사용자가 입력한 텍스트는 쉼표를 입력할 때마다 토큰으로 바뀌며 해당 동작을 호출하는 추가 단축키(예: 리턴)를 지정할 수 있습니다.
시스템이 제안하는 토큰 표시 시점을 조정하세요. 시스템 제안이 너무 빨리 나타나면 사용자의 입력에 방해될 수 있습니다. 만약 앱이 토큰을 제안한다면 적당한 시점에 토큰을 표시하는 것을 고려해 보세요.
Platform considerations
Not available in iOS, iPadOS, tvOS, and watchOS.
