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

addString

boolean public
\Bitrix\Main\Page\Asset::addString(
$str,
boolean $unique = false,
string $location = \Bitrix\Main\Page\AssetLocation::AFTER_JS_KERNEL,
null $mode = null
);

Нестатический метод добавляет строку в секцию <head>…</head> сайта.

Чтобы вызвать addString(), сначала получите экземпляр класса:

\Bitrix\Main\Page\Asset::getInstance()->addString(...);

Класс \Bitrix\Main\Page\Asset реализует Singleton. Подробно про класс читайте в статье Asset.

Аналог метода CMain::AddHeadString в старом ядре.

Параметры

ПараметрОписание
$strСтрока, которая будет добавлена. Если передать пустую строку '', метод вернет false и ничего не добавит
$uniqueЕсли true, строка хранится как уникальная по хешу md5($str) в пределах выбранного $location. Повторный вызов с той же строкой не создает новую запись, а дополняет список target.
$locationТочка вывода строки. По умолчанию \Bitrix\Main\Page\AssetLocation::AFTER_JS_KERNEL. Используются константы AssetLocation: BEFORE_CSS, AFTER_CSS, AFTER_JS_KERNEL, AFTER_JS.
$modeРежим композита для строки. Значение сохраняется в записи и используется при выводе через getStrings(). Можно передать null.

Возвращаемое значение

Возвращает true, если строка добавлена в очередь, и false, если передана пустая строка.

Пример

use Bitrix\Main\Page\Asset;

Asset::getInstance()->addString("");


© «Битрикс», 2001-2026, «1С-Битрикс», 2026