Получить строки Asset::getStrings

Модуль: main — подключать отдельно не нужно

Метод Asset::getStrings возвращает строки, которые добавил метод addString, для одного места на странице. Методы getJs и $APPLICATION->ShowHead() вызывают его сами. Прикладной код вызывает метод, когда выводит строки в своем шаблоне без ShowHead.

Сигнатура метода в классе Bitrix\Main\Page\Asset:

public function getStrings($location = AssetLocation::AFTER_JS_KERNEL)

Параметры

Параметр Тип Описание
location string Задает место — константу AssetLocation. По умолчанию — AssetLocation::AFTER_JS_KERNEL

Тип в таблице описывает назначение аргумента. Сигнатура PHP не объявляет его.

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

Метод возвращает строки, разделенные переводом строки. Если строк нет, метод возвращает пустую строку.

Особенности

  • Метод выводит только строки, режим которых пересекается по битам с текущим режимом из setMode.
  • Для места AFTER_CSS при подключенном JS-ядре метод добавляет в начало служебный скрипт BX.message.
  • Ядро само добавляет строки, например скрипт часового пояса. Они тоже попадут в результат.
  • При первом вызове метод задает режим строкам без своего режима. Строки без режима, которые добавили позже, метод не выведет.

Примеры

Пример. Код добавляет строку и ищет ее в выводе:

<?php
use Bitrix\Main\Page\Asset;
use Bitrix\Main\Page\AssetLocation;

require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';

$asset = Asset::getInstance();
$asset->addString('<link rel="preconnect" href="https://cdn.example.com">', false, AssetLocation::BEFORE_CSS);

echo trim($asset->getStrings(AssetLocation::BEFORE_CSS));

Код выведет <link rel="preconnect" href="https://cdn.example.com">.

Смотрите также