Tucano v0.37.2

Etiqueta

O estado de um registro: aprovado, em análise, vencido, rascunho. Nasceu para a coluna "situação" da tabela, que é onde ela sempre aparece, mas não depende dela: vale em card, em lista e ao lado de um título. Só classe.

Aprovado Em análise Vencido Novo Rascunho Sem ponto

Exemplos

O tom carrega o significado; o peso fica com o texto da linha.

Na tabela

A coluna de situação, lida de relance numa lista longa.

ContratoSituação
Padaria Pão QuentePago
Oficina Duas RodasEm análise
Clínica Bem-EstarVencido
Estúdio AuroraRascunho

Sem ponto

is-plain, para o que não é estado: versão, contagem, categoria.

v2.4 12 anexos Serviços Beta

Com ícone

O ícone ocupa o lugar do ponto: use com is-plain. Com stroke="currentColor" ele pega a cor do tom sozinho, e aria-hidden="true" deixa o leitor de tela ler só o texto.

Publicado Beta Pago Aguardando Urgente

Como usar

<span class="tuc-badge is-success">Aprovado</span>
<span class="tuc-badge is-warning">Em análise</span>
<span class="tuc-badge is-danger">Vencido</span>
<span class="tuc-badge is-info">Novo</span>
<span class="tuc-badge">Rascunho</span>
<span class="tuc-badge is-plain">12 anexos</span>

No Django

O tom é decisão do modelo, e não do template: assim ele é o mesmo na listagem, no detalhe e no e-mail.

class Contract(models.Model):
    status = models.CharField(max_length=20, choices=Status.choices)

    @property
    def status_tone(self):
        return {"paid": "success", "review": "warning", "overdue": "danger"}.get(self.status, "")
<span class="tuc-badge {% if contract.status_tone %}is-{{ contract.status_tone }}{% endif %}">
  {{ contract.get_status_display }}
</span>

Por que não preenchida

Fundo suave com texto forte. Numa lista de vinte linhas, vinte etiquetas sólidas competem com o conteúdo e a tabela vira um semáforo.

O ponto repete o estado sem depender só da cor de fundo — ajuda quem não distingue as cores, somado ao texto, e desenha melhor em tela pequena. Ele é um pseudo-elemento, então o leitor de tela lê só o texto, e é o texto que precisa dizer o estado: "Vencido", e não uma etiqueta vermelha vazia.

A cor é a mesma do toast e do aviso

Os tons leem --tuc-success, --tuc-warning, --tuc-danger, --tuc-info e os -soft, e nunca o --tuc-accent. A marca pode ser de qualquer cor; o significado de "vencido" não pode mudar junto com ela.

Classes

ClassePara quê
.tuc-badgeA etiqueta. Sem tom, neutra, com borda
is-successDeu certo: aprovado, pago, ativo
is-warningPede atenção: em análise, pendente
is-dangerDeu errado: vencido, recusado, bloqueado
is-infoInformação: novo, agendado
is-plainTira o ponto