Начать набор Asset::startTarget
Модуль: main — подключать отдельно не нужно
Метод Asset::startTarget начинает набор. Файлы и строки, которые код добавит следующими, попадут в него. Пролог начинает наборы TEMPLATE и PAGE сам. Композитный сайт начинает свой набор для каждой динамической области, чтобы передавать ее файлы отдельно.
Сигнатура метода в классе Bitrix\Main\Page\Asset:
public function startTarget($id = '', $mode = AssetMode::ALL)
Параметры
| Параметр | Тип | Описание |
|---|---|---|
| id | string |
Задает имя набора. Метод переводит имя в верхний регистр. По умолчанию — пустая строка |
| mode | int |
Задает режим нового набора — константу AssetMode. По умолчанию — AssetMode::ALL |
Тип в таблице описывает назначение аргумента. Сигнатура PHP не объявляет его.
Возвращаемое значение
Метод возвращает true, если начал набор. Метод возвращает false, если имя пустое или свой набор с таким именем уже есть. Для TEMPLATE и PAGE метод всегда возвращает true.
Особенности
- Для наборов
TEMPLATEиPAGEметод не создает новый набор. Если текущий набор —TEMPLATEилиPAGE, метод делает запрошенный набор текущим. Если открыт свой набор, метод ничего не меняет. - Перед новым набором метод завершает текущий методом stopTarget.
- Нельзя второй раз начать свой набор с тем же именем.
Примеры
Пример. Код начинает набор и пробует начать его повторно:
<?php
use Bitrix\Main\Page\Asset;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$asset = Asset::getInstance();
var_dump($asset->startTarget('units'), $asset->startTarget('units'));
Код выведет:
bool(true)
bool(false)
Смотрите также
Была ли статья полезна?
Предыдущая
Следующая