' . t( - 'Obtenga más información sobre fetchpriority.' - ) . '
', - '#weight' => 20, - ]; - } +#[LegacyHook] +function image_fetchpriority_form_alter(array &$form, FormStateInterface $form_state, string $form_id): void +{ + \Drupal::service(ImageFetchpriorityHooks::class)->formAlter($form, $form_state, $form_id); } // --------------------------------------------------------------------------- @@ -128,24 +65,10 @@ function image_fetchpriority_form_alter(array &$form, FormStateInterface $form_s * * Appends the chosen fetchpriority value to the formatter summary row. */ -function image_fetchpriority_field_formatter_settings_summary_alter(array &$summary, array $context): void { - /** @var \Drupal\Core\Field\FormatterInterface $formatter */ - $formatter = $context['formatter']; - - if (!in_array($formatter->getPluginId(), IMAGE_FETCHPRIORITY_SUPPORTED_FORMATTERS, TRUE)) { - return; - } - - $image_loading = $formatter->getSetting('image_loading') ?? []; - $fetchpriority = $image_loading['fetchpriority'] ?? 'auto'; - - $labels = [ - 'low' => t('Fetchpriority: Baja'), - 'auto' => t('Fetchpriority: Automática'), - 'high' => t('Fetchpriority: Alta'), - ]; - - $summary[] = $labels[$fetchpriority] ?? $labels['auto']; +#[LegacyHook] +function image_fetchpriority_field_formatter_settings_summary_alter(array &$summary, array $context): void +{ + \Drupal::service(ImageFetchpriorityHooks::class)->fieldFormatterSettingsSummaryAlter($summary, $context); } // --------------------------------------------------------------------------- @@ -158,28 +81,8 @@ function image_fetchpriority_field_formatter_settings_summary_alter(array &$summ * Injects fetchpriority="high|low|auto" into #item_attributes of every image * element produced by a supported formatter. */ -function image_fetchpriority_entity_display_build_alter(array &$build, array $context): void { - /** @var \Drupal\Core\Entity\Display\EntityViewDisplayInterface $display */ - $display = $context['display']; - - foreach ($display->getComponents() as $field_name => $component) { - if ( - empty($component['type']) - || !in_array($component['type'], IMAGE_FETCHPRIORITY_SUPPORTED_FORMATTERS, TRUE) - ) { - continue; - } - - if (!isset($build[$field_name])) { - continue; - } - - $fetchpriority = $component['settings']['image_loading']['fetchpriority'] ?? 'auto'; - - foreach (Element::children($build[$field_name]) as $delta) { - if (isset($build[$field_name][$delta]['#item_attributes'])) { - $build[$field_name][$delta]['#item_attributes']['fetchpriority'] = $fetchpriority; - } - } - } +#[LegacyHook] +function image_fetchpriority_entity_display_build_alter(array &$build, array $context): void +{ + \Drupal::service(ImageFetchpriorityHooks::class)->entityDisplayBuildAlter($build, $context); } diff --git a/image_fetchpriority.services.yml b/image_fetchpriority.services.yml new file mode 100644 index 0000000..1a07bdd --- /dev/null +++ b/image_fetchpriority.services.yml @@ -0,0 +1,5 @@ + +services: + Drupal\image_fetchpriority\Hook\ImageFetchpriorityHooks: + class: Drupal\image_fetchpriority\Hook\ImageFetchpriorityHooks + autowire: true diff --git a/src/Hook/ImageFetchpriorityHooks.php b/src/Hook/ImageFetchpriorityHooks.php new file mode 100644 index 0000000..a5400df --- /dev/null +++ b/src/Hook/ImageFetchpriorityHooks.php @@ -0,0 +1,135 @@ +getFormObject() instanceof \Drupal\field_ui\Form\EntityViewDisplayEditForm) { + return; + } + if (empty($form['fields'])) { + return; + } + /** @var \Drupal\Core\Entity\Display\EntityViewDisplayInterface $display */ + $display = $form_state->getFormObject()->getEntity(); + foreach (\Drupal\Core\Render\Element::children($form['fields']) as $field_name) { + // Only act on fields currently showing their settings edit form. + if (!isset($form['fields'][$field_name]['plugin']['settings_edit_form']['settings']['image_loading'])) { + continue; + } + // Only act on supported formatters. + $component = $display->getComponent($field_name); + if (empty($component['type']) || !in_array($component['type'], IMAGE_FETCHPRIORITY_SUPPORTED_FORMATTERS, TRUE)) { + continue; + } + // Read stored value; falls back to 'auto' on first use. + $image_loading = $component['settings']['image_loading'] ?? [ + ]; + $fetchpriority = $image_loading['fetchpriority'] ?? 'auto'; + // Reference to the image_loading details for readability. + $image_loading_el =& $form['fields'][$field_name]['plugin']['settings_edit_form']['settings']['image_loading']; + // Inject fetchpriority as a direct child of the image_loading details. + // Order: ascending priority — low → auto → high (mirrors lazy → eager). + $image_loading_el['fetchpriority'] = [ + '#type' => 'radios', + '#title' => $this->t('Atributo de prioridad de carga'), + '#default_value' => $fetchpriority, + '#weight' => 10, + '#options' => [ + 'low' => $this->t('Baja (fetchpriority="low")'), + 'auto' => $this->t('Automática (fetchpriority="auto")'), + 'high' => $this->t('Alta (fetchpriority="high")'), + ], + ]; + $image_loading_el['fetchpriority']['low']['#description'] = $this->t('Indica que esta imagen tiene menor impacto en el usuario y puede cargarse más tarde.'); + $image_loading_el['fetchpriority']['auto']['#description'] = $this->t('No establece preferencia. Es el valor por defecto si no se especifica.'); + $image_loading_el['fetchpriority']['high']['#description'] = $this->t('Indica que esta imagen es importante y debe cargarse lo antes posible. ' . 'Útil para imágenes "above-the-fold" como la imagen principal.'); + $image_loading_el['fetchpriority_info'] = [ + '#markup' => '' . $this->t('Obtenga más información sobre fetchpriority.') . '
', + '#weight' => 20, + ]; + } + } + // --------------------------------------------------------------------------- + // Settings summary + // --------------------------------------------------------------------------- + /** + * Implements hook_field_formatter_settings_summary_alter(). + * + * Appends the chosen fetchpriority value to the formatter summary row. + */ + #[Hook('field_formatter_settings_summary_alter')] + public function fieldFormatterSettingsSummaryAlter(array &$summary, array $context): void + { + /** @var \Drupal\Core\Field\FormatterInterface $formatter */ + $formatter = $context['formatter']; + if (!in_array($formatter->getPluginId(), IMAGE_FETCHPRIORITY_SUPPORTED_FORMATTERS, TRUE)) { + return; + } + $image_loading = $formatter->getSetting('image_loading') ?? [ + ]; + $fetchpriority = $image_loading['fetchpriority'] ?? 'auto'; + $labels = [ + 'low' => $this->t('Fetchpriority: Baja'), + 'auto' => $this->t('Fetchpriority: Automática'), + 'high' => $this->t('Fetchpriority: Alta'), + ]; + $summary[] = $labels[$fetchpriority] ?? $labels['auto']; + } + // --------------------------------------------------------------------------- + // Render + // --------------------------------------------------------------------------- + /** + * Implements hook_entity_display_build_alter(). + * + * Injects fetchpriority="high|low|auto" into #item_attributes of every image + * element produced by a supported formatter. + */ + #[Hook('entity_display_build_alter')] + public static function entityDisplayBuildAlter(array &$build, array $context): void + { + /** @var \Drupal\Core\Entity\Display\EntityViewDisplayInterface $display */ + $display = $context['display']; + foreach ($display->getComponents() as $field_name => $component) { + if (empty($component['type']) || !in_array($component['type'], IMAGE_FETCHPRIORITY_SUPPORTED_FORMATTERS, TRUE)) { + continue; + } + if (!isset($build[$field_name])) { + continue; + } + $fetchpriority = $component['settings']['image_loading']['fetchpriority'] ?? 'auto'; + foreach (\Drupal\Core\Render\Element::children($build[$field_name]) as $delta) { + if (isset($build[$field_name][$delta]['#item_attributes'])) { + $build[$field_name][$delta]['#item_attributes']['fetchpriority'] = $fetchpriority; + } + } + } + } +}