Добавить CSS-файл Asset::addCss

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

Метод Asset::addCss добавляет CSS-файл на страницу. Метод $APPLICATION->ShowHead() в шаблоне сайта выводит файл в секции <head>. Локальный файл сайта попадает в текущий набор. В header.php и footer.php это набор шаблона, на странице и в компонентах — набор страницы. Файлы из /bitrix/js/ и /bitrix/css/ и внешние адреса класс кладет в набор ядра.

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

public function addCss($path, $additional = false)

Параметры

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

Параметр Тип Описание
path* string Задает путь к файлу от корня сайта, например /local/css/units.css, или внешний адрес
additional bool Значение true добавляет файл в набор шаблона после styles.css и template_styles.css. По умолчанию — false

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

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

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

Особенности

  • Метод удаляет из пути параметры после ? и подключает каждый файл один раз.
  • Если рядом лежит файл .min.css, ядро подключит его. Исходный файл ядро подключит, только если он новее. Параметр use_minified_assets главного модуля со значением N отключает это.
  • Ядро не подключит локальный файл, которого нет на диске или который пустой.
  • Файлы, которые добавили после вывода CSS, на страницу не попадут.

Примеры

Пример. Код добавляет файл и проверяет, что он попал в вывод:

<?php
use Bitrix\Main\IO\File;
use Bitrix\Main\Page\Asset;

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

$path = '/upload/vendor_units/units.css';
File::putFileContents($_SERVER['DOCUMENT_ROOT'] . $path, '.unit { color: #333; }');

$asset = Asset::getInstance();
$asset->disableOptimizeCss();
$asset->addCss($path);

var_dump(str_contains($asset->getCss(), $path));
File::deleteFile($_SERVER['DOCUMENT_ROOT'] . $path);

Код выведет bool(true). Пример выключает объединение, чтобы файл вывелся своим тегом link.

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