Download the PHP package kosv/yii2-grid-roweditable without Composer
On this page you can find all versions of the php package kosv/yii2-grid-roweditable. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package yii2-grid-roweditable
Yii2 Grid RowEditable
Yii2 расширение для редактирования данных в GridView
Установка
Выполните
или добавьте "kosv/yii2-grid-rowEditable": "1.0.*"
в composer.json
Определения
YourGridView - для использования данного расширения вам нужно иметь/создать дочерний класс от GridView
,
поэтому такой класс мы будем называть YourGridView
.
YourSaveForm - вам нужно будет создать форму в которой будет выолняться валидация и сохранение данных.
В даннной документации такая форма будет называться YourSaveForm
.
Как использовать?
- Нужно подключить данное расширение к
YourGridView
. - Нужно реализовать
YourSaveForm
. В этом классе будет выполняться процесс валидации и сохранения данных. - В экшене вашего контроллера создать объект
YourSaveForm
и реализовать логику для сохранения данных формы. - Нужно вывести
YourGridView
в вашем View и указать обязательные общие параметры редактирования. - В список столбцов добавить
Kosv\Yii2Grid\RowEditable\Select\CheckboxColumn
. Это столбец чекбоксов, который позволяет выбирать строки. - Вывести кнопку сохранения изменений.
Шаг 1. Инициализация YourGridView
Если у вас нет дочернего класса от GridView
,
то создайте его в любом месте вашего приложения
К YourGridView
подключите интерфейс Kosv\Yii2Grid\RowEditable\EditableGridInterface
,
и трейт Kosv\Yii2Grid\RowEditable\EditableGridTrait
Шаг 2. Создание YourSaveForm
Создайте класс формы и унаследуйти его от yii\base\Model
(или от любого другого потомка yii\base\Model
)
К YourSaveForm
подключите итерфейс Kosv\Yii2Grid\RowEditable\Form\SaveFormInterface
и трейт Kosv\Yii2Grid\RowEditable\Form\SaveFormTrait
В YourSaveForm
реализуйте методы: validateEditableRows
(отвечает за валидацию данных) и saveEditableRows
(отвечает за сохранение данных).
По умолчанию, данные методы не имеют реализации, поэтому вы должы сами позаботиться о том, как будут валидироваться и сохраняться ваши данные.
Шаг 3. Создание и сохранение YourSaveForm в экшене вашего контроллера
Шаг 4. Вывод и обязательные параметры
Выведите YourGridView
в представлении и укажите обязательный параметр form
Шаг 5. Колонка с чекбоксами для выбора строки
В массив колонок добавьте Kosv\Yii2Grid\RowEditable\Select\CheckboxColumn
Шаг 6. Кнопка для сохранения данных
В любом месте страницы выведите кнопку для сохранения данных
Конфигурирование
Данное расширение можно конфигурировать как для отдельных столбцов, так и использовать общии парметры конфигурации.
Более подробную информации о всех праметрах можно получить в разделе описания параметров конфигурации
Общии параметры конфигурации
Данный вид парметров задаётся в commonEditParams
:
Конфигурация столбцов
Если в массиве columns вашего YourGridView
есть столбцы без явно указанного типа (задаётся через поле class
),
то по умолчанию будет использоваться столбец с типом Kosv\Yii2Grid\RowEditable\EditableRowColumn
.
Все столбцы типа Kosv\Yii2Grid\RowEditable\EditableRowColumn
можно конфигурируются точно также как и commonEditParams
,
только параметры кофигурации задаются через поле editParams
Список параметров из commonEditParams
, которые нельзя предопределить в столбце:
prefix
, gridCssClass
, selectMode
, saveAction
, saveMethod
, saveButton
.