Atributo🔗

Definição. Par chave-valor associado a um nó, exibido numa tabela abaixo do texto e acessível a filtros, fórmulas e scripts.

O verbete atributo aparece também no glossário consolidado do guia.

No arquivo🔗

<node TEXT="Contratar desenvolvedora" ID="ID_1">
  <attribute NAME="responsável" VALUE="Ana"/>
  <attribute NAME="prazo" VALUE="2026-09-15"/>
  <attribute NAME="custo" VALUE="12000"/>
</node>

Os valores são sempre texto no arquivo. A conversão para número ou data acontece no uso — em fórmulas com num0, em filtros com operadores numéricos, em ordenações.

O registro de atributos🔗

<attribute_registry> no topo do mapa guarda as chaves conhecidas e, opcionalmente, os valores permitidos para cada uma. É o que Editar → Atributos → Gerenciar atributos do mapa edita.

Registrar chaves resolve o problema central dos atributos: responsavel, Responsável e resp como três coisas diferentes. Restringir valores resolve o segundo: concluído e concluido como dois estados.

O registro permite ainda definir se novas chaves podem ser criadas livremente ou só a partir da lista.

Visibilidade🔗

Os quatro modos de Ver → Atributos:

Modo	Quando usar
Mostrar todos	Revisão de dados
Mostrar selecionados	Poucas chaves realmente importantes
Ocultar todos	Mapa para apresentar
Só do nó selecionado	Uso diário — o padrão mais confortável

Ocultar não remove: filtros, fórmulas e exportação continuam alcançando os valores.

Acesso🔗

Em fórmulas e scripts:

node['custo']                              // leitura
node['custo'] = '15000'                    // escrita (em script)
node.children.sum { it['custo'].num0 }     // agregação
node.attributes.names                      // lista de chaves
node.attributes.map                        // como Map

Em filtros: o campo “Atributo” com operadores existe, é igual a, contém, maior que, menor que e suas negações.

Em estilos condicionais: as mesmas condições, aplicando estilo automaticamente.

Atributo, detalhe ou nó filho🔗

Caso	Escolha
Propriedade curta, chave repetida em muitos nós	Atributo
Texto de leitura que acompanha o nó	Detalhe
Documentação de apoio	Nota
Parte do assunto, que vai se desdobrar	Nó filho

prazo: 2026-09-15 é atributo. Critérios de aceitação com cinco itens é ramo.

Convenções que se sustentam🔗

Chaves em minúsculas, sem espaço nem acento quando possível: responsavel, prazo, custo, status.
Datas em ISO (AAAA-MM-DD): ordenam corretamente como texto e são parseáveis.
Números sem separador de milhar e com ponto decimal, se houver.
Valores de estado restritos por lista.
Uma chave por informação — nada de dados: Ana;2026-09-15;12000.

Limites🔗

Não há tipos: tudo é texto, e a semântica está no uso.
Não há validação além da lista de valores permitidos.
Não há chaves repetidas com significado de lista — duas linhas com a mesma chave são permitidas mas confundem filtros.
A exportação para Markdown descarta atributos; HTML os preserva.

Erros comuns

Criar chaves livremente e só descobrir a divergência quando um filtro devolve menos nós do que deveria
Tratar valores como números: no arquivo tudo é texto, e a conversão só acontece no uso (num0, operadores numéricos)
Ocultar atributos e concluir que foram removidos — filtros, fórmulas e exportação continuam enxergando
Guardar em atributo um texto longo de leitura, que pertence a detalhe ou nota

Perguntas para reflexão

Que problema concreto o registro de atributos resolve, e como ele o resolve?
Por que 12000 num atributo não é um número, e o que o torna um?
Quando você escolheria atributo em vez de nó filho? E em vez de detalhe?
Escreva a condição de filtro que acha todo nó com prioridade igual a alta.

Atributo