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

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-2021, «1С-Битрикс», 2021
Наверх