slavawins/formbuilder

Expa

1.3.6 2024-11-13 11:59 UTC

Requires

• php: ^7.3|^8.0

MIT

• slavaWins

README

Form Builder

Кароч изи пакет для инпутов. На основе ботсрапа.

Установка

1. Установить из композера

composer require slavawins/formbuilder

1. Опубликовать js файлы необходимые для работы пакета. Вызывать команду:

   php artisan vendor:publish --provider="SlavaWins\Formbuilder\Providers\FormbuilderServiceProvider"
   

После этого в папке public_html/js/ будут созданы 3 джс файла нужные для использования пакета

1. Подключить js файлы в любом удобном месте. Можно просто в app.blade.php

   <script src="{{ asset('js/formbuilder/formBuilderHelper.js') }}"></script>
   <script src="{{ asset('js/formbuilder/InputValidatorValues.js') }}"></script>
   <script src="{{ asset('js/formbuilder/ApprovedModalController.js') }}"></script>

ApprovedModalController - стоит поместить вниз где footer. Что бы jquery успел прогрузится.

Использваоние

Открываете вью в котором хотите создать поля. И добавляете в нем зависимость

@php
   use SlavaWins\Formbuilder\Library\FElement;
@endphp

Затем в нужном месте пишете такой блок. Это создаст поле в две колонки. Слева будет лейбл. Справа инпут. Снизу будет описание Он автокомплитестся.

@php
   FElement::NewInputTextRow()
       ->SetLabel("Лебл поля")
       ->SetName("amountPrice")
       ->SetValue(old("amountPrice", "test"))
       ->SetDescr("В какую суммы вы готовы уложится?")
       ->RenderHtml(true);
@endphp

След пример добавить фронтенд валидацию для суммы ->FrontendValidate()->Money()

@php
   FElement::NewInputTextRow()
       ->SetLabel("Лебл поля")
       ->SetName("amountPrice")
       ->FrontendValidate()->Money()
       ->SetValue(old("amountPrice", "test"))
       ->SetDescr("В какую суммы вы готовы уложится?")
       ->RenderHtml(true);
@endphp

Этот пример создаст фронтенд валидацию с требованием ввести от 15 до 120 символов

@php
   FElement::NewInputTextRow()
    ->SetLabel("Название заказаа")
    ->SetName("title")
    ->FrontendValidate()->String(15,120)
    ->SetPlaceholder("Например: Нужно отправить груз")
    ->SetDescr("Кратко опишите суть заказа")
    ->SetValue(old("title", "Example text") )
    ->RenderHtml(true);
@endphp

Следующий пример это апров модалка. Вы просто пишите в ссылке тег approvedModal, и на фронтенде при нажатии на кнопку будет выскакивать модалка переспрашивающие нажатие кнопки

  <a class="btn "
          href="/delete"
          approvedModal="Вы действительно хотите удалить этот объект?"
       >Удалить</a>

К этой штуке нужно подключить вью. Можно сделать

@include("formbuilder::approved-modal")

Кастомизация.

Создайте у себя:

resources\views\formbuilder\component

Скопируйте туда всё с:

vendor\slavawins\formbuilder\src\resources\views\component

Теперь вы можете кастомизировать элементы формы, прямо у себя в проекте.