Документация для разработчиков
Темная тема

GetDropDownFilter

Описание и параметры

string
CForm::GetDropDownFilter(
 int field_id,
 string parameter_type,
 string filter_sid,
 string add_to_dropdown = "class=\"inputselect\""
)

Возвращает HTML код поля фильтра, представляющего из себя выпадающий список одиночного выбора. Данный выпадающий список может быть использован для фильтрации результатов по значению ответа на вопрос веб-формы. Значения этого выпадающего списка формируются из значений параметров ответов - ANSWER_TEXT или ANSWER_VALUE. Метод нестатический.

Примечание
Имя результирующего HTML поля будет сформировано по следующей маске:
find_filter_sid

Параметры метода

Параметр Описание С версии
field_id ID вопроса/поля.
parameter_type Тип параметра ответа, допустимы следующие значения:
  • ANSWER_TEXT;
  • ANSWER_VALUE.
filter_sid Идентификатор поля фильтра. Формируется по следующему шаблону:
FSID_QSID_PTYPE_dropdown,
где:
  • FSID - символьный идентификатор веб-формы;
  • QSID - символьный идентификатор вопроса/поля веб-формы;
  • PTYPE - тип параметра ответа, задаваемый в parameter_type.
Примеры:
  • ANKETA_MARRIED_ANSWER_TEXT_dropdown;
  • ANKETA_CAR_ANSWER_VALUE_dropdown.
add_to_dropdown Произвольный HTML который будет добавлен в тег выпадающего списка:
<select add_to_dropdown ...>

Параметр необязательный. По умолчанию - "class=\"inputselect\"".

Примеры использования

<form name="form1" action="" method="POST">
<table>
    <tr>
        <td>Образование:</td>
        <td><?
            $FIELD_ID = 15; // ID вопроса "Ваше образование?"
            echo CForm::GetDropDownFilter(
                $FIELD_ID, 
                "ANSWER_TEXT", 
                "ANKETA_EDUCATION_ANSWER_TEXT_dropdown", 
                "class=\"inputselect\""
                );
            ?></td>
    </tr>
</table>
<input type="submit" value="Фильтр">
</form>


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2020, «1С-Битрикс», 2020
Наверх