WebAsset

Пакет классов WebAsset предназначен для работы с веб-ресурсами в Joomla.

Расположение

/libraries/src/WebAsset

Пространство имён

Joomla\CMS\WebAsset

Состав пакета

• WebAssetAttachBehaviorInterface - интерфейс подключения веб-ресурса к документу;
• WebAssetItem - класс элемента веб-ресурса;
• WebAssetItemInterface - интерфейс элемента веб-ресурса;
• WebAssetManager - менеджер элементов веб-ресурсов;
• WebAssetManagerInterface - интерфейс менеджера элементов веб-ресурсов;
• WebAssetRegistry - реестр элементов веб-ресурсов;
• WebAssetRegistryInterface - интерфейс реестра элементов веб-ресурсов;
• AssetItem/CoreAssetItem - класс базового элемента веб-ресурса;
• AssetItem/FormValidateAssetItem - класс элемента веб-ресурса для ресурса form.validate;
• AssetItem/KeepaliveAssetItem - класс элемента веб-ресурса для ресурса keepalive;
• AssetItem/LangActiveAssetItem - класс загрузки файла ресурсов для активного языка;
• Exception/InvalidActionException - класс исключения, определяющий ошибку недопустимого действия;
• Exception/UnknownAssetException - класс исключения, определяющий неизвестный ресурс;
• Exception/UnsatisfiedDependencyException - класс исключения, определяющий неполную зависимость;
• Exception/WebAssetExceptionInterface - интерфейс исключения, определяющий ошибку WebAsset;

Использование

/** @var Joomla\CMS\WebAsset\WebAssetManager $wa */.
$wa = Factory::getApplication()->getDocument()->getWebAssetManager();

// Подключаем ресурс
$wa->useScript('keepalive');

// Или несколько ресурсов
$wa->useScript('keepalive')
    ->useScript('fields.validate')
    ->useStyle('foobar')
    ->useScript('foobar');

// Добавляем новый элемент ресурса с зависимостью и используем его
$wa->registerAndUseScript('bar', 'com_foobar/bar.js', [], [], ['core', 'foobar']);

// Отключаем ресурс
$wa->disableScript('jquery-noconflict');