#yew-web #yew-component #web-apps #yew #web-framework #rust

yew-i18n

🌐 Internationalization (i18n) component for the Yew framework

3 releases

0.1.2 Feb 3, 2024
0.1.1 Jan 25, 2024
0.1.0 Jan 24, 2024

#73 in Internationalization (i18n)

Download history 15/week @ 2024-07-04 30/week @ 2024-07-11 54/week @ 2024-07-18 14/week @ 2024-07-25 27/week @ 2024-08-01 19/week @ 2024-08-08 3/week @ 2024-08-15 2/week @ 2024-08-22 25/week @ 2024-08-29 52/week @ 2024-09-05 88/week @ 2024-09-12 181/week @ 2024-09-19 416/week @ 2024-09-26 124/week @ 2024-10-03 37/week @ 2024-10-10 144/week @ 2024-10-17

765 downloads per month
Used in next-rs

MIT license

17KB
88 lines

🌐 Yew I18n

Crates.io Crates.io Downloads Crates.io License Rust Netlify Status


Demo


πŸ“œ Introduction

Yew I18n is a Yew component that provides internationalization (i18n) support for your web applications. It allows you to manage translations and switch between different languages seamlessly, enhancing the user experience for a global audience.

πŸ€” Why is this Component Useful?

This library offers several benefits to make i18n implementation in your Yew projects straightforward:

  1. 🌍 Multi-Language Support: Easily manage translations for various languages in your application.

  2. πŸš€ Seamless Integration: Integrate i18n seamlessly into your Yew components, providing a consistent language experience.

  3. πŸ’¬ Dynamic Language Switching: Dynamically switch between supported languages to cater to diverse user preferences.

βš™οΈ Installation

Integrating Yew I18n into your Yew project is a simple process. Follow these steps:

  1. Make sure you have Yew set up in your project. If not, refer to the Yew documentation for installation instructions.

  2. Install the library using your preferred package manager:

    $ cargo add yew-i18n
    
  3. Start using the library to manage translations and enhance the multilingual capabilities of your application.

πŸ› οΈ Usage

Incorporating Yew I18n into your application is easy. Follow these steps:

  1. Set up the i18n configuration and provider:

    use crate::components::my_component::MyComponent;
    use yew_i18n::I18nProvider;
    use std::collections::HashMap;
    use yew::prelude::*;
    
    #[function_component(App)]
    pub fn app() -> Html {
        let supported_languages = vec!["en", "fr"];
        let mut translations = HashMap::new();
    
        translations.insert(
        	   // en to en
            "en".to_string(),
            serde_json::json!({
                "24 Apr, 2023": "24 Apr, 2023",
                "02 May, 2023": "02 May, 2023",
                "11 May, 2023": "11 May, 2023",
                "Trending Posts": "Trending Posts",
                "Rust: The Next Big Thing in Data Science": "Rust: The Next Big Thing in Data Science",
                "Data Science": "Data Science",
            }),
        );
    
        translations.insert(
        	   // en to fr
            "fr".to_string(),
            serde_json::json!({
                "24 Apr, 2023": "24 Avr, 2023",
                "02 May, 2023": "02 Mai, 2023",
                "11 May, 2023": "11 Mai, 2023",
                "Trending Posts": "Articles Tendances",
                "Rust: The Next Big Thing in Data Science": "Rust : La Prochaine Grande AvancΓ©e en Science des DonnΓ©es",
                "Data Science": "Science des DonnΓ©es",
            }),
        );
    
        html! {
         	<I18nProvider supported_languages={supported_languages} translations={translations} >
         	    <MyComponent />
         	</I18nProvider>
        }
    }
    
  2. Use the use_translation hook to access the i18n context in your components:

    // ./src/components/my_component.rs
    use yew::prelude::*;
    use yew_i18n::use_translation;
    
    #[function_component(MyComponent)]
    pub fn my_component() -> Html {
        let i18n = use_translation();
    
        i18n.set_translation_language(&"fr");
    
        // Your component, states, etc.
    
        html! {
        	   <div>
                { i18n.t("Trending Posts") }
        	   </div>
        }
    }
    
  3. Customize the language and translations based on user preferences.

πŸ”§ Props

Name Type Description Example Default Value
supported_languages Vec<&'static str> List of supported languages in your application. vec!["en", "fr", "de"] vec!["en"]
translations HashMap<String, serde_json::Value> Translations for different languages. Refer to the usage examples for translations An empty HashMap

πŸ“™ Examples

If you're curious about how to use it with tailwind css, you can check out the examples folder for more information.

🀝 Contribution

We welcome contributions from the community to enhance this Yew I18n component. Feel free to open issues, submit pull requests, or provide feedback. Let's collaborate to make multilingual support in Yew even more powerful!

πŸ“œ License

Yew I18n is licensed under the MIT License, allowing you to use, modify, and distribute it freely. Refer to the LICENSE file for more details.

Dependencies

~11–20MB
~274K SLoC