Skip to content

5.0.0

Latest
Compare
Choose a tag to compare
@stayallive stayallive released this 03 Jun 09:03
5.0.0
e4067be

With thanks to the work @tortuetorche 2 years ago to get this started! ❤️

Added

  • Add CSS class to the label of a group, with the addLabelClass() method (#604)

  • Bootstrap 5 support

  • Add Bootstrap 5 floating labels via the floatingLabel() method for <input>, <select> and <textarea> tags

    NOTE: You need to use floating label elements with a vertical_open Former instance!

    Usage with Laravel:

    {!! Former::vertical_open() !!}
        {!!
            Former::text('test-floating-label-ok')
                ->placeholder('dummy placeholder')
                ->floatingLabel()
        !!}
        {!!
            Former::select('users-floating-label')
                ->options(['User One', 'User Two', 'User Three'])
                ->placeholder('Select placeholder')
                ->floatingLabel()
        !!}
        {!!
            Former::textarea('textarea-floating-label')
                ->floatingLabel()
                ->placeholder('dummy placeholder')
        !!}
    {!! Former::close() !!}
    
    {!! Former::vertical_open() !!}
        <div class="row">
            <div class="col">
                {!!
                    Former::text('test-floating-label-one')
                        ->placeholder('dummy placeholder')
                        ->floatingLabel()
                !!}
            </div>
            <div class="col">
                {!!
                    Former::text('test-floating-label-two')
                        ->placeholder('dummy placeholder')
                        ->floatingLabel()
                !!}
            </div>
        </div>
    {!! Former::close() !!}
  • Add the switch markup which is a custom checkbox for Bootstrap 5

    Some use cases with Laravel:

    {!!
        Former::switch('valid_switch_ok')
            ->text('Valid switch OK')
    !!}
    
    {!!
        Former::switches('valid_inline_switches_ok')
            ->switches('first', 'second', 'third', 'fourth')
            ->inline()
    !!}
  • Add removeGroupClass() and removeLabelClass() methods

    Usage with Laravel:

    {!!
        Former::text('test')
            ->removeGroupClass('row')
            ->removeLabelClass('foo')
    !!}

Changed

  • Better Bootstrap 4 support
  • Breaking change: Escape HTML value of plaintext field by default (#605)
    You can disable this new behavior with the escape_plaintext_value former config option set to false.
    In your former config file config/former.php, you can enable or disable this feature:
<?php

return [
    //...

    // Whether Former should escape HTML tags of 'plaintext' fields
    // Enabled by default
    //
    // Instead of disabled this option,
    // you should use the 'HtmlString' class:
    //  Former::plaintext('text')
    //      ->forceValue(
    //          new Illuminate\Support\HtmlString('<b>HTML data</b>')
    //      )
    'escape_plaintext_value' => true,

    //...
];