IncludeComponent
Описание и параметры
mixed IncludeComponent( string componentName, string componentTemplate, array arParams=array(), object parentComponent=null, array arFunctionParams=array(), $returnResult = false );
Метод подключает компонент 2.0. Нестатический метод.
Параметры
Параметр | Описание |
---|---|
componentName | Имя компонента. Например: "bitrix:news.detail". |
componentTemplate | Имя шаблона компонента. Если имя пустое, то подразумевается имя ".default". |
arParams | Массив входных параметров компонента. |
parentComponent | Объект родительского комплексного компонента, если компонент подключается из шаблона комплексного компонента. В шаблоне комплексного компонента определена переменная $component, которая содержит объект этого комплексного компонента. |
arFunctionParams | Массив, содержащий дополнительные параметры отображения компонента:
"HIDE_ICONS"=>"Y" - не показывать панель настройки компонента в режиме редактировани/разработки; "ACTIVE_COMPONENT"=>"N" - отключить компонент (код компонента не подключается). |
returnResult | По умолчанию - false позволяет получить на выходе arResult компонента. |
Возвращаемое значение
Возвращает код компонента.
Пример
// Подключим компонент каталога с шаблоном "по-умолчанию" на публичной странице сайта $APPLICATION->IncludeComponent( "bitrix:catalog", "", Array( "SEF_MODE" => "N", "IBLOCK_TYPE_ID" => "catalog", "ACTION_VARIABLE" => "action", "CACHE_TIME" => 1*24*60*60, "BASKET_PAGE_TEMPLATE" => "/personal/basket.php", ) );
// Подключим компонент карточки фотографии с шаблоном "по-умолчанию" в шаблоне // комплексного компонента "фотогалерея" $APPLICATION->IncludeComponent( "bitrix:photo.detail", "", Array( "IBLOCK_TYPE" => $arParams["IBLOCK_TYPE"], "IBLOCK_ID" => $arParams["IBLOCK_ID"], "ELEMENT_ID" => $arResult["VARIABLES"]["ELEMENT_ID"], "ELEMENT_CODE" => $arResult["VARIABLES"]["ELEMENT_CODE"], ), $component );
Сообщение не промодерировано, возможны ошибки и неточности.
|
parentComponent нужен для того, чтобы в режиме кеширования компонента js/css всех вызываемых в шаблоне дочерних компонентов тоже попадали в кэш вызывающего их родительского компонента. Иначе их стили и js будут подключаться только при сбросе кэша (ну или если кэш выключен).
|
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.