Столбцы Editable

• Введение
• Поддерживаемые типы
• Заголовок столбца
• API
• Типы
  • Checkbox
  • Text
  • Textarea
  • Date
  • DateTime
  • Select

Расширение для класса отображения данных

Введение

Данные классы предназначены для добавления редактируемых колонок в таблицу. Данные колонки реализованы с помощь библиотеки X-editable v1.5.4

Пример использования

...
use AdminColumnEditable;
...

AdminDisplay::table()
    ->setColumns([
        AdminColumnEditable::text('name')->setLabel('Название'),       
        AdminColumnEditable::textarea('content')->setLabel('Описание'),
        AdminColumnEditable::datetime('updated_at', 'Updated At'),
        AdminColumnEditable::date('date', 'Date'),
        AdminColumnEditable::select('category_id')->setWidth('250px')
                        ->setModelForOptions(new Category)
                        ->setLabel('Категория')
                        ->setDisplay('name')
                        ->setLoadOptionsQueryPreparer(function($element, $query) {
                            return $query->MyScoupe();
                        })->setTitle('Выберите категорию:'),

        AdminColumnEditable::checkbox('visible')->setLabel('Отображение')->setWidth('30px'),


    ])
...

Класс SleepingOwl\Admin\Display\TableColumn, от которого наследуются все столбцы, реализует интерфейсы Illuminate\Contracts\Support\Arrayable, Illuminate\Contracts\Support\Renderable и SleepingOwl\Admin\Contracts\Initializable.

Поддерживаемые типы

• AdminColumnEditable::text($name, $label = null)
• AdminColumnEditable::select($name, $label = null)
• AdminColumnEditable::textarea($name, $label = null)
• AdminColumnEditable::date($name, $label = null)
• AdminColumnEditable::datetime($name, $label = null)
• AdminColumnEditable::checkbox($name, $checkedLabel = null, $uncheckedLabel = null)

Заголовок столбца

Каждый столбец таблицы имеет заголовок и хранится в виде отдельного класса SleepingOwl\Admin\Contracts\Display\TableHeaderColumnInterface.

Пример работы с заголовком

...
    ->setColumns([
        ...
        AdminColumn::link('title')->setLabel('Title')->setOrderable(false),
        ...
    ]);

Или работая напрямую с классом заголовка

...
    ->setColumns([
        ...
        $link = AdminColumn::link('title')
        ...
    ]);

    $link->getHeader()
        ->setTitle('Title')
        ->setOrderable(false)
        ->setHtmlAttribute('class', 'bg-success text-center')
        ->setHtmlAttribute('data-tooltip', 'Test tooltip');

API

Методы доступные во всех элементах

Во всех Editable элементах доступны методы обычных столбцов таблиц

Помимо этого существуют специальные методы.

setUrl

Вы можете установить свой url для отправки данных и принятия их в Кастом контроллере

SleepingOwl\Admin\Display\Column\Editable\Checkbox::setUrl(string $url): return self

setTitle

Установка сообщения в форме редактирования значения.

SleepingOwl\Admin\Display\Column\Editable\Checkbox::setTitle(string $title): return self

setReadonly

Позволяет задать, будет ли данный эдитабл редактируемым или отобразится просто текстом. Имеет более низкий приоритет, чем политика на редактирование записи (если запись запрещено изменять политикой - эдитабл будет текстом)

Пример:

AdminColumnEditable::textarea('description', 'Textarea')
  ->setReadonly(function($item) {
    return $item->id > 5;
    }),

AdminColumnEditable::text('title', 'Title1')
  ->setReadonly(true)

setEditableMode

Устанавливает способ появления формы редактирования. Внутри ячейки - ‘inline’ или по умолчанию во всплывающем окне - ‘popup’

SleepingOwl\Admin\Display\Column\Editable\Checkbox::setEditableMode(string $mode): return self

Типы

CheckBox Editable

SleepingOwl\Admin\Display\Column\Editable\Checkbox Данный элемент позволяет менять значение столбцов типа boolean прямо в таблице.

AdminColumnEditable::checkbox('visible')->setLabel('Отображение'),
//or
AdminColumnEditable::checkbox('visible','Видно', 'Не видно')->setLabel('Отображение'),

setCheckedLabel

Отображаемый текст в таблице при значении True

SleepingOwl\Admin\Display\Column\Editable\Checkbox::setCheckedLabel(string $label): return self

setUncheckedLabel

Отображаемый текст в таблице при значении False

SleepingOwl\Admin\Display\Column\Editable\Checkbox::setUncheckedLabel(string $label): return self

Text Editable

SleepingOwl\Admin\Display\Column\Editable\Text Данный элемент позволяет менять текстовое значение прямо в таблице.

AdminColumnEditable::text('name')->setLabel('Имя'),

Textarea Editable

SleepingOwl\Admin\Display\Column\Editable\Textarea Данный элемент позволяет менять текстовое значение прямо в таблице. В форме редактирования появится textarea.

AdminColumnEditable::textarea('description')->setLabel('Описание'),

Date Editable

SleepingOwl\Admin\Display\Column\Editable\Date Данный элемент позволяет менять текстовое значение прямо в таблице. В форме редактирования появится datepicker.

AdminColumnEditable::date('date')->setLabel('Дата'),

DateTime Editable

SleepingOwl\Admin\Display\Column\Editable\Datetime Данный элемент позволяет менять текстовое значение прямо в таблице. В форме редактирования появится datepicker с выбором дня и времени.

AdminColumnEditable::datetime('updated_at')->setLabel('Изменено'),

Select Editable

SleepingOwl\Admin\Display\Column\Editable\Select Данный элемент позволяет менять текстовое значение прямо в таблице. В форме редактирования появится datepicker с выбором дня и времени.

AdminColumnEditable::select('country_id')
  ->setModelForOptions(new Country)
  ->setLabel('label')
  ->setDisplay('title')