加载资源挂钩/手册

来自MediaWiki.org
跳转到导航 跳转到搜索
资源加载寄存器
可从版本1.17.0
允许使用ResourceLoader有条件地注册模块
定义函数:
公众的 静止的 功能 onResourceLoaderRegisterModules( 资源加载器 $资源加载器 ) { ... }
连接挂钩:

扩展名.json:

{
	“钩子”: {
		“ResourceLoaderRegisterModules”: “MyExtensionHooks::onResourceLoaderRegisterModules”
	}
}
呼叫来源:文件: 资源加载程序.php
接口:ResourceLoaderRegisterModulesHook.php

有关附加挂钩的详细信息,请参见图谱:钩.
有关使用此钩子的扩展的示例,请参见类别:ResourceLoaderRegisterModules扩展.

细节[编辑]

  • $resourceLoader-resourceLoader对象。

使用[编辑]

警告 警告: 仅在需要时使用此钩子(例如,对于条件依赖项)。如果可能,使用$wgResourceModules(资源模块). 另请参见ResourceLoader/迁移指南(开发人员).

ResourceLoaderModule对象(提供对脚本、样式和消息的访问)此时可以添加到ResourceLoader中。 一个常见的用例是注册一个对其他扩展和类具有“软”依赖关系的资源。 例如,模块可以依赖于事件记录仅当安装了EventLogging时才使用架构。使用这个钩子可以在注册模块之前有条件地添加到依赖项数组中。对于单个注册:

$资源加载器->登记( '我的模块', [ '脚本' => '...' ] );

您可以传入“script”、“styles”、“localBasePath”等数组,就像在$wgreesourcemodules中附加一个项一样。

对于多个注册:

$资源加载器->登记( 阵列( '我的模块' => [ '脚本' => '...' ], ... ) );

请注意,对于mw1.26及更高版本,您不能使用这个钩子侦听器修改$wgResourceModules。

另请参见