PHPackages                             avalynx/avalynx-form - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Validation &amp; Sanitization](/categories/validation)
4. /
5. avalynx/avalynx-form

ActiveLibrary[Validation &amp; Sanitization](/categories/validation)

avalynx/avalynx-form
====================

AvalynxForm is a lightweight, customizable form handling library for web applications. Based on Bootstrap &gt;=5.3 without any framework dependencies.

1.0.5(2mo ago)31211MITJavaScriptCI passing

Since Jun 9Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/avalynx/avalynx-form)[ Packagist](https://packagist.org/packages/avalynx/avalynx-form)[ Docs](https://github.com/avalynx/avalynx-form)[ RSS](/packages/avalynx-avalynx-form/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (8)Dependencies (2)Versions (9)Used By (1)

AvalynxForm
===========

[](#avalynxform)

[![npm version](https://camo.githubusercontent.com/36dbb74e5165602f856a4267cc35f745017049d246c2d927e9aec184d55fce8a/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f762f6176616c796e782d666f726d)](https://www.npmjs.com/package/avalynx-form)[![npm downloads](https://camo.githubusercontent.com/d4785275a9cb8930e7085cf77e03c50569ba4c73c6df197a49b2928534bfa2be/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f64742f6176616c796e782d666f726d)](https://www.npmjs.com/package/avalynx-form)[![jsDelivr](https://camo.githubusercontent.com/a144a62b5291a85585bad203379b99c3dba0d75d8e583b86baa5b07ca0b13e6a/68747470733a2f2f696d672e736869656c64732e696f2f6a7364656c6976722f6e706d2f686d2f6176616c796e782d666f726d)](https://www.jsdelivr.com/package/npm/avalynx-form)[![License](https://camo.githubusercontent.com/cf269d8299a5705f766c486cecc53702252a454341781282be7a6b817b5ca05c/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f6c2f6176616c796e782d666f726d)](LICENSE)[![Tests](https://github.com/avalynx/avalynx-form/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/avalynx/avalynx-form/actions/workflows/tests.yml)[![codecov](https://camo.githubusercontent.com/588ebe245f1f523eeefec94539360c250bdceebb25986460084786c185a1a898/68747470733a2f2f636f6465636f762e696f2f67682f6176616c796e782f6176616c796e782d666f726d2f6272616e63682f6d61696e2f67726170682f62616467652e737667)](https://codecov.io/gh/avalynx/avalynx-form)[![GitHub stars](https://camo.githubusercontent.com/8908fd49a200f29698119809d5d7dc9ca2a12683320304f4e09aa7d3b851cbeb/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6176616c796e782f6176616c796e782d666f726d3f7374796c653d666c6174266c6f676f3d676974687562)](https://github.com/avalynx/avalynx-form)

AvalynxForm is a lightweight, customizable form handling library for web applications. Based on Bootstrap &gt;=5.3 without any framework dependencies.

Features
--------

[](#features)

- **Form Handling**: Simplifies the process of creating and managing forms in your web applications.
- **Bootstrap Integration**: Designed for seamless integration with Bootstrap &gt;= 5.3.
- **Easy to Use**: Simple API for creating and managing forms within your web applications.

Example
-------

[](#example)

Here's a simple example of how to use AvalynxForm in your project:

- [Overview](https://avalynx-form.jbs-newmedia.de/examples/index.html)
- [Form](https://avalynx-form.jbs-newmedia.de/examples/form.html)
- [Form with slow response](https://avalynx-form.jbs-newmedia.de/examples/form-slow-response.html)
- [Form with AvalynxSelect](https://avalynx-form.jbs-newmedia.de/examples/form-avalynx-select.html)
- [Form with AvalynxAutocomplete](https://avalynx-form.jbs-newmedia.de/examples/form-avalynx-autocomplete.html)

Installation
------------

[](#installation)

To use AvalynxForm in your project, you can directly include it in your HTML file. Ensure you have Bootstrap 5.3 or higher included in your project for AvalynxForm to work correctly.

First, include Bootstrap:

```

```

Then, include AvalynxForm:

```

```

Replace `path/to/avalynx-form.js` with the actual path to the file in your project.

Installation via jsDelivr ([Link](https://cdn.jsdelivr.net/npm/avalynx-form/))
------------------------------------------------------------------------------

[](#installation-via-jsdelivr-link)

AvalynxForm is also available via [jsDelivr](https://www.jsdelivr.com/). You can include it in your project like this:

```

```

Make sure to also include Bootstrap's JS/CSS in your project to ensure AvalynxForm displays correctly.

Installation via NPM ([Link](https://www.npmjs.com/package/avalynx-form))
-------------------------------------------------------------------------

[](#installation-via-npm-link)

AvalynxForm is also available as a npm package. You can add it to your project with the following command:

```
npm install avalynx-form
```

After installing, you can import AvalynxForm into your JavaScript file like this:

```
import { AvalynxForm } from 'avalynx-form';
```

Make sure to also include Bootstrap's JS/CSS in your project to ensure AvalynxForm displays correctly.

Installation via Symfony AssetMapper
------------------------------------

[](#installation-via-symfony-assetmapper)

```
php bin/console importmap:require avalynx-form
```

After installing, you can import AvalynxForm into your JavaScript file like this:

```
import { AvalynxForm } from 'avalynx-form';
```

Make sure to also include Bootstrap's JS/CSS in your project to ensure AvalynxForm displays correctly.

Installation via Symfony AssetComposer
--------------------------------------

[](#installation-via-symfony-assetcomposer)

More information about the Symfony AssetComposer Bundle can be found [here](https://github.com/jbsnewmedia/asset-composer-bundle).

```
{% do addAssetComposer('avalynx/avalynx-form/dist/js/avalynx-form.js') %}
```

Make sure to also include Bootstrap's JS/CSS in your project to ensure AvalynxForm displays correctly.

Installation via Composer ([Link](https://packagist.org/packages/avalynx/avalynx-form))
---------------------------------------------------------------------------------------

[](#installation-via-composer-link)

AvalynxForm is also available as a Composer package. You can add it to your project with the following command:

```
composer require avalynx/avalynx-form
```

After installing, you can import AvalynxForm into your HTML file like this:

```

```

Make sure to also include Bootstrap's JS/CSS in your project to ensure AvalynxForm displays correctly.

Usage
-----

[](#usage)

To use AvalynxForm in your project, include the AvalynxForm JavaScript file in your project and initialize the class with the appropriate selector.

```
new AvalynxForm("myForm", {
    apiParams: {
        extraData1: 'value1',
        extraData2: 'value2'
    },
    onSuccess: function(response) {
        console.log('Form submission was successful:', response);
    },
    onError: function(response) {
        console.error('Form submission failed:', response);
    }
});
```

Options
-------

[](#options)

AvalynxForm allows the following options for customization:

- `id`: (string) The ID of the element to attach the form to.
- `options`: An object containing the following keys:
    - `apiParams`: (object) Additional parameters to be sent with the form data (default: `{}`).
    - `loader`: (object) An instance of AvalynxLoader to use as the loader for the modal (default: `null`).
    - `onSuccess`: (function) A callback function to be executed when the form submission is successful (default: `null`).
    - `onError`: (function) A callback function to be executed when the form submission fails (default: `null`).
    - `onBeforeSubmit`: (function) A callback function to be executed before the form submission (default: `null`).
    - `onAfterSubmit`: (function) A callback function to be executed after the form submission (default: `null`).

Contributing
------------

[](#contributing)

Contributions are welcome! If you'd like to contribute, please fork the repository and submit a pull request with your changes or improvements. We're looking for contributions in the following areas:

- Bug fixes
- Feature enhancements
- Documentation improvements

Before submitting your pull request, please ensure your changes are well-documented and follow the existing coding style of the project.

License
-------

[](#license)

AvalynxForm is open-sourced software licensed under the [MIT license](LICENSE).

Contact
-------

[](#contact)

If you have any questions, feature requests, or issues, please open an issue on our [GitHub repository](https://github.com/avalynx/avalynx-form/issues) or submit a pull request.

Thank you for considering AvalynxForm for your project!

###  Health Score

41

—

FairBetter than 89% of packages

Maintenance86

Actively maintained with recent releases

Popularity16

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~89 days

Recently: every ~36 days

Total

8

Last Release

80d ago

Major Versions

0.0.2 → 1.0.02025-06-05

### Community

Maintainers

![](https://www.gravatar.com/avatar/44b85e5ce069ccae08123600bb24204ea8fe99c8cb5cbfae108ff29c179e503d?d=identicon)[jschwind](/maintainers/jschwind)

---

Top Contributors

[![jschwind](https://avatars.githubusercontent.com/u/985564?v=4)](https://github.com/jschwind "jschwind (28 commits)")

---

Tags

avalynxbootstrapbootstrap5componentforminputvalidationvalidationcomponentbootstrapforminputbootstrap5avalynx

### Embed Badge

![Health badge](/badges/avalynx-avalynx-form/health.svg)

```
[![Health](https://phpackages.com/badges/avalynx-avalynx-form/health.svg)](https://phpackages.com/packages/avalynx-avalynx-form)
```

###  Alternatives

[siriusphp/validation

Data validation library. Validate arrays, array objects, domain models etc using a simple API. Easily add your own validators on top of the already dozens built-in validation rules

181743.3k13](/packages/siriusphp-validation)[apy/jsfv-bundle

Symfony2 Javascript Form Validation Bundle with localisation support

92770.5k](/packages/apy-jsfv-bundle)[progsmile/request-validator

Simple PHP Request Validator

33113.3k1](/packages/progsmile-request-validator)[stroker/form

ZF2 module for extending forms with live clientside validation

4157.1k](/packages/stroker-form)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
