%structure.filter()%

На печать

%structure.filter()% – Выводит список фильтров для содержимого указанного раздела сайта.

Данный макрос должен использоваться совместно с макросом %structure.objList()%. При этом связка двух макросов на странице происходит по первому параметру, определяющему раздел сайта. Если для определения раздела сайта используется не ID раздела, а селектор, необходимо убедиться, что селекторы совпадают посимвольно.


%structure.filter(section[, templ_name = filter_default])%


section

ID раздела, для содержимого которого необходимо вывести список фильтров. Так же можно использовать селекторы.

templ_name

Шаблон оформления списка фильтров. Шаблоны находятся в папке /template/structure/objects. По умолчанию используется шаблон filter_default.


Структура шаблона


Шаблоны находятся в папке /template/structure/objects. По умолчанию используется шаблон filter_default.

Шаблон состоит из следующих блоков:

 

frame

Выводит общее обрамление для списка фильтров. Сюда подставятся фильтры, оформленные в соответствии с блоком list. Для вывода списка фильтров используйте макрос %list%.

 

list

Общее оформление для каждого фильтра в списке. Для вывода конкретного фильтра используется макрос %filter%. Вместо этого макроса подставляется конкретный фильтр, который оформляется в зависимости от типа поля одним из следующих блоков: filter_text, filter_beetwen_int, filter_beetwen_date, filter_boolean, filter_relation.

В данном блоке, а так же во всех вложенных, можно использовать следующие макросы:

%field.num%

Порядковый номер фильтра (поля) в списке

%field.id%

ID фильтра (поля)

%field.name%

Название фильтра (поля) на языке пользователя

%field.sname%

Системное название фильтра (поля)

%field.value%

Текущее значение фильтра (поля)

   

%class-first%

Вернет «first», если фильтр является первым в списке. Используется для генерации имен для CSS классов.

%class-last%

Вернет «last», если фильтр является последним в списке. Используется для генерации имен для CSS классов.

%class-odd%

Вернет «odd», если порядковый номер фильтра четный. Используется для генерации имен для CSS классов.

%class-even%

Вернет «even», если порядковый номер фильтра нечетный. Используется для генерации имен для CSS классов.

%class- third%

Вернет «third» для каждого третьего фильтра в списке. Используется для генерации имен для CSS классов.

 

separator

Необязательный блок. Если есть, выводит визуальный разделитель между выводом блоками active. Каких либо специальных встроенных макросов не имеет.

 

empty

Необязательный блок. Его содержимое подставляется в макрос %list% в блоке frame, если нет ни одного фильтра. Каких либо специальных встроенных макросов не имеет.

 

filter_text

Оформление фильтра для текстовых полей. Каких либо специальных встроенных макросов не имеет.

 

filter_beetwen_int

Оформление фильтра для числовых полей. В данном блоке доступные следующие локальные макросы:

%field.value1%

Начальное текущее значение фильтра (поля)

%field.value2%

Конечное текущее значение фильтра (поля)

 

filter_beetwen_date

Оформление фильтра для числовых полей. В данном блоке доступные следующие локальные макросы:

%field.value1%

Начальное текущее значение фильтра (поля)

%field.value2%

Конечное текущее значение фильтра (поля)

 

filter_boolean

Оформление фильтра для логических полей. В данном блоке доступные следующие локальные макросы:

%field.checked%

Вернет «checked», если текущее значение флажка-фильтра «выбран».

 

filter_relation

Оформление фильтра для справочников. Для вывода списка значений справочника используется макрос %list%, вместо него подставляются блоки filter_relation_list_null и filter_relation_list.

 

filter_relation_list_null

Оформление для первого нулевого значения справочника – «ничего не выбрано». В данном блоке доступные следующие локальные макросы:

%obj.selected%

Вернет «selected», если текущее значение справочника выбрано.

 

filter_relation_list

Оформление значений справочника. В данном блоке доступные следующие локальные макросы:

%obj.id%

Вернет ID текущего значения справочника.

%obj.name%

Вернет название текущего значения справочника.

%obj.selected%

Вернет «selected», если текущее значение справочника выбрано.

 

filter_relation_separator

Необязательный блок. Если есть, выводит визуальный разделитель между блоками filter_relation_list и filter_relation_list_null. Каких либо специальных встроенных макросов не имеет.



Что-то не так? Напиши, учтем!