Zippy Form

Zippy Form is a dynamic, customizable form solution. It provides flexibility to create multi-step forms with various field types, navigation buttons, validation, and customization options for a seamless user experience across different platforms.

Features

• Multi-step form navigation
• Extensive form field support, including:
  • Text fields
  • Number fields
  • Dropdowns
  • Email, phone, and website inputs
  • Radio buttons, checkboxes, and file uploads
  • Date and time pickers
• Customizable buttons and form appearance
• Error handling and validation support
• Advanced dropdowns with customizable options

Installation

Add the following to your pubspec.yaml:

dependencies:
  zippy: ^0.0.1

Or run

flutter pub add zippy

Then, run flutter pub get to install the package.

Usage

To use the ZippyForm widget in your Flutter application, follow these steps:

1. Import the necessary files

import 'package:zippy/zippy.dart';

2. Use the ZippyForm widget

ZippyForm(
  formId: 'your-form-id',
  onSubmitted: (context) {
    // Handle form submission
  },
  errorWidget: (message, context) {
    // Handle error display
  },
)

3. Customize the form

You can customize various aspects of the form, such as button text, debug mode, platform styles, and more. Below is an example with additional customization:

ZippyForm(
  formId: 'your-form-id',
  submissionId: 'submission-id',
  hiddenFields: {'field1': 'value1', 'field2': 'value2'},
  nextButtonText: 'Continue',
  previousButtonText: 'Go Back',
  submitButtonText: 'Finish',
  platformStyle: PlatformStyle.cupertino,
  buttonPosition: ButtonPosition.bottom,
  dropdownMode: DropdownMode.searchable,
  debugMode: true,
  onDropdownChange: (selectedItems) {
    // Handle dropdown change
  },
  onAdvancedDropdownChange: (selectedItems) {
    // Handle advanced dropdown change
  },
  onSubmitted: (context) {
    // Handle form submission
  },
  errorWidget: (message, context) {
    // Handle errors
  },
)

ZippyForm Parameters

Example

Here is a full example of a ZippyForm with multiple fields and customization:

import 'package:flutter/material.dart';
import 'package:zippy/zippy.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Zippy Form Example'),
        ),
        body: ZippyForm(
          formId: '12345',
          onSubmitted: (context) {
            // Form submission logic
          },
          errorWidget: (message, context) {
            // Error handling logic
          },
          nextButtonText: 'Next Step',
          submitButtonText: 'Submit Form',
          buttonPosition: ButtonPosition.bottom,
          platformStyle: PlatformStyle.material,
        ),
      ),
    );
  }
}

Contributions

Feel free to contribute by submitting a pull request, opening an issue, or giving feedback!

License

This package is licensed under the MIT License.