mantix/livewire-bootstrap-components

Reusable Livewire Bootstrap components by Mantix BV

v1.22 2025-12-15 14:16 UTC

Requires

• php: ^8.0
• livewire/livewire: ^3.0

MIT

• Pieter Naber

README

Reusable Livewire Bootstrap components by Mantix BV.

Installation

composer require mantix/livewire-bootstrap-components

Usage

Publish the views and styles (optional):

# Publish views
php artisan vendor:publish --provider="Mantix\\LivewireBootstrapComponents\\LivewireBootstrapComponentsServiceProvider" --tag=views

# Publish SCSS files
php artisan vendor:publish --provider="Mantix\\LivewireBootstrapComponents\\LivewireBootstrapComponentsServiceProvider" --tag=scss

Components

Card Component

A flexible card component with customizable styling and optional header/footer.

<x-bootstrap::card 
    title="Card Title"
    :square="true"
    background_image="/path/to/image.jpg"
    background_color="primary"
    text_color="white"
    footer="Footer content"
    :actions="[
        ['href' => '/items/1', 'icon' => 'eye', 'color' => 'primary', 'label' => __('View')],
        ['wire:click' => 'editItem', 'icon' => 'pencil', 'color' => 'secondary', 'label' => __('Edit')]
    ]">
    Card content here.
</x-bootstrap::card>

Attributes:

• title (string, optional): Card header title
• square (boolean, default: false): Apply square styling
• background_image (string, optional): Background image URL
• background_color (string, optional): Bootstrap background color class
• text_color (string, optional): Bootstrap text color class
• footer (string, optional): Footer content
• actions (array, optional): Array of action configurations (see Actions Component)

Form Group Component

A form group wrapper with label, icon support, and automatic error handling.

<x-bootstrap::form-group 
    label="Email Address"
    icon="envelope"
    :required="true">
    <input type="email" name="email" class="form-control" wire:model="email">
</x-bootstrap::form-group>

Attributes:

• label (string, optional): Form field label
• icon (string, optional): FontAwesome icon name (without 'fa-' prefix)
• required (boolean, default: false): Show required asterisk

Features:

• Automatically detects wire:model and displays validation errors
• Supports input groups with icons
• Responsive design with proper spacing

List Row Component

A list item component with flexible action buttons for CRUD operations.

<x-bootstrap::list-row 
    class="custom-class"
    background_color="light"
    text_color="dark"
    :actions="[
        ['href' => '/items/1', 'icon' => 'eye', 'color' => 'light', 'label' => 'View'],
        ['wire:click' => 'startItem', 'icon' => 'play', 'color' => 'primary', 'label' => 'Start'],
        ['wire:click' => 'moveUp', 'icon' => 'arrow-up', 'color' => 'outline-primary'],
        ['wire:click' => 'moveDown', 'icon' => 'arrow-down', 'color' => 'outline-primary'],
        ['wire:click' => 'editItem', 'icon' => 'pencil', 'color' => 'dark', 'label' => 'Edit'],
        ['wire:click' => 'deleteItem', 'icon' => 'trash-can', 'color' => 'danger', 'label' => 'Delete', 'confirm' => 'Are you sure?']
    ]">
    Item content here
</x-bootstrap::list-row>

Attributes:

• class (string, optional): Additional CSS classes
• background_color (string, optional): Bootstrap background color
• text_color (string, optional): Bootstrap text color
• actions (array, optional): Array of action configurations (see Actions Component)

Action Configuration: Each action in the actions array can have:

• href (string, optional): URL for regular links (use either href or wire:click)
• wire:click (string, optional): Livewire method name (use either href or wire:click)
• icon (string, optional, default: 'circle'): FontAwesome icon name (without 'fa-' prefix)
• color (string, optional, default: 'light'): Bootstrap button color class
• label (string, optional): Text label to display next to the icon
• confirm (string, optional): Confirmation message for wire:click actions

Features:

• Double-click to view or edit (automatically detects 'view' or 'edit' in wire:click methods)
• Responsive design: button group on desktop (md and up), dropdown menu on mobile
• Supports both regular links (href) and Livewire actions (wire:click)
• Confirmation dialogs for destructive actions

Actions Component

Shared action renderer used by cards and list rows. It accepts the same actions array format shown above and automatically builds responsive button groups (desktop) and dropdowns (mobile). You can also use it directly:

<x-bootstrap::actions :actions="[
    ['href' => route('items.show', $item), 'icon' => 'eye', 'color' => 'light', 'label' => __('View')],
    ['wire:click' => 'edit', 'icon' => 'pencil', 'color' => 'primary', 'label' => __('Edit')],
    ['wire:click' => 'delete', 'icon' => 'trash-can', 'color' => 'danger', 'label' => __('Delete'), 'wire:confirm' => __('ui.confirm_delete')]
]" />

Modal Component

A complete modal component with form support and multiple levels.

<x-bootstrap::modal 
    id="myModal"
    size="lg"
    title="Modal Title"
    close_function="closeModal"
    submit_function="saveData"
    submit_color="primary"
    submit_text="Save"
    submit_icon="save"
    :level="2">
    Modal content here
</x-bootstrap::modal>

Attributes:

• id (string, required): Modal ID
• size (string, optional): Modal size (sm, lg, xl)
• title (string, required): Modal title
• close_function (string, optional): Livewire method to close modal
• submit_function (string, optional): Livewire method for form submission
• submit_color (string, optional): Submit button color (default: primary)
• submit_text (string, optional): Submit button text
• submit_icon (string, optional): Submit button icon
• level (integer, optional): Modal z-index level (1-5)

Features:

• ESC key support for closing
• Loading states on submit button
• Multiple z-index levels for nested modals
• Automatic form wrapper when submit function is provided

Session Message Component

Displays session flash messages with different types.

<x-bootstrap::session-message />

Features:

• Displays message (info), success, and danger session messages
• Dismissible alerts with close buttons
• Automatic error display integration

Errors Component

Displays validation errors in a dismissible alert.

<x-bootstrap::errors />

Features:

• Shows all validation errors in a single alert
• Dismissible with close button
• Automatically included in modal

Styles

The package includes SCSS files for modal z-index management. After publishing the SCSS files, you can import them in your main SCSS file:

@import '../../vendor/mantix/livewire-bootstrap-components/resources/scss/livewire-bootstrap-components';

Modal Z-Index Levels

The package provides 5 levels of modal z-index management:

• Level 1: Default Bootstrap modal (z-index: 1055)
• Level 2: z-index: 1065 (backdrop: 1060)
• Level 3: z-index: 1075 (backdrop: 1070)
• Level 4: z-index: 1085 (backdrop: 1080)
• Level 5: z-index: 1095 (backdrop: 1090)

Requirements

• Laravel 8+
• Livewire 3.x
• Bootstrap 5.x
• FontAwesome 6.x

License

MIT © Mantix BV