118 lines
3.9 KiB
Markdown
118 lines
3.9 KiB
Markdown
# Changelog
|
|
|
|
## [0.4.3]
|
|
|
|
- [Issue #19](https://github.com/dioxus-community/dioxus-i18n/issues/19) Enable use of "message-id.attribute-id"
|
|
syntax in the `t!`, `te!`, `tid!` macros in order to extract attribute definition, e.g. `t!("mycomponent.placeholder")`
|
|
in:
|
|
```
|
|
mycomponent = Component Name
|
|
.placeholder = Some placeholder
|
|
.aria-text = Some aria text
|
|
```
|
|
|
|
- Added examples for all fluent grammar constructs and configuration variants.
|
|
|
|
## [0.4.2] 2025-02-08
|
|
|
|
### Fixed
|
|
|
|
- [Issue #15](https://github.com/dioxus-community/dioxus-i18n/issues/15) Recent change to t! macro unnecessarily breaks v0.3 code.
|
|
|
|
### Amended
|
|
|
|
- t! macro amended to use unwrap_or_else rather than panic!.
|
|
|
|
- Error messages made consistant across all macros.
|
|
|
|
## [0.4.1] 2025-02-02
|
|
|
|
### Added
|
|
|
|
- New methods (`I18nConfig::with_auto_locales`) to determine supported locales from deep search for translation files.
|
|
|
|
- New methods returning `Result<_, Error>` rather than `panic!`, such that:
|
|
| __`panic!` version__ | __`Result<_, Error>` vesion__ |
|
|
|-----------------------------------------|------------------------------------------|
|
|
| `LocaleResource::to_resource_string` | `LocaleResource::try_to_resource_string` |
|
|
| `I18n::translate` | `I18n::try_translate` |
|
|
| `I18n::translate_with_args` | `I18n::try_translate_with_args` |
|
|
| `I18n::set_fallback_language` | `I18n::try_set_fallback_language` |
|
|
| `I18n::set_language` | `I18n::try_set_language` |
|
|
| `use_init_i18n` | `try_use_init_i18n` |
|
|
| `I18nConfig::with_auto_locales` | `I18nConfig::try_with_auto_locales` |
|
|
|
|
- New `te!` macro which acts like `t!` but returns `Error`.
|
|
|
|
- New `tid!` macro which acts like `t!` but returns the message-id.
|
|
|
|
### Change
|
|
|
|
- t! macro amended to use `try_translate` and `try_translate_with_args`, but will perform `.expect("..")`
|
|
and therefore panic! on error. This retains backwards compatibility for this macro.
|
|
|
|
- Use of `set_fallback_language` / `try_set_fallback_language` without a corresponding locale
|
|
translation is treated as an error.
|
|
|
|
## [0.4.0] 2025-01-25
|
|
|
|
### Added
|
|
|
|
- Code:
|
|
- Doc comments
|
|
- Module tests for `cargo test`
|
|
|
|
- Amended `I18nConfig::with_locale` so that the `Locale` dynamic or static
|
|
constructors no longer have to be _explicitly_ given.
|
|
They can be determined implicitly from `(LanguageIdentifier, &str)` or
|
|
`(LanguageIdentifer, PathBuf)`.
|
|
|
|
- Enabled shared 'LocaleResource's, where two dialect can use the same translation file.
|
|
For example ["en", "en-GB"] share "en-GB.ftl".
|
|
|
|
### Changed
|
|
|
|
- The translations used are determined when `I18n::set_language` or
|
|
`I18n::set_fallback_language` is called, and not each time a message is translated.
|
|
|
|
- __Fallback handling has changed__. It no longer just uses _fallback_language_ when the message
|
|
id is missing from the current _locale_. It performs a graceful fallback from
|
|
_<language>-<region>_ to _<language>_ before using the actual _fallback_ (in fact it
|
|
falls back along the _<language>-<optionalScript>-<optionalRegion>-<optionalVariants>_
|
|
hiearchy).
|
|
|
|
__Note:__ this is a breaking change which may impact the selected translation.
|
|
|
|
- `LocaleResource::to_string` renamed to `LocaleResource::to_resource_string`
|
|
|
|
## [0.3.0] 2024-12-10
|
|
|
|
- [Dioxus 0.6](https://dioxuslabs.com/) support
|
|
|
|
## [0.2.4] 2024-09-11
|
|
|
|
- Hide new_dynamic in WASM
|
|
- New t!() macro
|
|
|
|
## [0.2.3] 2024-09-04
|
|
|
|
- Support dynamic loading of locales
|
|
|
|
## [0.2.2] 2024-09-02
|
|
|
|
- Enable macros instead of serde in unic-langid
|
|
|
|
## [0.2.1] 2024-09-02
|
|
|
|
- Export unic_langid and fluent
|
|
- Use absolute path to import fluent in the translate macro
|
|
- Updated freya example
|
|
|
|
## [0.2.0] 2024-09-01
|
|
|
|
- Now based in the [Fluent Project](https://github.com/projectfluent/fluent-rs)
|
|
|
|
## [0.1.0] 2024-08-31
|
|
|
|
- Initial release
|