Qué es dot.case
dot.case pone un punto entre las palabras y deja todas las letras en minúscula:
Database Connection Urlpasa adatabase.connection.urlhomePageTitlepasa ahome.page.titleerror_message_requiredpasa aerror.message.required
Los puntos suelen expresar una jerarquía. En app.server.port, “port” pertenece a “server”, que a su vez pertenece a “app”.
Cómo funciona el convertidor
La herramienta encuentra las palabras de cada línea, las pasa a minúscula y las une con puntos. Las palabras pueden estar separadas por espacios, guiones bajos, guiones o barras, o por las mayúsculas de los nombres en camelCase y PascalCase. Cada línea se convierte por separado, así que una lista de claves sigue siendo una lista.
| Texto | Resultado |
|---|---|
| Database Connection Url | database.connection.url |
| homePageTitle | home.page.title |
| error_message_required | error.message.required |
| checkout-button-label | checkout.button.label |
Las tildes y la ñ se mantienen: “Url De Conexión” pasa a url.de.conexión. En claves de configuración es más seguro usar solo letras ASCII, así que escribe “conexion” sin tilde o quita las tildes antes con el generador de slugs.
Dónde se usa dot.case
- Archivos de configuración. Los archivos
.propertiesde Java y los ajustes de Spring Boot usan claves comospring.datasource.urlyserver.port. - Archivos de traducción. Claves como
checkout.button.labelagrupan los textos por pantalla y elemento, lo que mantiene ordenados los archivos de traducción grandes. - Nombres de paquetes. Los paquetes de Java y Kotlin son palabras en minúscula unidas por puntos:
com.example.shop. - Registros y métricas. Los nombres de loggers y de métricas suelen seguir el patrón
service.component.event. - Feature flags y eventos de analítica. Nombres como
billing.invoice.sentson fáciles de filtrar por prefijo.
Por qué los equipos eligen claves con puntos
Las claves con puntos se ordenan bien. Todas las que empiezan por checkout. aparecen juntas en una lista alfabética, así que los ajustes y textos relacionados quedan uno al lado del otro. Muchas herramientas también entienden los puntos y pueden mostrar las claves como un árbol.
Qué tener en cuenta
- El orden importa. Ve de lo general a lo concreto:
email.subject.welcome, nowelcome.subject.email. - Las partes de varias palabras necesitan otro estilo. Si un nivel tiene dos palabras, combina estilos:
checkout.shipping-address.labelocheckout.shippingAddress.label. El convertidor pone un punto entre todas las palabras, así que une esas partes a mano. - No sirve para identificadores de código. En el código, usa camelCase o snake_case.