Ce qu’est le dot.case
Ce convertisseur dot.case place un point entre les mots et garde toutes les lettres en minuscules :
Database Connection Urldevientdatabase.connection.urlhomePageTitledevienthome.page.titleerror_message_requireddevienterror.message.required
Les points expriment en général une hiérarchie. Dans app.server.port, « port » appartient à « server », qui appartient à « app ».
Comment fonctionne le convertisseur
L’outil repère les mots de chaque ligne, les met en minuscules et les relie par des points. Les mots peuvent être séparés par des espaces, des tirets bas, des traits d’union ou des barres obliques, ou par les majuscules des noms en camelCase et PascalCase. Chaque ligne est convertie séparément, donc une liste de clés reste une liste.
| Texte saisi | Résultat |
|---|---|
| Database Connection Url | database.connection.url |
| homePageTitle | home.page.title |
| error_message_required | error.message.required |
| checkout-button-label | checkout.button.label |
Avec des mots français, « nombre de commandes » donne nombre.de.commandes. Les accents restent en place, ce qui ne gêne pas dans une valeur de traduction mais peut poser problème dans une clé : la plupart des équipes écrivent leurs clés en anglais ou sans accents.
Où l’on utilise le dot.case
- Fichiers de configuration. Les fichiers
.propertiesJava et les réglages Spring Boot utilisent des clés commespring.datasource.urletserver.port. - Fichiers de traduction. Des clés comme
checkout.button.labelregroupent les textes par écran et par élément, ce qui garde les gros fichiers de traduction organisés. - Noms de packages. Les packages Java et Kotlin sont des mots en minuscules reliés par des points :
com.example.shop. - Journaux et métriques. Les noms de loggers et de métriques suivent souvent le modèle
service.component.event. - Feature flags et événements analytics. Des noms comme
billing.invoice.sentse filtrent facilement par préfixe.
Pourquoi les équipes choisissent des clés à points
Les clés à points se trient bien. Toutes les clés qui commencent par checkout. apparaissent ensemble dans une liste alphabétique, donc les réglages et textes liés restent côte à côte. Beaucoup d’outils comprennent aussi les points et peuvent afficher les clés sous forme d’arbre.
Points de vigilance
- L’ordre compte. Allez du général au particulier :
email.subject.welcome, paswelcome.subject.email. - Les niveaux de plusieurs mots demandent un autre style. Si un niveau contient deux mots, combinez les styles :
checkout.shipping-address.labeloucheckout.shippingAddress.label. Le convertisseur met un point entre chaque mot, donc reliez ces parties à la main. - Pas pour les identifiants de code. Dans le code, utilisez le camelCase ou le snake_case.