Добавить строку Asset::addString

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

Метод Asset::addString добавляет строку HTML на страницу, например метатег, тег link или встроенный скрипт. Параметр location задает место строки относительно CSS и скриптов.

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

function addString($str, $unique = false, $location = AssetLocation::AFTER_JS_KERNEL, $mode = null)

Параметры

Обязательные параметры обозначены *

Параметр Тип Описание
str* string Задает строку HTML
unique bool Значение true добавляет строку один раз, даже если метод вызвали несколько раз. По умолчанию — false
location string Задает место — константу AssetLocation, например AssetLocation::AFTER_CSS. По умолчанию — AssetLocation::AFTER_JS_KERNEL
mode int или null Задает режим композитного сайта — константу AssetMode. По умолчанию — null, тогда строка получает режим текущего набора

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

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

Метод возвращает true. Если строка пустая, метод возвращает false.

Особенности

Метод не экранирует строку. Значения из запроса перед добавлением экранируйте, например функцией htmlspecialcharsbx.

Примеры

Пример. Код добавляет метатег один раз, хотя вызывает метод дважды:

<?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('<meta name="unit" content="kg">', true, AssetLocation::AFTER_JS);
$asset->addString('<meta name="unit" content="kg">', true, AssetLocation::AFTER_JS);

echo substr_count($asset->getStrings(AssetLocation::AFTER_JS), 'name="unit"');

Код выведет 1.

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

Предыдущая