custom_form_w 2.0.3

Custom Form Widget With Validation Button and more features

CustomFormW

A flexible and customizable form widget for Flutter that allows for dynamic form creation with validation, custom labels, styling, and more.

Screenshots

[CustomFormW Example] [CustomFormW Example] [CustomFormW Example] [CustomFormW Example] [CustomFormW Example]

Features

• Create dynamic forms with customizable text fields
• Add informational or instructional text before each field
• Allow users to add their own custom text above fields
• Highlight required fields with visual indicators
• Customize field labels, hints, and styles
• Support multiple input types (text, email, password, phone, number)
• Built-in validation for required fields, emails, passwords, and phone numbers
• Configurable submit button with custom text, color, and action
• Customizable border styles and form layout
• Optional submit button visibility
• Optional validation snackbar
• Password confirmation validation
• RTL language support

Parameters

Main Form Parameters

• children (Required): List of CustomTextField widgets
• formKey (Optional): A GlobalKey
• buttonText (Optional): Text for the submit button (default: 'Submit')
• buttonColor (Optional): Color for the submit button (default: Colors.blue)
• buttonTextStyle (Optional): Style for the submit button text (default: TextStyle(color: Colors.white))
• onSubmit (Optional): Callback function for form submission
• showButton (Optional): Whether to show the submit button (default: true)
• spacing (Optional): Spacing between fields (default: 10.0)
• validationSnackBarText (Optional): Text for the validation snackbar (default: 'Form is valid')
• showValidationSnackBar (Optional): Whether to show the validation snackbar (default: true)
• padding (Optional): Padding for the form (default: EdgeInsets.symmetric(horizontal: 16))

CustomTextField Parameters

• label (Required): Label text for the field
• hint (Optional): Hint text for the field
• controller (Optional): TextEditingController for managing text input
• isRequired (Optional): Whether the field is required (default: false)
• type (Optional): Type of field (text, email, password, phone, number) (default: CustomTextFieldType.text)
• withoutBorder (Optional): Whether to show a border around the field (default: false)
• textDirection (Optional): Text direction for the field (default: TextDirection.ltr)
• fillColor (Optional): Background color for the field (default: Colors.white)
• prefixIcon (Optional): Icon to show at the start of the field
• suffixIcon (Optional): Icon to show at the end of the field
• labelStyle (Optional): Style for the label text
• requiredColor (Optional): Color for required field indicator (default: Colors.red)
• labelColor (Optional): Color for label text (default: Colors.black)
• radius (Optional): Border radius for the field (default: 10.0)
• enabledBorderColor (Optional): Color for the field border when enabled
• focusedBorderColor (Optional): Color for the field border when focused
• hintStyle (Optional): Style for the hint text
• phoneRegex (Optional): Regex for phone number validation (default: r'^\d{10}$')
• phoneRegexError (Optional): Error message for phone number validation
• passwordLength (Optional): Minimum length for password validation (default: 8)
• isConfirmPassword (Optional): Whether this field is for password confirmation (default: false)
• headerText (Optional): Text to display above the field
• headerTextStyle (Optional): Style for the headerText
• crossAxisOfHeaderText (Optional): Space between headerText and TextField

Installation

Add this to your pubspec.yaml file:

dependencies:
  custom_form_w: ^2.0.3

Then run

flutter pub get