Цикл статей «Документация jqGrid на русском».
Следующая статья — «XML-данные в jqGrid».
Предыдущая статья — «Свойства colModel в jqGrid».
В первой версии jqGrid единственным способом получения данных был XML, как описано в обучающем примере в предыдущих статьях. Позже многие люди просили добавить возможность получения данных в JSON, затем в массиве и наконец с «реальными» именами. После большого количества работы и с поддержкой сообщества мы имеем сейчас большой выбор способов получения данных.
Свойства для манипуляции разными типами данных
datatype: возможные значения:
-
xml
-
json
-
jsonp
-
array
-
xmlstring
-
jsonstring
-
script
-
function (…)
Очень важно прочесть эту статью, для понимания того как вам следует работать с данными!
Маппинг (mapping) по умолчанию для XML следующий:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
jQuery("#gridid").jqGrid({ ... xmlReader : { root: "rows", row: "row", page: "rows>page", total: "rows>total", records : "rows>records", repeatitems: true, cell: "cell", id: "[id]", userdata: "userdata", subgrid: { root:"rows", row: "row", repeatitems: true, cell:"cell" } }, ... }); |
Если ваш сервер может предоставлять данные в этой структуре, то вам больше ничего не нужно делать. Но если нет, то есть путь (несколько путей) принять данные, которые вы предоставляете. Смотрите статью «XML-данные в jqGrid».
Маппинг по умолчанию для JSON следующий:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
jQuery("#gridid").jqGrid({ ... jsonReader : { root: "rows", page: "page", total: "total", records: "records", repeatitems: true, cell: "cell", id: "id", userdata: "userdata", subgrid: { root:"rows", repeatitems: true, cell:"cell" } }, ... }); |
В colModel связанные свойства: xmlmap для описания поля в формате XML, и jsonmap для описания поля в формате JSON. Пример:
1 2 3 4 5 |
jQuery("#gridid").jqGrid({ ... colModel : [ {name:'amount',..., xmlmap:'amt'...}...], ... }); |
Заставит jqGrid искать в XML данные в теге 'amt' (когда свойство repeatitems установлено в false).
Подстатьи:
XML-данные в jqGrid
Строка с XML в jqGrid
JqGrid. Заметки и ограничения использования XML-данных
JSON-данные в jqGrid
Строка с JSON в jqGrid
Точечная нотация в jqGrid
JsonReader как функция в jqGrid
Массив данных в jqGrid
Datatype function в jqGrid
Пользовательские данные в jqGrid
Цикл статей «Документация jqGrid на русском».
Следующая статья — «XML-данные в jqGrid».
Предыдущая статья — «Свойства colModel в jqGrid».