feat: document i18n translation system #736
Conversation
hyyan
requested review from
EHandtkeBasis,
MatthewHawkins,
bbrennanbasis,
gosteenBASIS and
laurenic0l
as code owners
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
| ``` | ||
| ### Configuring supported locales | ||
|
|
||
| The `supported-locales` setting tells webforJ which locales your app supports. This list is used by auto-detection to match the user's browser locale against available translations. The first locale in the list is used as the default fallback when no better match is found. The property key is `webforj.i18n.supported-locales` and accepts a list of [BCP 47](https://en.wikipedia.org/wiki/IETF_language_tag) language tags, for example `en, de`. |
There was a problem hiding this comment.
📝 [vale] reported by reviewdog 🐶
[Google.Acronyms] Spell out 'BCP', if it's unfamiliar to the audience.
| ``` | ||
|
|
||
| In the example above, the code applies the `EmailValidator` to an email field with a custom error message specifically tailored for that field. This allows for a more directed and helpful user experience if the validation fails. | ||
| In the example above, the code applies the `EmailValidator` to an email field with a custom error message specifically tailored for that field. |
There was a problem hiding this comment.
[Google.WordList] Use 'preceding' instead of 'above'.
|
|
||
| // When the locale changes, Jakarta validators automatically | ||
| // produce messages in the new locale | ||
| context.setLocale(Locale.GERMAN); |
There was a problem hiding this comment.
Which locale is used initially if this setlocale isnt done? Might make sense to point to default behavior as a note.
There was a problem hiding this comment.
it is the default JVM locale,I mentioned that in docs/docs/advanced/locale-management.md:
The app locale can be configured using the webforj.locale property. This sets the locale that the app uses from startup, affecting all locale-sensitive formatting and text. When webforj.locale isn't configured, the app falls back to the server's JVM default locale. You can read the current locale at any time with App.getLocale().
2 participants
closes #734