| Install | |
|---|---|
composer require illuminate3/bootawesome |
Think of Bootstrap as an easy way to integrate Bootstrap with Laravel 4, providing a variety of helpers to speed up development. These include:
Bootstrap::css-bootBootstrap::css-fontBootstrap::js-1xBootstrap::js-2xBootstrap::verticalBootstrap::horizontalBootstrap::inlineBootstrap::textBootstrap::passwordBootstrap::emailBootstrap::fileBootstrap::dateBootstrap::datetimeBootstrap::timeBootstrap::textareaBootstrap::selectBootstrap::checkboxBootstrap::radioBootstrap::submitBootstrap::buttonBootstrap::resetBootstrap::linkBootstrap::secureLinkBootstrap::linkRouteBootstrap::linkActionBootstrap::linkIconBootstrap::mailtoBootstrap::noneBootstrap::successBootstrap::infoBootstrap::warningBootstrap::dangerThis package is essentially Bradley Cronford's Bootstrap
Bootstrap v3.2.0 FontAwesome v4.2.0 jquery v1.11.1 or v2.1.1
Begin by installing this package through Composer. Edit your project's composer.json file to require illuminate3/bootawesome.
"require": {
"illuminate3/bootawesome": "dev-master"
}
Next, update Composer from the Terminal:
composer update
Once this operation completes, the next step is to add the service provider. Open app/config/app.php, and add a new item to the providers array.
'Illuminate3\BootAwesome\BootstrapServiceProvider',
The final step is to introduce the facade. Open app/config/app.php, and add a new item to the aliases array.
'Bootstrap' => 'Illuminate3\BootAwesome\Facades\Bootstrap',
If you want to introduce the packages JavaScripts and Stylesheets, run the following command to pull them into your project.
php artisan asset:publish illuminate3/bootawesome
That's it! You're all set to go.
In order to include the Bootstrap dependencies you will need to utilise the Bootstrap::css() and Bootstrap:js() methods in the head section of your layout / page template.
It's really as simple as using the Bootstrap class in any Controller / Model / File you see fit with:
Bootstrap::
This will give you access to
The css-boot method includes Bootstrap CSS via either a CDN / Local file, and pass optional attributes.
Bootstrap::cssBoot();
Bootstrap::cssBoot('local', ['type' => 'text/css']);
The css-font method includes Bootstrap CSS via either a CDN / Local file, and pass optional attributes.
Bootstrap::cssFont();
Bootstrap::cssFont('local', ['type' => 'text/css']);
The js-1x method includes Bootstrap JS via either a CDN / Local file, and pass optional attributes.
Bootstrap::js1x();
Bootstrap::js1x('local', ['type' => 'text/javascript']);
The js-2x method includes Bootstrap JS via either a CDN / Local file, and pass optional attributes.
Bootstrap::js2x();
Bootstrap::js2x('local', ['type' => 'text/javascript']);
The vertical method allows a form to be set in a vertical manner. This is the default form type.
The vertical method can be chained before any form element is added and will continue for subsequent form elements until overwritten.
Bootstrap::vertical();
Bootstrap::vertical()->text('text', 'Text', 'Value');
The horizontal method allows a form to be set in a horizontal manner. This form type accepts both an input class and a label class.
The horizontal method can be chained before any form element is added and will continue for subsequent form elements until overwritten.
Bootstrap::horizontal('col-sm-10', 'col-sm-2');
Bootstrap::horizontal('col-sm-10', 'col-sm-2')->text('text', 'Text', 'Value');
The inline method allows a form to be set in an inline manner. This form type accepts only a label class.
The inline method can be chained before any form element is added and will continue for subsequent form elements until overwritten.
Bootstrap::inline('sr-only');
Bootstrap::inline('sr-only')->text('text', 'Text', 'Value');
The text method generates a text field with an optional label and Font Awesome icon, from errors and options.
Bootstrap::text('text', 'Text', 'Value', $errors);
The password method generates a password field with an optional label and Font Awesome icon, from errors and options.
Bootstrap::password('password', 'Password');
The email method generates an email field with an optional label and Font Awesome icon, from errors and options.
Bootstrap::email('email', 'Email address', 'Value');
The file method generates a file field with an optional label, from errors and options.
Bootstrap::file('file', 'File');
The date method generates a date field with a date picker, with an optional label, from errors, input options, and javascript parameters.
Bootstrap::date('date', 'Date');
Bootstrap::date('date', 'Date', date('d-m-Y'), $errors, [], ['format' => 'DD-MM-YYYY']);
The datetime method generates a date field with a datetime picker, with an optional label, from errors, input options, and javascript parameters.
Bootstrap::datetime('datetime', 'Date');
Bootstrap::datetime('datetime', 'Date', date('d-m-Y H:i:s'));
The time method generates a date field with a time picker, with an optional label, from errors, input options, and javascript parameters.
Bootstrap::time('time', 'Time');
Bootstrap::time('time', 'Time', date('H:i:s'));
The textarea method generates a textarea field with an optional label and Font Awesome icon, from errors and options.
Bootstrap::textarea('file', 'File', 'Value');
The select method generates a select field with items and an optional label, selected item, from errors and options.
Bootstrap::select('select', 'Select', ['1' => 'Item 1', '2' => 'Item 2'], 2);
The checkbox method generates a checkbox field with a value and an optional label, checked and options.
Bootstrap::checkbox('checkbox', 'Checkbox', 1, true);
The radio method generates a radio field with a value and an optional label, checked and options.
Bootstrap::checkbox('radio', 'Radio', 1);
The submit method generates a submit button with a value and optional attributes.
Bootstrap::submit('Submit');
The button method generates a button with a value and optional attributes.
Bootstrap::button('Button');
The reset method generates a reset button with a value and optional attributes.
Bootstrap::reset('Reset');
The modalButton method generates a button with a value and optional attributes.
Bootstrap::modalButton('Submit');
The link method generates a link button with a url, title and optional attributes and secure link.
Bootstrap::link('/', 'Link');
The secureLink method generates a secure link button with a url, title and optional attributes and secure link.
Bootstrap::secureLink('/', 'Link');
The linkRoute method generates a link button with a route, title and optional parameters, attributes.
Bootstrap::linkRoute('home', 'Home');
The linkAction method generates a link button with an action, title and optional parameters, attributes.
Bootstrap::linkAction('index', 'Home');
The linkIcon method generates a link button with a url, title, Font Awesome icon and optional attributes and secure link. You do not need the Font Awesome "fa" prefix, just use the icon name and it's size.
Bootstrap::linkIcon('/', 'Link', 'flag fa-fw');
The linkIconRoute method generates a link button with a url, title, Font Awesome icon and optional attributes and secure link. You do not need the Font Awesome "fa" prefix, just use the icon name and it's size.
Bootstrap::linkIcon('/', 'Link', 'flag fa-fw');
The mailto method generates a mailto link button with an email address, title and optional attributes.
Bootstrap::mailto('test@test.com', 'Email');
The none method generates a none alert with content with optional emphasis, optionally be dismissible, and optional attributes.
Bootstrap::none('A message', null, true);
The success method generates a success alert with content with optional emphasis, optionally be dismissible, and optional attributes.
Bootstrap::success('A success message', 'Well done!', true);
The info method generates an info alert with content with optional emphasis, optionally be dismissible, and optional attributes.
Bootstrap::info('An info message', 'Heads up!', true);
The warning method generates a warning alert with content with optional emphasis, optionally be dismissible, and optional attributes.
Bootstrap::warning('A warning message', 'Warning!', true);
The danger method generates a danger alert with content with optional emphasis, optionally be dismissible, and optional attributes.
Bootstrap::danger('A danger message', 'Oh snap!', true);
The fullModal method generates a modal alert with content with optional emphasis, optionally be dismissible, and optional attributes.
Bootstrap::fullModal('A modal message', 'Oh snap!', submit);
{{ Bootstrap::modalButton(
trans('lingos::button.delete'),
array(
'class' => 'btn btn-danger',
'data-toggle' => 'modal',
'data-target' => '#delete-' . $user->id,
)
) }}
{{ Bootstrap::fullModal(
$user->id, 'myModal', 'title', 'admin.users.destroy', 'delete', 'delete', 'close', 'button'
) }}
Bootawesome is open-sourced software licensed under the MIT license