GetSettingsHTML
Описание и параметры
string CIBlockProperty*::GetSettingsHTML( array arProperty, array strHTMLControlName, array &arPropertyFields );
Метод возвращает безопасный HTML отображения настроек свойства для формы редактирования инфоблока. Метод статический при использовании штатных свойств. У свойств, созданных клиентом, обязан быть статическим при использовании php7.
Примечание: вызывается при построении формы редактирования инфоблока.
Параметры вызова
| Параметр | Описание |
|---|---|
| arProperty | Метаданные свойства. См. Свойства элементов инфоблока |
| strHTMLControlName | Имя элемента управления для заполнения настроек свойства. Массив вида:
array( "NAME" => html безопасное имя для настроек, ); |
| arPropertyFields | Пустой массив. |
Возвращаемое значение
HTML для встраивания в форму редактирования инфоблока.
В параметре arPropertyFields можно вернуть дополнительные флаги управления формой:- HIDE - массив названий полей свойства которые будут скрыты для редактирования. Возможные значения: MULTIPLE, SEARCHABLE, FILTRABLE, WITH_DESCRIPTION, MULTIPLE_CNT, ROW_COUNT, COL_COUNT и DEFAULT_VALUE.
- SHOW - массив полей которые должны быть показаны даже если базовое свойство их не поддерживает. Возможные значения: MULTIPLE, SEARCHABLE, FILTRABLE, WITH_DESCRIPTION, MULTIPLE_CNT, ROW_COUNT и COL_COUNT.
- SET - ассоциативный массив полей для принудительного выставления значений в случае если они не отображаются в форме. Возможные значения: MULTIPLE, SEARCHABLE, FILTRABLE, WITH_DESCRIPTION, MULTIPLE_CNT, ROW_COUNT и COL_COUNT.
- USER_TYPE_SETTINGS_TITLE - строка для отображения в качестве заголовка секции настроек.
Смотрите также
Примеры использования
<?
class CIBlockPropertyMyDateTime
{
function GetSettingsHTML($arProperty, $strHTMLControlName, &$arPropertyFields)
{
$arPropertyFields = array(
"HIDE" => array("FILTRABLE", "ROW_COUNT", "COL_COUNT", "DEFAULT_VALUE"), //will hide the field
"SET" => array("FILTRABLE" => "N"), //if set then hidden field will get this value
"USER_TYPE_SETTINGS_TITLE" => "Настройки даты/времени"
);
return '<tr>
<td>Длина поля ввода:</td>
<td><input type="text" size="5" name="'.$strHTMLControlName["NAME"].'[WIDTH]"></td>
</tr>';
}
}
?>
© «Битрикс», 2001-2025, «1С-Битрикс», 2025