💡 Input Yew

🎬 Demo

Input Type	Demo
Text
Password
Textarea
Telephone

📜 Prologue

This custom reusable input functional component is a solution built exclusively for the Rust Yew framework. Seamlessly integrating into your Yew applications, it combines powerful functionality with comprehensive accessibility features. With a focus on reusability and customizability, this component empowers you to effortlessly create dynamic input fields that adapt to various forms of user input.

🤔 Why is this Component Useful?

The Yew Custom Reusable Input Component is a powerful tool designed to make your life as a Yew developer easier and more enjoyable. Let's explore some of the reasons why this component is an essential addition to your web development arsenal:

1. 🔄 Reusability: No repetitive code! This component is built to be highly reusable, allowing you to sprinkle it across your application without any fuss.

2. 🎨 Customizability: You can now fine-tune the appearance and behavior of the input component to fit your specific needs and aesthetics.

3. ✔️ Validations: You can easily add your custom validation functions.

4. 🎫 Event Handling: The component exposes the oninput event handler, making it super easy to implement dynamic behavior based on your interactions.

5. ♿ Accessibility: This component was designed with accessibility in mind, ensuring that it's user-friendly and perceivable by all, regardless of ability.

6. ❌ Error Handling: When users provide invalid input, the component gracefully displays clear error messages, guiding them towards valid data entry and enhancing the overall user experience.

⚙️ Installation

You can quickly integrate the Yew Custom Reusable Input Component into your Yew project by following these simple steps:

1. First, make sure you have Yew set up in your project. If not, check out the Yew documentation for installation instructions.

2. Then, install the input component package using your preferred package manager:

   $ cargo add input_yew

3. Finally, import the component into your Yew application and start using it to power up your forms and user interactions.

🛠️ Usage

Using this custom reusable input component is a breeze! Simply follow these steps:

1. Import the component into your Yew application:

   // Add these lines at the beginning of your file, make sure you have `regex` installed for input validation. 
   use yew::prelude::*;
   use regex::Regex;
   use input_yew::CustomInput;

2. Use the CustomInput component wherever you need an input field:

   fn validate_email(email: String) -> bool {
      let pattern = Regex::new(r"^[^ ]+@[^ ]+\.[a-z]{2,3}$").unwrap();
      pattern.is_match(&email)
   }
   
   #[function_component(LoginForm)]
   pub fn login_form() -> Html {
      let input_email_ref = use_node_ref();
      let input_email_handle = use_state(String::default);
      let email_valid_handle = use_state(|| true);
      let onsubmit = Callback::from(move |event: SubmitEvent| {};
      html! {
            <form action="#" aria-label="Sign In Form" onsubmit={onsubmit}>
                <CustomInput
                  input_type={"text"}
                  input_handle={input_email_handle}
                  name={"email"}
                  input_ref={input_email_ref}
                  input_placeholder={"Email"}
                  icon_class={"fas fa-user"}
                  icon={"fas fa-user"}
                  error_message={"Enter a valid email address"}
                  form_input_field_class={"form-one-field"}
                  form_input_error_class={"error-txt"}
                  required={true}
                  input_valid_handle={email_valid_handle}
                  validate_function={validate_email}
                />
            </form>
      }
   }

3. Customize the input component's appearance and behavior according to your project requirements.

🔧 Props

Input Properties

Styling Properties

State and Callback Properties

Icon Properties

Accessibility and SEO Properties

📙 Examples

Lots of examples we built use it to create even more sophisticated forms like Contact Us forms, multi-step forms, and login forms. If you're curious about how to use it, you can check out the examples folder for more information.

🤝 Contribution

We welcome contributions from the community to make this input component even better! Feel free to open issues, submit pull requests, or provide feedback. Let's collaborate and create something amazing together!

📜 License

This Yew component is licensed under the Apache-2.0 License, giving you the freedom to use, modify, and distribute it as you see fit. Please check the LICENSE file for more details.

📝 Conclusion

Congratulations! You're now equipped with a Custom Reusable Input Component that will supercharge your Yew applications with its flexibility, user-friendliness, and robustness. Happy coding, and may your projects thrive with this powerful tool! 🎉