laraflow / form

Bootstrap Style DRY(Don't Repeat Yourself) Form Library, Validation Display Suggestion Display and more
https://laraflow.github.io/form/
MIT License
15 stars 3 forks source link
blade bootstrap component error-message fields form form-builder hacktoberfest laravel template

Laraflow/Form

Latest Stable Version Total Downloads run-tests License Latest Unstable Version GitHub Code Style Action Status

Introduction

laraflow/form is a collection of Laravel Collective/HTML components. it was initially planed to create only Bootstrap4 form element styles.

Features

This package has basic form element style that is supported by bootstrap. Some basic form styles are given below:

Installation

To get start using this package follow these instructions. You can install the package via composer:

composer require laraflow/form

You need to publish the config file with:

php artisan vendor:publish --tag="form-config"

This is the contents of the published config file:

return [
    /**
     * Form style validation and other component will
     * be selected form this section
     * @var string style
     * @value bootstrap3, bootstrap4, bootstrap5
     */
    'style' => 'bootstrap4',

    /**
     * Form local language for field that support localization
     *
     * @reference month, day etc
     * @var string style
     * @value bootstrap3, bootstrap4, bootstrap5
     */
    'locale' => 'en',

    /**
     * Form month values what value and label month dropdown
     * will have
     *
     * @var array month
     */

    'months' => [
        "1" => "January",
        "2" => "February",
        "3" => "March",
        "4" => "April",
        "5" => "May",
        "6" => "June",
        "7" => "July",
        "8" => "August",
        "9" => "September",
        "10" => "October",
        "11" => "November",
        "12" => "December"
    ],

    /**
     * Form day values what value and label day dropdown
     * will have
     * @var array month
     */

    'days' => [
        "1" => "Saturday",
        "2" => "Sunday",
        "3" => "Monday",
        "4" => "Tuesday",
        "5" => "Wednesday",
        "6" => "Thursday",
        "7" => "Friday"
    ],
];

Optionally, you can publish the views using

php artisan vendor:publish --tag="form-views"

Done. Now you can fully utilize every form elements from these package

Contributing

Thank you for considering contributing to the Form! The contribution guide can be found in the Form Wiki.

Security Vulnerabilities

If you discover a security vulnerability within Form Package, please send an e-mail to Mohammad Hafijul Islam via laraflow@gmail.com. All security vulnerabilities will be promptly addressed.

License

The Form is open-sourced software licensed under the MIT license.

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

Spacial Thanks to JetBrains Logo (Main) logo. For Awesome IDE support.

License

The MIT License (MIT). Please see License File for more information.