Поделиться через

Советы по реализации элемента управления JS Grid

  • Статья

Дата последнего изменения: 24 июня 2011 г.

Применимо к: SharePoint Foundation 2010

В этой статье
Контроллер
Фильтрация
Хранение
Печать сетки
Присоединение к событиям
Отладочные версии JsGrid.js и JsGrid.Gantt.js

Контроллер

Контроллер управления JS Grid сообщает сетке способ отображения содержимого (то есть какие панели или столбцы следует отображать). Контроллер позволяет использовать источник данных. Он также умеет обрабатывать несвязанные строки, позволяя редактировать их, не создавая локальной копии всех данных.

В контроллере можно также определять стили. В следующем коде RegisterCellStyle определяет стиль "TextRightAlign", который может использоваться для выравнивания столбцов по правому краю.

<SharePoint:JSGrid ID="_grid" runat="server" /> 
<script type="text/javascript">
    Type.registerNamespace("GridManager");
    this.control;
    GridManager = function () {
        this.Init = function (jsGridControl, initialData, props) {
            control = jsGridControl;
            var dataSource = new SP.JsGrid.StaticDataSource(initialData);
            var jsGridParams = dataSource.InitJsGridParams();
            jsGridParams.styleManager.RegisterCellStyle('TextRightAlign', SP.JsGrid.Style.CreateStyle(SP.JsGrid.Style.Type.Cell, { textAlign: 'right' }));

            jsGridControl.Init(jsGridParams);
        }
    };
</script>

Полный текст примера см. в статье Практическое руководство. Создание базовой таблицы JS Grid.

Фильтрация

Ниже приводится список параметров, которые могут оказаться полезны для фильтрации содержимого:

  • Состояние столбца: скрытый/видимый

  • Порядок столбцов

  • Ширина столбца

  • Сложный фильтр

  • Группировка

  • Сортировка

  • Положение полосы разделения

Хранение

Термин хранение относится к сохранению настроек фильтров, групп, сортировки и выбора представления между сеансами работы пользователей. Хранение — это функция каждого контроллера.

К параметрам, которые не нужно хранить между сеансами, относятся:

  • Автоматическая фильтрация. Сохраненные параметры автоматической фильтрации могут запутать пользователей, которые не будут понимать, почему в их представлении нет данных. Клиентские фильтры, настроенные вручную, сохраняются.

  • Иерархия. Набор данных создается "на лету", поэтому его трудно сохранять, однако параметр "Отображение уровня схемы" сохраняется. Этот параметр задает создание упомянутого выше набора данных в представлении.

  • Выбранная строка или столбец.

ПримечаниеПримечание

В Microsoft Office Project Server 2007 между сеансами сохранялось большинство параметров. В Project Server 2010 до сих пор можно выбрать хранение для страницы. По умолчанию должно устанавливаться сохранение параметров в пользовательских параметрах, если только не имеется серьезных оснований для хранения настроек только в течение сеанса.

Печать сетки

При печати контроллер загружает данные сетки в режиме только для чтения. Если набор данных разбит на страницы, эта операция может занимать много времени, поэтому рекомендуется открыть новое окно браузера. Печать запускается с левой стороны браузера. Если страница не соответствует ожиданиям пользователя, он может закрыть окно печати, добавить или удалить столбцы, изменить масштаб и снова нажать кнопку Печать.

Присоединение к событиям

В этом примере показано присоединение пользовательского кода к событию OnCellEditComplete.

<script type="text/javascript">
    Type.registerNamespace("GridManager");

    GridManager = function () {
        this.Init = function (jsGridControl, initialData, props) {
            control = jsGridControl;
            var dataSource = new SP.JsGrid.StaticDataSource(initialData);
            var jsGridParams = dataSource.InitJsGridParams();

            // This event is triggered after the standard grid error checking.
            jsGridControl.AttachEvent(SP.JsGrid.EventType.OnCellEditCompleted, GotHere);

            jsGridControl.Init(jsGridParams);
        }
    };
    function GotHere(obj) {
        alert('Got Here, ' + obj.fieldKey);

    }
</script>

Отладочные версии JsGrid.js и JsGrid.Gantt.js

Отладочные версии JsGrid.js и JsGrid.Gantt.js устанавливаются вместе с продуктом, обычно в каталоге %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS. В этих файлах представлены важные сведения о JS Grid.

См. также

Задачи

Практическое руководство. Создание базовой таблицы JS Grid

Ссылка

Microsoft.SharePoint.JSGrid

Концепции

Мини-приложения элемента управления JS Grid

Другие ресурсы

JS Grid Control Delegates