Цикл статей «Документация jqGrid на русском».
Следующая статья — «».
Предыдущая статья — «Добавление строки с помощью editGridRow в jqGrid».
Этот метод такой же, как и метод editGridRow, но поля не доступны для редактирования, и нет никаких событий, связанных с формой.
Пример вызова:
|
1 |
jQuery("#grid_id").viewGridRow( rowid, properties ); |
или с помощью нового API:
|
1 |
jQuery("#grid_id").jqGrid('viewGridRow', rowid, properties ); |
где
- grid_id — id родительской таблицы
- rowid — id строки для редактирования
- properties — массив вида «ключ:значение», включающий любые из следующих свойств и событий:
Метод использует следующие свойства из языкового файла:
|
1 2 3 4 5 6 7 |
$.jgrid = { ... view : { caption: "View Record", bClose: "Close" }, ... |
Свойства
Свойство: top
Начальная позиция по вертикали модального диалогового окна. Значение по умолчанию 0 означает позицию по вертикали от левого верхнего угла таблицы. Если свойство jqModal установлено в true (смотрите ниже), и плагин jqModal доступен, то любое значение, отличное от 0 означает верхнюю позицию от верхнего левого угла окна.
По умолчанию: 0
Свойство: left
Начальная позицию по горизонтали. Значение по умолчанию 0 означает позицию по горизонтали от левого верхнего угла таблицы. Если свойство jqModal установлено в true (смотрите ниже), и плагин jqModal доступен, то любое значение, отличное от 0 означает позицию по горизонтали от левого верхнего угла окна.
По умолчанию: 0
Свойство: width
Ширина диалогового окна.
По умолчанию: 300
Свойство: height
Высота диалогового окна.
По умолчанию: «auto»
Свойство: dataheight
Высота прокручиваемого содержимого. То есть высота между заголовком и подвалом диалогового окна.
По умолчанию: auto
Свойство: modal
Должно ли быть диалоговое окно модальным. Работает только в том случае, когда плагин jqModal доступен.
По умолчанию: false
Свойство: drag
Может ли пользователь перетаскивать диалоговое окно. Работает только в том случае, когда плагин jqDnR доступен, или когда доступен widget dragable из jQuery UI.
По умолчанию: true
Свойство: resize
Можно ли изменять размер диалогового окна. Работает только в том случае, когда плагин jqDnR доступен, или доступен resizable widget из jQuery UI.
По умолчанию: true
Свойство: jqModal
Если установлено в true, то для создания диалогов используется плагин jqModal (если доступен). Если установлено в true, и плагин недоступен, то jqGrid использует свою собственную функцию для создания диалоговых окон.
По умолчанию: true
Свойство: topinfo
Если это свойство задано, то этот текст появляется сразу после заголовка диалогового окна в качестве дополнительной строки.
По умолчанию: пустая строка
Свойство: bottominfo
Если это свойство задано, то этот текст добавляется сразу после кнопок диалогового окна.
По умолчанию: пустая строка
Свойство: closeicon
Массив. Определяет иконку для кнопки отмены. Значение по умолчанию: «
[true,"left","ui-icon-close"]». Для получения более подробной информации смотрите saveicon.
По умолчанию:
Свойство: navkeys
Массив. Это свойство работает только для режима редактирования и добавляет навигацию с помощью клавиатуры, которая позволяет перемещаться по записям в форме редактирования с помощью определённых клавиш. По умолчанию навигация отключена. Первый элемент массива включает/выключает навигацию. Второй элемент указывает клавишу для перемещения вверх по записям и по умолчанию это клавиша со стрелкой вверх. Третий элемент указывает на клавишу перемещения вниз по записям и по умолчанию это клавиша со стрелкой вниз.
По умолчанию:
[false,38,40]
Свойство: closeOnEscape
Если установлено в true, то диалоговое окно может быть закрыто с помощью клавиши Esc.
По умолчанию: false
Свойство: labelswidth
Так как мы создаём форму просмотра, и ширину элементов в таблице трудно вычислить, то в зависимости от потребностей это значение может быть увеличено или уменьшено.
По умолчанию: 30%
Свойство: viewPagerButtons
Это свойство включает или выключает появление кнопок перемещения назад и вперёд по записям в форме.
По умолчанию: true
Свойство: zIndex
Начальный z-index для диалогового окна. Если вы хотите видеть диалоговую форму под другими элементами или диалогами, то вы должны использовать какое-нибудь значение большее значения по умолчанию равного 950. Во многих случаях это должно быть значение большее 1000 — значение по умолчанию для диалогов jQuery UI.
По умолчанию: 950
Свойство: recreateForm
Если установлено в true, то форма пересоздаётся каждый раз при активации диалога с новыми свойствами из colModel (если они были изменены).
По умолчанию: false
События
Событие: onClose
Это событие возникает перед закрытием формы, когда нажата иконка закрытия, кнопка отмены, Esc, или произошёл клик на слое тумана (если jqModal доступен). Событие может вернуть (но не обязательно) true. Если обработчик события возвращает true, то форма закрывается, если false, то форма не закрывается. Если ничего не возвращается, то форма закрывается.
Свойство: beforeShowForm
Возникает перед отображением формы с новыми данными. В обработчик события в качестве параметра передаётся id созданной формы.
beforeShowForm : function(formid) {…}
При создании формы используются следующие правила:
- Элементы ввода/редактирования не создаются
- Скрытые поля включаются в форму со свойством display:none для строки в форме.
- id элементов просмотра создаётся как "v_" + the name of the colModel
- Для облегчения манипуляцией элементами в форме редактирования каждая строка формы, содержащая данные, имеет id
"trv_" + name (from colmodel). Пример:
1234567<form ....><table><tr id='trv_myfield'><td> Caption</td> <td id="v_myfield"><span>content of"myfield"</span></td></tr> ...</table></form>
Цикл статей «Документация jqGrid на русском».Следующая статья — «».
Предыдущая статья — «Добавление строки с помощью editGridRow в jqGrid».