Цикл статей «Документация jqGrid на русском».
Следующая статья — «Метод saveRow в jqGrid».
Предыдущая статья — «Редактирование строки в jqGrid».
Пример вызова:
1 |
jQuery("#grid_id").editRow(rowid, keys, oneditfunc, successfunc, url, extraparam, aftersavefunc,errorfunc, afterrestorefunc); |
Или с помощью нового API:
1 |
jQuery("#grid_id").jqGrid('editRow',rowid, keys, oneditfunc, successfunc, url, extraparam, aftersavefunc,errorfunc, afterrestorefunc) |
Где:
- grid_id — id уже инициализированной таблицы
- rowid — id строки для редактирования
- keys — если установлен в true, то пользователь может использовать клавишу Enter для сохранения строки и клавишу Esc для отмены редактирования.
- oneditfunc — эта функция вызывается после успешного перевода строки в режим редактирования, до того как пользователь сможет вводить значения в поля. Идентификатор id строки передаётся в качестве параметра этой функции.
- succesfunc, url, extraparam, aftersavefunc,errorfunc и afterrestorefunc описаны в статье «Метод saveRow в jqGrid».
Строка не может редактироваться, если у неё указан класс 'not-editable-row', даже несмотря на то что для некоторых полей свойство editable установлено в true.
Параметр oneditfunc в editRow не должен быть заключён в кавычки и не должен заканчиваться () — он должен быть просто именем функции.
Начиная с версии 4 jqGrid, параметры можно передавать в объекте.
Вызов с объектом в качестве параметра:
1 2 3 4 5 6 7 |
jQuery("#grid_id").jqGrid('editRow',rowid, { keys : true, oneditfunc: function() { alert ("edited"); } }); |
Объект с параметрами по умолчанию выглядит так:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
editparameters = { "keys" : false, "oneditfunc" : null, "successfunc" : null, "url" : null, "extraparam" : {}, "aftersavefunc" : null, "errorfunc": null, "afterrestorefunc" : null, "restoreAfterError" : true, "mtype" : "POST" } jQuery("#grid_id").jqGrid('editRow',rowid, parameters); |
Если keys установлено в true, то оставшиеся настройки: successfunc, url, extraparam, aftersavefunc, errorfunc и afterresoеrefunc — все они передаются в качестве аргументов метода saveRow при нажатии клавиши Enter (saveRow не нужно объявлять, так как он вызывается jqGrid автоматически). Для получения более подробной информации обратитесь к статье «Метод saveRow в jqGrid».
При вызове этой строки для конкретной колонки jqGrid считывает данные для редактируемых полей и создаёт подходящие элементы в соответствии с edittype и editoptions.
Цикл статей «Документация jqGrid на русском».
Следующая статья — «Метод saveRow в jqGrid».
Предыдущая статья — «Редактирование строки в jqGrid».