Получить строки 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">.
Смотрите также
Была ли статья полезна?
Предыдущая
Следующая