💡 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".to_string()}
                   input_handle={input_email_handle}
                   name={"email".to_string()}
                   input_ref={input_email_ref}
                   input_placeholder={"Email".to_string()}
                   icon_class={"fas fa-user".to_string()}
                   icon={"fas fa-user".to_string()}
                   error_message={"Enter a valid email address".to_string()}
                   form_input_field_class={"form-one-field".to_string()}
                   form_input_error_class={"error-txt".to_string()}
                   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

Name	Type	Description	Example	Default Value
input_type	AttrValue	The type of the input.	"text", "password", "tel, "textarea", "date".	AttrValue::from("text")
label	AttrValue	The label to be displayed for the input field.	"Username", "Email".	AttrValue::default()
name	AttrValue	The name of the input field, used for form submission and accessibility.	"username", "email".	AttrValue::default()
required	Option	Indicates whether the input is required or not.	true, false.	None
input_ref	NodeRef	A reference to the DOM node of the input element.	use_node_ref(),	-
error_message	AttrValue	The error message to display when there is a validation error.	"Invalid input", "Field is required".	AttrValue::default()
form_input_class	AttrValue	The CSS class to be applied to all inner elements.	"form-input-container", "input-group".	AttrValue::default()
form_input_field_class	AttrValue	The CSS class to be applied to the inner input element and icon.	"form-input-field", "input-icon".	AttrValue::default()
form_input_label_class	AttrValue	The CSS class to be applied to the label for the input element.	"form-input-label".	AttrValue::default()
form_input_input_class	AttrValue	The CSS class to be applied to the input element.	"custom-input".	AttrValue::default()
form_input_error_class	AttrValue	The CSS class to be applied to the error div element.	"input-error-message".	AttrValue::default()
icon_class	AttrValue	The CSS class to be applied to the start icon element.	"input-icon".	AttrValue::default()
input_handle	UseStateHandle	The state handle for managing the value of the input.	use_state("initial value".into()).handle(),	-
input_valid_handle	UseStateHandle	The state handle for managing the validity state of the input.	use_state(true).handle(),	-
validate_function	Callback<String, bool>	A callback function to validate the input value. It takes a String as input and returns a bool.	Callback::from(	value: String
eye_active	AttrValue	The icon when the password is visible.	"fa fa-eye" in case of using FontAwesome.	AttrValue::from("fa fa-eye")
eye_disabled	AttrValue	The icon when the password is not visible.	"fa fa-eye-slash" in case of using FontAwesome.	AttrValue::from("fa fa-eye-slash")
input_id	AttrValue	The ID attribute of the input element.	"input-username", "input-email".	AttrValue::default()
input_placeholder	AttrValue	The placeholder text to be displayed in the input element.	"Enter your username", "Type your email".	AttrValue::default()
aria_label	AttrValue	The aria-label attribute for screen readers, providing a label for accessibility.	"Username input", "Email input".	AttrValue::default()
aria_required	AttrValue	The aria-required attribute for screen readers, indicating whether the input is required.	"true", "false".	AttrValue::from("true")
aria_invalid	AttrValue	The aria-invalid attribute for screen readers, indicating whether the input value is invalid.	"true", "false".	AttrValue::from("true")
aria_describedby	AttrValue	The aria-describedby attribute for screen readers, describing the input element's error message.	"error-message-username", "error-message-email".	AttrValue::default()

📙 Examples

Lots of repositories 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 following repositories for more information:

• Yew Tailwind Components.
• Yew Pure CSS Components.

🤝 Contribution

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

📜 License

The Yew Custom Reusable Input 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.

📝 Epilogue

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