class FilterImageStyle in Inline responsive images 8.2
Provides a filter to render inline images as image styles.
Plugin annotation
@Filter(
id = "filter_imagestyle",
module = "inline_responsive_images",
title = @Translation("Display image styles"),
description = @Translation("Uses the data-image-style attribute on <img> tags to display image styles."),
type = Drupal\filter\Plugin\FilterInterface::TYPE_TRANSFORM_REVERSIBLE
)
Hierarchy
- class \Drupal\Component\Plugin\PluginBase implements DerivativeInspectionInterface, PluginInspectionInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
- class \Drupal\filter\Plugin\FilterBase implements FilterInterface
- class \Drupal\inline_responsive_images\Plugin\Filter\FilterImageStyle
- class \Drupal\filter\Plugin\FilterBase implements FilterInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
Expanded class hierarchy of FilterImageStyle
File
- src/
Plugin/ Filter/ FilterImageStyle.php, line 26 - Contains \Drupal\inline_responsive_images\Plugin\Filter\FilterImageStyle.
Namespace
Drupal\inline_responsive_images\Plugin\FilterView source
class FilterImageStyle extends FilterBase {
/**
* {@inheritdoc}
*/
public function settingsForm(array $form, FormStateInterface $form_state) {
$image_styles = \Drupal::entityTypeManager()
->getStorage('image_style')
->loadMultiple();
$form['image_styles'] = array(
'#type' => 'markup',
'#markup' => 'Select the image styles that are available in the editor',
);
foreach ($image_styles as $image_style) {
$form['image_style_' . $image_style
->id()] = array(
'#type' => 'checkbox',
'#title' => $image_style
->label(),
'#default_value' => isset($this->settings['image_style_' . $image_style
->id()]) ? $this->settings['image_style_' . $image_style
->id()] : 0,
);
}
return $form;
}
/**
* {@inheritdoc}
*/
public function process($text, $langcode) {
if (stristr($text, 'data-image-style') !== FALSE && stristr($text, 'data-responsive-image-style') == FALSE) {
$image_styles = \Drupal::entityTypeManager()
->getStorage('image_style')
->loadMultiple();
$dom = Html::load($text);
$xpath = new \DOMXPath($dom);
foreach ($xpath
->query('//*[@data-entity-type="file" and @data-entity-uuid and @data-image-style]') as $node) {
$file_uuid = $node
->getAttribute('data-entity-uuid');
$image_style_id = $node
->getAttribute('data-image-style');
// If the image style is not a valid one, then don't transform the HTML.
if (empty($file_uuid) || !isset($image_styles[$image_style_id])) {
continue;
}
// Retrieved matching file in array for the specified uuid.
$matching_files = \Drupal::entityTypeManager()
->getStorage('file')
->loadByProperties([
'uuid' => $file_uuid,
]);
$file = reset($matching_files);
// Stop further element processing, if it's not a valid file.
if (!$file) {
continue;
}
$image = \Drupal::service('image.factory')
->get($file
->getFileUri());
// Stop further element processing, if it's not a valid image.
if (!$image
->isValid()) {
continue;
}
$width = $image
->getWidth();
$height = $image
->getHeight();
$node
->removeAttribute('width');
$node
->removeAttribute('height');
$node
->removeAttribute('src');
// Make sure all non-regenerated attributes are retained.
$attributes = array();
for ($i = 0; $i < $node->attributes->length; $i++) {
$attr = $node->attributes
->item($i);
$attributes[$attr->name] = $attr->value;
}
// Set up image render array.
$image = array(
'#theme' => 'image_style',
'#uri' => $file
->getFileUri(),
'#width' => $width,
'#height' => $height,
'#attributes' => $attributes,
'#style_name' => $image_style_id,
);
$altered_html = \Drupal::service('renderer')
->render($image);
// Load the altered HTML into a new DOMDocument and retrieve the elements.
$alt_nodes = Html::load(trim($altered_html))
->getElementsByTagName('body')
->item(0)->childNodes;
foreach ($alt_nodes as $alt_node) {
// Import the updated node from the new DOMDocument into the original
// one, importing also the child nodes of the updated node.
$new_node = $dom
->importNode($alt_node, TRUE);
// Add the image node(s)!
// The order of the children is reversed later on, so insert them in reversed order now.
$node->parentNode
->insertBefore($new_node, $node);
}
// Finally, remove the original image node.
$node->parentNode
->removeChild($node);
}
return new FilterProcessResult(Html::serialize($dom));
}
return new FilterProcessResult($text);
}
/**
* {@inheritdoc}
*/
public function tips($long = FALSE) {
if ($long) {
$image_styles = \Drupal::entityTypeManager()
->getStorage('image_style')
->loadMultiple();
$list = '<code>' . implode('</code>, <code>', array_keys($image_styles)) . '</code>';
return $this
->t('
<p>You can display images using a site-wide style by adding a <code>data-image-style</code> attribute, whose value is one of the image style machine names: !image-style-machine-name-list.</p>', array(
'!image-style-machine-name-list' => $list,
));
}
else {
return $this
->t('You can display images using site-wide styles by adding a data-image-style attribute.');
}
}
}
Members
Name![]() |
Modifiers | Type | Description | Overrides |
---|---|---|---|---|
DependencySerializationTrait:: |
protected | property | An array of entity type IDs keyed by the property name of their storages. | |
DependencySerializationTrait:: |
protected | property | An array of service IDs keyed by property name used for serialization. | |
DependencySerializationTrait:: |
public | function | 1 | |
DependencySerializationTrait:: |
public | function | 2 | |
FilterBase:: |
public | property | The name of the provider that owns this filter. | |
FilterBase:: |
public | property | An associative array containing the configured settings of this filter. | |
FilterBase:: |
public | property | A Boolean indicating whether this filter is enabled. | |
FilterBase:: |
public | property | The weight of this filter compared to others in a filter collection. | |
FilterBase:: |
public | function |
Calculates dependencies for the configured plugin. Overrides DependentPluginInterface:: |
1 |
FilterBase:: |
public | function |
Gets default configuration for this plugin. Overrides ConfigurableInterface:: |
|
FilterBase:: |
public | function |
Gets this plugin's configuration. Overrides ConfigurableInterface:: |
|
FilterBase:: |
public | function |
Returns the administrative description for this filter plugin. Overrides FilterInterface:: |
|
FilterBase:: |
public | function |
Returns HTML allowed by this filter's configuration. Overrides FilterInterface:: |
4 |
FilterBase:: |
public | function |
Returns the administrative label for this filter plugin. Overrides FilterInterface:: |
|
FilterBase:: |
public | function |
Returns the processing type of this filter plugin. Overrides FilterInterface:: |
|
FilterBase:: |
public | function |
Prepares the text for processing. Overrides FilterInterface:: |
|
FilterBase:: |
public | function |
Sets the configuration for this plugin instance. Overrides ConfigurableInterface:: |
1 |
FilterBase:: |
public | function |
Constructs a \Drupal\Component\Plugin\PluginBase object. Overrides PluginBase:: |
4 |
FilterImageStyle:: |
public | function |
Performs the filter processing. Overrides FilterInterface:: |
|
FilterImageStyle:: |
public | function |
Generates a filter's settings form. Overrides FilterBase:: |
|
FilterImageStyle:: |
public | function |
Generates a filter's tip. Overrides FilterBase:: |
|
FilterInterface:: |
constant | HTML tag and attribute restricting filters to prevent XSS attacks. | ||
FilterInterface:: |
constant | Non-HTML markup language filters that generate HTML. | ||
FilterInterface:: |
constant | Irreversible transformation filters. | ||
FilterInterface:: |
constant | Reversible transformation filters. | ||
MessengerTrait:: |
protected | property | The messenger. | 29 |
MessengerTrait:: |
public | function | Gets the messenger. | 29 |
MessengerTrait:: |
public | function | Sets the messenger. | |
PluginBase:: |
protected | property | Configuration information passed into the plugin. | 1 |
PluginBase:: |
protected | property | The plugin implementation definition. | 1 |
PluginBase:: |
protected | property | The plugin_id. | |
PluginBase:: |
constant | A string which is used to separate base plugin IDs from the derivative ID. | ||
PluginBase:: |
public | function |
Gets the base_plugin_id of the plugin instance. Overrides DerivativeInspectionInterface:: |
|
PluginBase:: |
public | function |
Gets the derivative_id of the plugin instance. Overrides DerivativeInspectionInterface:: |
|
PluginBase:: |
public | function |
Gets the definition of the plugin implementation. Overrides PluginInspectionInterface:: |
3 |
PluginBase:: |
public | function |
Gets the plugin_id of the plugin instance. Overrides PluginInspectionInterface:: |
|
PluginBase:: |
public | function | Determines if the plugin is configurable. | |
StringTranslationTrait:: |
protected | property | The string translation service. | 1 |
StringTranslationTrait:: |
protected | function | Formats a string containing a count of items. | |
StringTranslationTrait:: |
protected | function | Returns the number of plurals supported by a given language. | |
StringTranslationTrait:: |
protected | function | Gets the string translation service. | |
StringTranslationTrait:: |
public | function | Sets the string translation service to use. | 2 |
StringTranslationTrait:: |
protected | function | Translates a string to the current language or to a given language. |