Okipa / laravel-bootstrap-components

⚠️ THIS PACKAGE HAS BEEN ABANDONED IN FAVOR OF https://github.com/Okipa/laravel-form-components. ⚠️
=> Only bug fixes will be merged. Please consider moving to the new package.

Save time and take advantage of a set of dynamical, ready-to-use and fully customizable bootstrap form components.

Found this package helpful? Please consider supporting my work!

Compatibility

Upgrade guide

• From V4 to V5
• From V3 to V4
• From V2 to V3
• From V1 to V2

Usage

Just call the components you need in your views and let this package take care of the HTML generation annoying part.

Standard use case

Call this component in your view:

{{-- Helper style --}}
{{ inputText()->name('name') }}

{{-- Facade style --}}
{{ InputText::name('name') }}

And get this HTML generated for you:

<div class="component-container form-group">
    <label for="text-name">
        Name
    </label>
    <div class="input-group">
        <div class="input-group-prepend">
            <span class="input-group-text">
                <i class="fas fa-font"></i>
            </span>
        </div>
        <input id="text-name"
            class="component form-control"
            type="text"
            name="name"
            value=""
            placeholder="Name">
    </div>
</div>

Multilingual use case

Call this component in your view:

{{-- Helper style --}}
{{ inputText()->name('title')->localized(['fr', 'en']) }}

{{-- Facade style --}}
{{ InputText::name('title')->localized(['fr', 'en']) }}

And get this HTML generated for you:

<div class="component-container form-group">
    <label for="text-title-fr">
        Title (FR)
    </label>
    <div class="input-group">
        <div class="input-group-prepend">
            <span class="input-group-text">
                <i class="fas fa-font"></i>
            </span>
        </div>
        <input id="text-title-fr"
            class="component form-control"
            type="text"
            name="title[fr]"
            value=""
            placeholder="Title (FR)"
            data-locale="fr">
    </div>
</div>
<div class="component-container form-group">
    <label for="text-title-en">
        Title (EN)
    </label>
    <div class="input-group">
        <div class="input-group-prepend">
            <span class="input-group-text">
                <i class="fas fa-font"></i>
            </span>
        </div>
        <input id="text-title-en"
            class="component form-control"
            type="text"
            name="title[en]"
            value=""
            placeholder="Title (EN)"
            data-locale="en">
    </div>
</div>

Table of Contents

• Installation
• Configuration
• Translations
• Views
• API documentation
• Testing
• Changelog
• Contributing
• Credits
• Licence

Installation

• Install the package with composer:

composer require okipa/laravel-bootstrap-components

Configuration

Publish the package configuration file to customize it if necessary:

php artisan vendor:publish --tag=bootstrap-components:config

⚠️ You may have to run a composer dump-autoload after changing a path in your configuration file.

Translations

All displayed labels or sentences are translatable.

See how to translate them on the Laravel official documentation: https://laravel.com/docs/localization#using-translation-strings-as-keys.

Here is the list of the words and sentences available for translation:

• Create
• Update
• Validate
• Back
• Cancel
• Remove
• No file selected.
• Awaited format: Day/Month/Year.
• Awaited format: Hour:Minutes.
• Awaited format: Day/Month/Year Hour:Minutes.
• Your browser does not support the :tag HTML5 tag.

You will also have to define each attribute you define in the ->name() method in the validation (attributes key) translation file.

Views

Publish the package views to customize them if necessary:

php artisan vendor:publish --tag=bootstrap-components:views

API documentation

• Components list
• Component types

Testing

composer test

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Credits

• Arthur LORENT
• All Contributors

License

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