protected $selectorWithVariant = '.{prefix}-{name}-{variant}';
protected $targets = [ 'desktop', 'mobile' ];
- /** @var string Position on the page to load this module at */
- protected $position = 'bottom';
-
/**
* Constructs a new module from an options array.
*
* 'selectorWithVariant' => [CSS selector template, variables: {prefix} {name} {variant}],
* // List of variants that may be used for the image files
* 'variants' => [
- * [theme name] => [
+ * // This level of nesting can be omitted if you use the same images for every skin
+ * [skin name (or 'default')] => [
* [variant name] => [
* 'color' => [color string, e.g. '#ffff00'],
* 'global' => [boolean, if true, this variant is available
* ],
* // List of image files and their options
* 'images' => [
- * [theme name] => [
+ * // This level of nesting can be omitted if you use the same images for every skin
+ * [skin name (or 'default')] => [
* [icon name] => [
* 'file' => [file path string or array whose values are file path strings
* and whose keys are 'default', 'ltr', 'rtl', a single
$this->{$member} = $option;
break;
- case 'position':
case 'prefix':
case 'selectorWithoutVariant':
case 'selectorWithVariant':
$selectors = $this->getSelectors();
foreach ( $this->getImages( $context ) as $name => $image ) {
- $declarations = $this->getCssDeclarations(
- $image->getDataUri( $context, null, 'original' ),
- $image->getUrl( $context, $script, null, 'rasterized' )
- );
- $declarations = implode( "\n\t", $declarations );
+ $declarations = $this->getStyleDeclarations( $context, $image, $script );
$selector = strtr(
$selectors['selectorWithoutVariant'],
[
$rules[] = "$selector {\n\t$declarations\n}";
foreach ( $image->getVariants() as $variant ) {
- $declarations = $this->getCssDeclarations(
- $image->getDataUri( $context, $variant, 'original' ),
- $image->getUrl( $context, $script, $variant, 'rasterized' )
- );
- $declarations = implode( "\n\t", $declarations );
+ $declarations = $this->getStyleDeclarations( $context, $image, $script, $variant );
$selector = strtr(
$selectors['selectorWithVariant'],
[
return [ 'all' => $style ];
}
+ /**
+ * @param ResourceLoaderContext $context
+ * @param ResourceLoaderImage $image Image to get the style for
+ * @param string $script URL to load.php
+ * @param string|null $variant Variant to get the style for
+ * @return string
+ */
+ private function getStyleDeclarations(
+ ResourceLoaderContext $context,
+ ResourceLoaderImage $image,
+ $script,
+ $variant = null
+ ) {
+ $imageDataUri = $image->getDataUri( $context, $variant, 'original' );
+ $primaryUrl = $imageDataUri ?: $image->getUrl( $context, $script, $variant, 'original' );
+ $declarations = $this->getCssDeclarations(
+ $primaryUrl,
+ $image->getUrl( $context, $script, $variant, 'rasterized' )
+ );
+ return implode( "\n\t", $declarations );
+ }
+
/**
* SVG support using a transparent gradient to guarantee cross-browser
* compatibility (browsers able to understand gradient syntax support also SVG).
return $localBasePath;
}
- /**
- * @return string
- */
- public function getPosition() {
- $this->loadFromDefinition();
- return $this->position;
- }
-
/**
* @return string
*/