O que é dot.case
O dot.case coloca um ponto entre as palavras e mantém todas as letras minúsculas:
Database Connection Urlviradatabase.connection.urlhomePageTitlevirahome.page.titleerror_message_requiredviraerror.message.required
Os pontos costumam expressar uma hierarquia. Em app.server.port, “port” pertence a “server”, que pertence a “app”.
Como o conversor funciona
A ferramenta encontra as palavras de cada linha, passa tudo para minúsculas e junta com pontos. As palavras podem estar separadas por espaços, sublinhados, hifens ou barras, ou pelas letras maiúsculas de nomes em camelCase e PascalCase. Cada linha é convertida separadamente, então uma lista de chaves continua sendo uma lista.
| Entrada | Resultado |
|---|---|
| Database Connection Url | database.connection.url |
| homePageTitle | home.page.title |
| error_message_required | error.message.required |
| checkout-button-label | checkout.button.label |
Como nos outros formatos de código, os acentos são mantidos. Se as suas chaves estão em português, escreva sem acento (“titulo pagina inicial” vira titulo.pagina.inicial).
Onde o dot.case é usado
- Arquivos de configuração. Arquivos
.propertiesdo Java e configurações do Spring Boot usam chaves comospring.datasource.urleserver.port. - Arquivos de tradução. Chaves como
checkout.button.labelagrupam os textos por tela e por elemento, o que mantém organizados os arquivos de tradução grandes. - Nomes de pacotes. Pacotes Java e Kotlin são palavras em minúsculas unidas por pontos:
com.example.shop. - Logs e métricas. Nomes de loggers e de métricas costumam seguir o padrão
service.component.event. - Feature flags e eventos de analytics. Nomes como
billing.invoice.sentsão fáceis de filtrar pelo prefixo.
Por que as equipes escolhem chaves com pontos
Chaves com pontos ficam bem ordenadas. Todas as chaves que começam com checkout. aparecem juntas em uma lista em ordem alfabética, então configurações e textos relacionados ficam lado a lado. Muitas ferramentas também entendem os pontos e conseguem mostrar as chaves como uma árvore.
Pontos de atenção
- A ordem importa. Vá do geral para o específico:
email.subject.welcome, e nãowelcome.subject.email. - Partes com duas palavras precisam de outro estilo. Se um nível tem duas palavras, combine estilos:
checkout.shipping-address.labeloucheckout.shippingAddress.label. O conversor coloca um ponto entre todas as palavras, então junte essas partes à mão. - Não serve para identificadores no código. No código, use camelCase ou snake_case.