Skip to content

Seleção (Dropdown)

Configure um campo de seleção dropdown no Potato para anotação de escolha única com listas longas de opções — pesquisável, com valores padrão opcionais e navegação por teclado.

O tipo select oferece um menu suspenso para seleção única. Ideal para listas mais longas de opções (5 ou mais), em que botões de rádio sobrecarregariam visualmente a interface.

Configuração Básica

yaml
annotation_schemes:
  - name: "category"
    description: "Select the document category"
    annotation_type: "select"
    labels:
      - name: "news"
      - name: "opinion"
      - name: "tutorial"
      - name: "review"
      - name: "other"

Opções de Configuração

CampoTipoObrigatórioDescrição
namestringSimIdentificador único para a anotação
descriptionstringSimInstruções exibidas aos anotadores
annotation_typestringSimDeve ser "select"
labelsarraySimLista de opções para escolher
defaultstringNãoOpção selecionada por padrão
requiredbooleanNãoDefine se a seleção é obrigatória

Exemplos

Classificação de Documentos

yaml
- name: "document_type"
  description: "What type of document is this?"
  annotation_type: "select"
  labels:
    - name: "Research Paper"
    - name: "News Article"
    - name: "Blog Post"
    - name: "Technical Documentation"
    - name: "Legal Document"
    - name: "Marketing Material"
    - name: "Personal Communication"
    - name: "Other"
  required: true

Seleção de Idioma

yaml
- name: "language"
  description: "What language is this text written in?"
  annotation_type: "select"
  labels:
    - name: "English"
    - name: "Spanish"
    - name: "French"
    - name: "German"
    - name: "Chinese"
    - name: "Japanese"
    - name: "Other"
  default: "English"

Com Tooltips

yaml
- name: "genre"
  description: "Select the genre of this text"
  annotation_type: "select"
  labels:
    - name: "Fiction"
      tooltip: "Made-up stories and narratives"
    - name: "Non-fiction"
      tooltip: "Factual content based on real events"
    - name: "Poetry"
      tooltip: "Verse and poetic forms"
    - name: "Drama"
      tooltip: "Scripts and theatrical works"

Formato de Saída

A anotação select gera o nome da opção selecionada:

json
{
  "id": "item_1",
  "annotations": {
    "category": "tutorial"
  }
}

Quando Usar Select vs. Radio

Use SelectUse Radio
5 ou mais opções2 a 5 opções
Opções bem conhecidas dos anotadoresNecessário ver todas as opções de uma vez
Espaço é limitadoAtalhos de teclado são importantes
Rótulos de opção longosNecessária varredura visual rápida

Boas Práticas

  1. Ordene as opções de forma lógica - alfabeticamente, por frequência ou por agrupamento semântico
  2. Inclua a opção "Other" - quando a lista pode não ser exaustiva
  3. Use rótulos claros e distintos - evite categorias ambíguas ou sobrepostas
  4. Defina padrões sensatos - se uma opção é a mais comum, considere torná-la o padrão