{"id":15572972,"url":"https://github.com/avalynx/avalynx-form","last_synced_at":"2025-05-15T08:33:58.756Z","repository":{"id":243493104,"uuid":"806729520","full_name":"avalynx/avalynx-form","owner":"avalynx","description":"AvalynxForm is a lightweight, customizable form handling library for web applications. Based on Bootstrap \u003e=5.3 without any framework dependencies.","archived":false,"fork":false,"pushed_at":"2025-03-07T22:01:48.000Z","size":71,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-09T13:05:41.722Z","etag":null,"topics":["avalynx","bootstrap","bootstrap5","component","form","input","validation"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/avalynx.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-27T19:24:05.000Z","updated_at":"2025-03-07T22:00:49.000Z","dependencies_parsed_at":"2024-06-09T11:41:28.642Z","dependency_job_id":null,"html_url":"https://github.com/avalynx/avalynx-form","commit_stats":null,"previous_names":["avalynx/avalynx-form"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avalynx%2Favalynx-form","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avalynx%2Favalynx-form/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avalynx%2Favalynx-form/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avalynx%2Favalynx-form/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/avalynx","download_url":"https://codeload.github.com/avalynx/avalynx-form/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254304837,"owners_count":22048480,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["avalynx","bootstrap","bootstrap5","component","form","input","validation"],"created_at":"2024-10-02T18:09:08.243Z","updated_at":"2025-05-15T08:33:58.736Z","avatar_url":"https://github.com/avalynx.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AvalynxForm\n\nAvalynxForm is a lightweight, customizable form handling library for web applications. Based on Bootstrap \u003e=5.3 without any framework dependencies.\n\n## Features\n\n- **Form Handling**: Simplifies the process of creating and managing forms in your web applications.\n- **Bootstrap Integration**: Designed for seamless integration with Bootstrap \u003e= 5.3.\n- **Easy to Use**: Simple API for creating and managing forms within your web applications.\n\n## Example\n\nHere's a simple example of how to use AvalynxForm in your project:\n\n* [Overview](https://avalynx-form.jbs-newmedia.de/examples/index.html)\n* [Form](https://avalynx-form.jbs-newmedia.de/examples/form.html)\n* [Form with slow response](https://avalynx-form.jbs-newmedia.de/examples/form-slow-response.html)\n\n## Installation\n\nTo 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.\n\nFirst, include Bootstrap:\n\n```html\n\u003c!-- Bootstrap --\u003e\n\u003clink href=\"https://cdn.jsdelivr.net/npm/bootstrap@5.3/dist/css/bootstrap.min.css\" rel=\"stylesheet\"\u003e\n\u003cscript src=\"https://cdn.jsdelivr.net/npm/bootstrap@5.3/dist/js/bootstrap.bundle.min.js\"\u003e\u003c/script\u003e\n```\n\nThen, include AvalynxForm:\n\n```html\n\u003cscript src=\"path/to/avalynx-form.js\"\u003e\u003c/script\u003e\n```\n\nReplace `path/to/avalynx-form.js` with the actual path to the file in your project.\n\n## Installation via jsDelivr ([Link](https://cdn.jsdelivr.net/npm/avalynx-form/))\n\nAvalynxForm is also available via [jsDelivr](https://www.jsdelivr.com/). You can include it in your project like this:\n\n```html\n\u003cscript src=\"https://cdn.jsdelivr.net/npm/avalynx-form@0.0.2/dist/js/avalynx-form.js\"\u003e\u003c/script\u003e\n```\n\nMake sure to also include Bootstrap's JS/CSS in your project to ensure AvalynxForm displays correctly.\n\n## Installation via NPM ([Link](https://www.npmjs.com/package/avalynx-form))\n\nAvalynxForm is also available as a npm package. You can add it to your project with the following command:\n\n```bash\nnpm install avalynx-form\n```\n\nAfter installing, you can import AvalynxForm into your JavaScript file like this:\n\n```javascript\nimport { AvalynxForm } from 'avalynx-form';\n```\n\nMake sure to also include Bootstrap's JS/CSS in your project to ensure AvalynxForm displays correctly.\n\n## Installation via Symfony AssetMapper\n\n```bash\nphp bin/console importmap:require avalynx-form\n```\n\nAfter installing, you can import AvalynxForm into your JavaScript file like this:\n\n```javascript\nimport { AvalynxForm } from 'avalynx-form';\n```\n\nMake sure to also include Bootstrap's JS/CSS in your project to ensure AvalynxForm displays correctly.\n\n## Installation via Composer ([Link](https://packagist.org/packages/avalynx/avalynx-form))\n\nAvalynxForm is also available as a Composer package. You can add it to your project with the following command:\n\n```bash\ncomposer require avalynx/avalynx-form\n```\n\nAfter installing, you can import AvalynxForm into your HTML file like this:\n\n```html\n\u003cscript src=\"vendor/avalynx/avalynx-form/dist/js/avalynx-form.js\"\u003e\u003c/script\u003e\n``` \n\nMake sure to also include Bootstrap's JS/CSS in your project to ensure AvalynxForm displays correctly.\n\n## Usage\n\nTo use AvalynxForm in your project, include the AvalynxForm JavaScript file in your project and initialize the class with the appropriate selector.\n\n```javascript\nnew AvalynxForm(\"#myForm\", {\n    apiParams: {\n        extraData1: 'value1',\n        extraData2: 'value2'\n    },\n    onSuccess: function(response) {\n        console.log('Form submission was successful:', response);\n    },\n    onError: function(response) {\n        console.error('Form submission failed:', response);\n    }\n});\n```\n\n## Options\n\nAvalynxForm allows the following options for customization:\n\n- `id`: (string) The ID of the element to attach the form to.\n- `options`: An object containing the following keys:\n  - `apiParams`: (object) Additional parameters to be sent with the form data (default: `{}`).\n  - `loader`: (object) An instance of AvalynxLoader to use as the loader for the modal (default: `null`).\n  - `onSuccess`: (function) A callback function to be executed when the form submission is successful (default: `null`).\n  - `onError`: (function) A callback function to be executed when the form submission fails (default: `null`).\n\n## Contributing\n\nContributions 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:\n\n- Bug fixes\n- Feature enhancements\n- Documentation improvements\n\nBefore submitting your pull request, please ensure your changes are well-documented and follow the existing coding style of the project.\n\n## License\n\nAvalynxForm is open-sourced software licensed under the [MIT license](LICENSE).\n\n## Contact\n\nIf 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.\n\nThank you for considering AvalynxForm for your project!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Favalynx%2Favalynx-form","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Favalynx%2Favalynx-form","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Favalynx%2Favalynx-form/lists"}