library laravel-bootstrap-components

okipa/laravel-bootstrap-components

Laravel bootstrap components generator.

, _(*1)

, _(*2)

⚠️ 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., _(*3)

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

Found this package helpful? Please consider supporting my work!, _(*5)

, _(*6)

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., _(*7)

Standard use case

Call this component in your view:, _(*8)

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

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

And get this HTML generated for you:, _(*9)

<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:, _(*10)

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

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

And get this HTML generated for you:, _(*11)

<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:, _(*12)

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

:warning: You may have to run a composer dump-autoload after changing a path in your configuration file., _(*13)

Translations

All displayed labels or sentences are translatable., _(*14)

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

Here is the list of the words and sentences available for translation:, _(*16)

• 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., _(*17)

Views

Publish the package views to customize them if necessary:, _(*18)

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

API documentation

• Components list
• Component types

Testing

bash composer test, _(*19)

Changelog

Please see CHANGELOG for more information what has changed recently., _(*20)

Contributing

Please see CONTRIBUTING for details., _(*21)

Credits

• Arthur LORENT
• All Contributors

License

The MIT License (MIT). Please see License File for more information., _(*22)