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

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-2024, «1С-Битрикс», 2024