function AttachmentsResponseProcessorInterface::processAttachments

Same name in other branches
  1. 8.9.x core/lib/Drupal/Core/Render/AttachmentsResponseProcessorInterface.php \Drupal\Core\Render\AttachmentsResponseProcessorInterface::processAttachments()
  2. 10 core/lib/Drupal/Core/Render/AttachmentsResponseProcessorInterface.php \Drupal\Core\Render\AttachmentsResponseProcessorInterface::processAttachments()
  3. 11.x core/lib/Drupal/Core/Render/AttachmentsResponseProcessorInterface.php \Drupal\Core\Render\AttachmentsResponseProcessorInterface::processAttachments()

Processes the attachments of a response that has attachments.

Libraries, JavaScript settings, feeds, HTML <head> tags, HTML <head> links, HTTP headers, and the HTTP status code are attached to render arrays using the #attached property. The #attached property is an associative array, where the keys are the attachment types and the values are the attached data. For example:

$build['#attached']['library'][] = [
    'library' => [
        'core/jquery',
    ],
];
$build['#attached']['http_header'] = [
    [
        'Content-Type',
        'application/rss+xml; charset=utf-8',
    ],
];

The available keys are:

  • 'library' (asset libraries)
  • 'drupalSettings' (JavaScript settings)
  • 'feed' (RSS feeds)
  • 'html_head' (tags in HTML <head>)
  • 'html_head_link' (<link> tags in HTML <head>)
  • 'http_header' (HTTP headers and status code)

Placeholders need to be rendered first in order to have all attachments available for processing. For an example, see \Drupal\Core\Render\HtmlResponseAttachmentsProcessor::renderPlaceholders()

Parameters

\Drupal\Core\Render\AttachmentsInterface $response: The response to process.

Return value

\Drupal\Core\Render\AttachmentsInterface The processed response, with the attachments updated to reflect their final values.

Throws

\InvalidArgumentException Thrown when the $response parameter is not the type of response object the processor expects.

2 methods override AttachmentsResponseProcessorInterface::processAttachments()
AjaxResponseAttachmentsProcessor::processAttachments in core/lib/Drupal/Core/Ajax/AjaxResponseAttachmentsProcessor.php
Processes the attachments of a response that has attachments.
HtmlResponseAttachmentsProcessor::processAttachments in core/lib/Drupal/Core/Render/HtmlResponseAttachmentsProcessor.php
Processes the attachments of a response that has attachments.

File

core/lib/Drupal/Core/Render/AttachmentsResponseProcessorInterface.php, line 56

Class

AttachmentsResponseProcessorInterface
Defines an interface for processing attachments of responses that have them.

Namespace

Drupal\Core\Render

Code

public function processAttachments(AttachmentsInterface $response);

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.