Цикл статей «Документация jqGrid на русском».
Следующая статья — «Свойство formoptions в jqGrid».
Предыдущая статья — «Свойство editoptions в jqGrid».
Это свойство добавляет дополнительные свойства к элементу редактирования и должно быть использовано в colModel. Обычно оно используется для проверки пользовательского ввода перед отправкой на сервер. Синтаксис:
1 2 3 4 5 6 7 8 9 10 11 |
<script> jQuery("#grid_id").jqGrid({ ... colModel: [ ... {name:'price', ..., editrules:{edithidden:true, required:true....}, editable:true }, ... ] ... }); </script> |
Список доступных свойств:
Свойство: edithidden
Тип: boolean
Это свойство корректно только для редактирования в форме. По умолчанию скрытые поля не редактируются. Если поле скрыто и edithidden установлено в true, то поле может редактироваться при вызове метода добавления или редактирования.
Свойство: required
Тип: boolean
(true или false) если установлено в true, то значение в поле проверяется на пустоту. Если оно пустое, то отображается сообщение об ошибке.
Свойство: number
Тип: boolean
(true или false) если установлено в true, то значение в поле проверяется, если введено не число, то отображается сообщение об ошибке.
Свойство: integer
Тип: boolean
(true или false) если установлено в true, то значение проверяется, если введено не целое число, то отображается сообщение об ошибке.
Свойство: minValue
Тип: number(integer)
Если установлено, то значение проверяется, если введено число, меньшее minValue, то отображается сообщение об ошибке.
Свойство: maxValue
Тип: number(integer)
Если установлено, то значение проверяется, если введено число, большее maxValue, то отображается сообщение об ошибке.
Свойство: email
Тип: boolean
Если установлено в true, то значение в поле проверяется, если введён неправильный e-mail, то отображается сообщение об ошибке.
Свойство: url
Тип: boolean
Если установлено в true, то значение проверяется, если оно не является корректным url, то отображается сообщение об ошибке.
Свойство: date
Тип: boolean
Если установлено в true, то используется значение из свойства datefmt (если не установлено, что используется ISO-дата), и значение в поле проверяется, если введена некорректная дата, то отображается сообщение об ошибке.
Свойство: time
Тип: boolean
Если установлено в true, то значение проверяется, если оно не является корректным значением времени, то отображается сообщение об ошибке. Сейчас поддерживается только формат hh:mm и не обязательные am/pm в конце.
Свойство: custom
Тип: boolean
Если установлено в true, то включает пользовательскую проверку с помощью custom_func. Смотрите пример ниже.
Свойство: custom_func
Тип: function
Эта функция должна использоваться при свойстве custom равном true. В качестве параметров в эту функцию передаются: значение, которое нужно проверить; имя — свойство name из colModel. Функция должна вернуть массив, где первое значение — true или false. Значение true означает, что проверка прошла успешно, в противном случае — false. Второй элемент в массиве имеет смысл только при значении первого равного false и представляет собой сообщение об ошибке, которое будет отображено пользователю. Обычно это выглядит как
[false,"Please enter valid value"].
Пример пользовательской проверки
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
<script> function mypricecheck(value, colname) { if (value < 0 || value >20) return [false,"Please enter value between 0 and 20"]; else return [true,""]; } jQuery("#grid_id").jqGrid({ ... colModel: [ ... {name:'price', ..., editrules:{custom:true, custom_func:mypricecheck....}, editable:true }, ... ] ... }); </script> |
—
Цикл статей «Документация jqGrid на русском».
Следующая статья — «Свойство formoptions в jqGrid».
Предыдущая статья — «Свойство editoptions в jqGrid».
Второй элемент в массиве имеет смысл только при значении первого равного !!!true!!! и представляет собой сообщение об ошибке, которое будет отображено пользователю.
Может быть !!!FALSE!!! ?????
для Свойство: custom_func
Да, вы правы. Исправил.