Cor da rota
Verifica se o route_color de routes.txt é uma cor hexadecimal de 6 dígitos e, quando configurado, se consta da lista de valores permitidos.
Propriedades da regra
| Propriedade | Valor |
|---|---|
| Rule ID | route_color_valid_hex_string |
| Ficheiro | routes.txt |
| Campo | route_color |
| Tipo | Cor |
| Severidade | Obrigatório |
Descrição do campo: cor da rota, igual à usada no material apresentado ao público. A diferença entre route_color e route_text_color deve garantir contraste suficiente num ecrã a preto e branco.
Mais informação em routes.txt.
Como funciona
Quando a regra passa, o route_color é uma cor de 6 dígitos hexadecimais e, se a configuração da regra tiver uma lista de valores permitidos, consta dessa lista. A regra não verifica o contraste com route_text_color.
A regra avalia cada linha do routes.txt, seguindo os passos abaixo por ordem, até um deles dar o resultado.
| # | Pergunta | Se sim | Se não |
|---|---|---|---|
| 1 | O campo está vazio? | Verifica se a configuração da regra exige ou recomenda este campo. Se sim, reporta o problema. Se não, aceita | Segue para o passo 2 |
| 2 | A configuração da regra define que este campo não deve ser preenchido? | ❌ Reporta o problema | Segue para o passo 3 |
| 3 | O valor tem exatamente 6 dígitos hexadecimais (0 a 9 e A a F, maiúsculas ou minúsculas)? | Segue para o passo 4 | ❌ Reporta o problema: cor inválida |
| 4 | A configuração da regra tem uma lista de valores permitidos? | Segue para o passo 5 | ✅ Passa |
| 5 | O valor está na lista? (ou a lista aceita qualquer valor) | ✅ Passa | ❌ Reporta o problema: valor não permitido |
O valor é escrito sem o símbolo #.
Exemplos
| Valor | Resultado | Porquê |
|---|---|---|
FF0000 | ✅ Passa | 6 dígitos hexadecimais |
ff0000 | ✅ Passa | Minúsculas são aceites |
#FF0000 | ❌ Problema | O # não é permitido |
F00 | ❌ Problema | Só 3 dígitos |
| (vazio) | ❌ Problema | Campo obrigatório sem valor |
Como corrigir
| Problema | Causa provável | O que fazer |
|---|---|---|
| Cor inválida | O valor tem o símbolo #, tem menos ou mais de 6 dígitos ou tem carateres que não são hexadecimais | Escrever route_color em routes.txt com 6 dígitos hexadecimais, por exemplo FF0000 |
| Valor não permitido | O valor está fora da lista de valores permitidos da configuração da regra | Usar um valor da lista em route_color em routes.txt, ou pedir ao administrador que o adicione |
| Campo em falta | A configuração da regra exige ou recomenda este campo | Preencher route_color em routes.txt |
| Campo preenchido quando não devia | A configuração da regra define que este campo não deve ter valor | Remover o valor de route_color em routes.txt |