WebAssetRegistry

实现 WebAssetRegistryInterface, DispatcherAwareInterface

Web 资源注册类

4.0.0

Joomla CMS

方法

__construct

注册表构造函数

__construct() : 

4.0.0

响应

混合

add

将资源添加到已知资源的注册表中

add( type, \Joomla\CMS\WebAsset\WebAssetItemInterface asset) : 

4.0.0

参数

类型

string资源类型,脚本或样式

资源

WebAssetItemInterface资源实例

响应

自身

addExtensionRegistryFile

辅助方法,用于使用扩展资源信息注册新文件

addExtensionRegistryFile( name) : 

4.0.0

参数

名称

string完整的扩展名,实际上是 /media 文件夹中的名称,例如:com_example、plg_system_example 等。

响应

自身

addRegistryFile

使用资源信息注册新文件

addRegistryFile( path) : 

4.0.0

参数

路径

string相对路径

响应

自身

addTemplateRegistryFile

辅助方法,用于使用模板资源信息注册新文件

addTemplateRegistryFile( template,  client) : 

4.0.0

参数

模板

string模板名称

客户端

int应用程序客户端 ID

响应

自身

createAsset

准备新的资源实例。

createAsset( name,  uri = null, mixed||string|int options = [], mixed||string|int attributes = [], mixed||string|int dependencies = []) : \Joomla\CMS\WebAsset\WebAssetItem

4.0.0

参数

名称

string资源名称

URI

string资源的 URI

选项

array<string|int, mixed>资源的其他选项

属性

array<string|int, mixed>资源的属性

依赖项

array<string|int, mixed>资源依赖项

响应

WebAssetItem

dispatchAssetChanged

分派事件以通知侦听器有关资源更改的信息:新资源、删除资源、覆盖事件

  • onWebAssetRegistryChangedAssetNew 当向注册表添加新资源时
  • onWebAssetRegistryChangedAssetOverride 当资源被覆盖时
  • onWebAssetRegistryChangedAssetRemove 当新资源从注册表中删除时
dispatchAssetChanged( type, \Joomla\CMS\WebAsset\WebAssetItemInterface asset,  change) : 

4.0.0

参数

类型

string资源类型,脚本或样式

资源

WebAssetItemInterface资源实例

更改

string更改类型:新资源、删除资源、覆盖资源

响应

exists

检查资源是否存在于注册表中。

exists( type,  name) : 

4.0.0

参数

类型

string资源类型,脚本或样式

名称

string资源名称

响应

布尔值

get

从注册表中获取现有资源,通过资源名称。

get( type,  name) : \Joomla\CMS\WebAsset\WebAssetItem
抛出

UnknownAssetException当找不到资源时

4.0.0

参数

类型

string资源类型,脚本或样式

名称

string资源名称

响应

WebAssetItem

getRegistryFiles

获取注册表文件的列表

getRegistryFiles() : mixed||string|int

4.0.0

响应

array<string|int, mixed>

parseRegistryFile

解析注册表文件

parseRegistryFile( path) : 
抛出

RuntimeException如果文件为空或无效

4.0.0

参数

路径

string数据文件的相对路径

响应

parseRegistryFiles

解析已注册的文件

parseRegistryFiles() : 

4.0.0

响应

remove

从注册表中删除资源。

remove( type,  name) : 

4.0.0

参数

类型

string资源类型,脚本或样式

名称

string资源名称

响应

自身

属性

dataFilesNew

包含资源信息的。文件路径应为相对路径。

示例

注册表文件

{ "title" : "Example", "name" : "com_example", "author": "Joomla! CMS", "assets": [ { "name": "library1", "version": "3.5.0", "type": "script", "uri": "com_example/library1.min.js" }, { "name": "library2", "version": "3.5.0", "type": "script", "uri": "com_example/library2.min.js", "dependencies": [ "core", "library1" ], "attribute": { "attr-name": "attr value" "defer": true } }, { "name": "library1", "version": "3.5.0", "type": "style", "uri": "com_example/library1.min.css" "attribute": { "media": "all" } }, { "name": "library1", "type": "preset", "dependencies": { "library1#style", "library1#script" } }, ] }

4.0.0

类型(s)

array<string|int, mixed>

dataFilesParsed

已解析文件的列表

4.0.0

类型(s)

array<string|int, mixed>

资源

可用资源的注册表

4.0.0

类型(s)

array<string|int, mixed>