Load and configure a ResourceLoader client on an HTML page. More...

Collaboration diagram for ResourceLoaderClientHtml:

[legend]

Public Member Functions
	__construct (ResourceLoaderContext $context, array $options=[])

	getBodyHtml ()

	getDocumentAttributes ()

	getHeadHtml ( $nojsClass=null)
	The order of elements in the head is as follows:

	setConfig (array $vars)
	Set mw.config variables.

	setExemptStates (array $states)
	Set state of special modules that are handled by the caller manually.

	setModules (array $modules)
	Ensure one or more modules are loaded.

	setModuleStyles (array $modules)
	Ensure the styles of one or more modules are loaded.

Static Public Member Functions
static	makeLoad (ResourceLoaderContext $mainContext, array $modules, $only, array $extraQuery=[], $nonce=null)
	Explicitly load or embed modules on a page.

Private Member Functions
	getContext ( $group, $type)

	getData ()

	getLoad ( $modules, $only, $nonce, array $extraQuery=[])

Static Private Member Functions
static	makeContext (ResourceLoaderContext $mainContext, $group, $type, array $extraQuery=[])

Private Attributes
array< string, mixed >	$config = []

ResourceLoaderContext	$context

array	$data

array< string, string >	$exemptStates = []

string[]	$modules = []

string[]	$moduleStyles = []

array< string, string\|null\|false >	$options

ResourceLoader	$resourceLoader

Detailed Description

Load and configure a ResourceLoader client on an HTML page.

Since: 1.28

Definition at line 30 of file ResourceLoaderClientHtml.php.

Constructor & Destructor Documentation

◆ __construct()

ResourceLoaderClientHtml::__construct	(	ResourceLoaderContext	$context,
		array	$options = `[]`
	)

Parameters

ResourceLoaderContext	$context
array	$options	[optional] Array of options 'target': Parameter for modules=startup request, see ResourceLoaderStartUpModule. 'safemode': Parameter for modules=startup request, see ResourceLoaderStartUpModule. 'nonce': From OutputPage->getCSP->getNonce().

Definition at line 62 of file ResourceLoaderClientHtml.php.

References $context, $options, and ResourceLoaderContext\getResourceLoader().

Member Function Documentation

◆ getBodyHtml()

ResourceLoaderClientHtml::getBodyHtml ( )

Returns: string|WrappedStringList HTML

Definition at line 337 of file ResourceLoaderClientHtml.php.

References ResourceLoader\makeInlineScript().

◆ getContext()

ResourceLoaderClientHtml::getContext	(	$group,
		$type
	)

private

Definition at line 352 of file ResourceLoaderClientHtml.php.

◆ getData()

ResourceLoaderClientHtml::getData ( )

private

Definition at line 112 of file ResourceLoaderClientHtml.php.

◆ getDocumentAttributes()

ResourceLoaderClientHtml::getDocumentAttributes ( )

Returns: array<string,string> Attributes pairs for the HTML document element

Definition at line 224 of file ResourceLoaderClientHtml.php.

◆ getHeadHtml()

ResourceLoaderClientHtml::getHeadHtml ( $nojsClass = null )

The order of elements in the head is as follows:

Inline scripts.
Stylesheets.
Async external script-src.

Reasons:

Script execution may be blocked on preceding stylesheets.
Async scripts are not blocked on stylesheets.
Inline scripts can't be asynchronous.
For styles, earlier is better.

Parameters

string | null $nojsClass Class name that caller uses on HTML document element

Returns: string|WrappedStringList HTML

Definition at line 243 of file ResourceLoaderClientHtml.php.

References ResourceLoader\filter().

◆ getLoad()

ResourceLoaderClientHtml::getLoad	(		$modules,
			$only,
			$nonce,
		array	$extraQuery = `[]`
	)

private

Definition at line 356 of file ResourceLoaderClientHtml.php.

References $modules.

◆ makeContext()

static ResourceLoaderClientHtml::makeContext	(	ResourceLoaderContext	$mainContext,
			$group,
			$type,
		array	$extraQuery = `[]`
	)

staticprivate

Definition at line 360 of file ResourceLoaderClientHtml.php.

◆ makeLoad()

static ResourceLoaderClientHtml::makeLoad	(	ResourceLoaderContext	$mainContext,
		array	$modules,
			$only,
		array	$extraQuery = `[]`,
			$nonce = `null`
	)

static

Explicitly load or embed modules on a page.

Parameters

ResourceLoaderContext	$mainContext
array	$modules	One or more module names
string	$only	ResourceLoaderModule TYPE_ class constant
array	$extraQuery	[optional] Array with extra query parameters for the request
string \| null	$nonce	[optional] Content-Security-Policy nonce (from OutputPage->getCSP->getNonce())