Дополнительные методы jqGrid

Цикл статей «Документация jqGrid на русском».

Следующая статья — «JqGrid поддержка языков с письмом справа-налево в Firefox».
Предыдущая статья — «Общие функции и свойства jqGrid».

Для того чтобы использовать эти методы, вам нужно отметить галочкой Custom при скачивании jqGrid. Для разработчиков: эти методы расположены в файле grid.custom.js. Эти методы должны использоваться так же, как методы из статьи «Список методов экземпляров jqGrid».

Метод: filterGrid
Параметры: grid_id, params
Возвращает: HTML-объект
Этот метод может вызываться для построения пользовательской формы поиска для таблицы и должен применяться не к таблице, а к HTML-элементу.
grid_id — id таблицы, к которой поиск будет применён.
params — массив параметров. Для получения большей информации обратитесь к статье «Пользовательский поиск в jqGrid».

Метод: filterToolbar
Параметры: params
Возвращает: объект jqGrid
Этот метод такой же, как и filterGrid, но элементы фильтра располагаются в таблице под заголовками. Когда меняется ширина заголовка, то элементы фильтра тоже меняют свою ширину в соответствии с новой шириной. Другое отличие от filterGrid в том, что фильтр в панели использует определения из colModel. Для получения большей информации обратитесь к статье «Панель поиска в jqGrid».

Метод: getColProp
Параметры: colname
Возвращает: array{}
Возвращает массив свойств колонки с переданным именем из colModel.

Метод: GridDestroy
Параметры: grid_id
Возвращает: true — при успешном выполнении, иначе — false.
Удаляет всю таблицу с id=grid_id из DOM (очищает весь HTML-код, связанный с таблицей и отвязывает все события)

Метод: GridUnload
Параметры: grid_id
Возвращает: true — при успешном выполнении, иначе — false.
Единственное отличие от предыдущего метода в том, что таблица уничтожается, но элементы table и pager (если есть) остаются и могут быть использованы ещё раз.

Метод: setGridState
Параметры: state
Возвращает: объект jqGrid
Показывает или скрывает таблицу в зависимости от параметра state. Если параметр state установлен в 'visible' — таблица показывается. Если параметр установлен в 'hidden' — таблица скрывается. Этот метод не вызывает событие onHeaderClick, и заголовок таблицы всегда виден.

Метод: setColProp
Параметры: colname, properties
Возвращает: объект jqGrid
Устанавливает новые свойства в colModel. Этот метод идеален для динамического изменения настроек колонки. Обратите внимание, что некоторые свойства не могут быть изменены. Смотрите статью «Свойства colModel в jqGrid» для получения подробностей. Например:
jQuery("#grid_id").setColProp('colname',{editoptions:{value:"True:False"}});
заменит свойство editoptions.

Метод: sortGrid
Параметры: colname, reload
Возвращает: объект jqGrid
Сортирует колонку с именем colname и показывает подходящую иконку сортировки. То же самое (без иконки сортировки) может быть сделано с помощью setGridParam({sortname:'myname'}).trigger('reloadGrid') . Если reload установлено в true, то таблица перезагрузит текущую страницу и настройки sortorder.

Метод: updateGridRows
Параметры: data, rowidname, jsonreader
Возвращает: true — при успешном выполнении, иначе — false.
Этот метод обновляет текущие данные в таблице по переданному rowidname.
data — массив данных в формате [{name:value,name1:value1}, {name:value,name2:value2}], где name — значение name из colModel, и value — новое значение. Не обязательно все колонки должны присутствовать в элементах data (как и в методе setRowData)
rowidname (string) — это name из строки, которое ведёт себя как id. Если не указано, то имя "id" используется.
jsonreader (boolean) — по умолчанию false. Если установлен в true, то определение jsonReader используется для установки данных. Это работает только в случае, когда элемент 'repeatitems' в jsonReader установлен в true. В этом случае данные должны быть в парах «имя:значение», ?но только значения, где число колонок должно быть равно этим из colModel?.

 

Цикл статей «Документация jqGrid на русском».

Следующая статья — «JqGrid поддержка языков с письмом справа-налево в Firefox».
Предыдущая статья — «Общие функции и свойства jqGrid».


Поделиться:
1 Звезда2 Звезды3 Звезды4 Звезды5 Звезд (Пока оценок нет)
Загрузка...

Добавить комментарий

Ваш e-mail не будет опубликован.

*