Центр документации
|
Самоучитель по интеграции дизайна и настройке Amiro.CMS на примере демонстрационной версии пакета Визитка »
Пример добавления полей при инициализации списка.
Объяснение кода Наследник контроллера компоненты пустой, поскольку мы пока не изменяем поведение по умолчанию.
Свойства $orderColumn и $orderDirection класса отображения задают сортировку списка по умолчанию (поле и направление сортировки соответственно).
В данном случае будет применена сортировка по полю nickname по возрастанию. Добавляем столбцы списка отображающие поля nickname, birth, age модели. Поле id так же будет передано в список, но визуально выводиться не будет. Полю age задан числовой формат.
Поле nickname объявляется как "тянущееся", т.е. будет иметь переменную ширину столбца.
Добавляем возможность сортировки по столбцам public, nickname, birth
Порядок полей Изначально, поля добавляются в список в том порядке, в котором выполнялись операции добавления (addColumn). Для задания порядка полей используются позиции (placeholders).
Позиция – это место в последовательности, относительно которого могут быть размещены элементы управления и другие позиции. Механизм применяется для того, чтобы создать единообразие расположения элементов управления. Позиции бывают 2 видов: позиции элементов и секции. Секцию следует понимать, как логическую группу элементов. Секция отличается от позиции элемента тем, что имеет начало и конец. Секции и позиции элементов описываются в классе отображения в массиве $aPlaceholders. Стандартный массив позиций списка:
Элементы массива вида "#name" и "name" определяют начало и конец секции. Элементы массива не имеющие одноименного предшествующего элемента начинающегося символом #, являются позициями элемента.
При добавлении поля, в массиве $aPlaceholders отображения создается одноименная позиция элемента. Большинство методов добавления полей компонент позволяют добавить поле относительно какой-либо позиции. Пример
В данном примере добавляется поле nickname, позиция которого определяется по следующему правилу:
Рассмотрим подробнее возможные относительные положения. У позиции элемента есть 2 относительных положения для добавления:
В отличие от позиции элемента, для секции существуют 4 относительных положения для добавления:
Следует понимать:
Заголовки Заголовки столбцов описываются в файле локализации списка "_local/_admin/templates/lang/60/{$modId}_list.lng". Имена переменных должны соответствовать формату "list_col_имяСтолбца". Например:
|