File manager

File manager - Edit - /home/adiance/public_html/wp-content/plugins/amp/vendor/ampproject/optimizer/src/Transformer/ServerSideRendering.php

Back
<?php namespace AmpProject\Optimizer\Transformer; use AmpProject\Amp; use AmpProject\Attribute; use AmpProject\Dom\CssByteCountCalculator; use AmpProject\Dom\Document; use AmpProject\CssLength; use AmpProject\Extension; use AmpProject\Layout; use AmpProject\Optimizer\CssRule; use AmpProject\Optimizer\CssRules; use AmpProject\Optimizer\Error; use AmpProject\Optimizer\ErrorCollection; use AmpProject\Optimizer\Exception\InvalidArgument; use AmpProject\Optimizer\Exception\InvalidHtmlAttribute; use AmpProject\Optimizer\Transformer; use AmpProject\Role; use AmpProject\Tag; use DOMAttr; use DOMElement; use Exception; /** * Transformer applying the server-side rendering transformations to the HTML input. * * This is ported from the NodeJS optimizer while verifying against the Go version. * * NodeJS: * @version c92d6023ea4c9edadff593742a992da2b400a75d * @link https://github.com/ampproject/amp-toolbox/blob/c92d6023ea4c9edadff593742a992da2b400a75d/packages/optimizer/lib/transformers/ServerSideRendering.js * * Go: * @version ea0959046c179953de43077eafaeb720f9b20bdf * @link https://github.com/ampproject/amppackager/blob/ea0959046c179953de43077eafaeb720f9b20bdf/transformer/transformers/transformedidentifier.go * * @package ampproject/optimizer / final class ServerSideRendering implements Transformer { /* * List of layouts that support server-side rendering. * * @var string[] / const SUPPORTED_LAYOUTS = [ '', Layout::NODISPLAY, Layout::FIXED, Layout::FIXED_HEIGHT, Layout::RESPONSIVE, Layout::CONTAINER, Layout::FILL, Layout::FLEX_ITEM, Layout::INTRINSIC, ]; /* * List of elements to exclude from rendering their layout at the server. * * @var string[] / const EXCLUDED_ELEMENTS = [ 'amp-audio', ]; /* * XPath query to retrieve the <style amp-custom> tag, relative to the <head> node. * * @var string / const STYLE_AMP_CUSTOM_XPATH = './/style[@amp-custom]'; /* * Regex pattern to match a CSS Dimension with an associated media condition. * * @var string / const CSS_DIMENSION_WITH_MEDIA_CONDITION_REGEX_PATTERN = '/\s(?<media_condition>$.$)\s+(?<dimension>.)\s/m'; /* * Characters to use for trimming CSS values. * * @var string / const CSS_TRIM_CHARACTERS = " \t\n\r\0\x0B;"; /* * Maximum size of the CSS styles in bytes. * * @todo Max size is hard-coded for now until we ported over the generated spec into a reusable package. * * @var int / const MAX_CSS_BYTE_COUNT = 75000; /* * Smallest acceptable difference in floating point comparisons. * * @var float / const FLOATING_POINT_EPSILON = 0.00001; /* * The <style amp-custom> element that custom CSS styles need to be added to. * * @var DOMElement\|null / private $ampCustomStyleElement; /* * Count of bytes to calculate against the AMP size limit for the custom CSS styling. * * AMP only allows for 75000 bytes of CSS across <style amp-custom> and inline style attributes. * * @var int / private $ampCustomCssByteCount = 0; /* * Associative array of custom sizer styles where the key is the ID of the associated element. * * @var string[] / private $customSizerStyles = []; /* * Custom CSS rules that were extracted to remove blocking attributes. * * @var CssRules / private $customCss; /* * Apply transformations to the provided DOM document. * * @param Document $document DOM document to apply the transformations to. * @param ErrorCollection $errors Collection of errors that are collected during transformation. * @return void / public function transform(Document $document, ErrorCollection $errors) { if ($this->isAlreadyTransformed($document)) { return; } // Reset internal state for a new transform. $this->customCss = new CssRules(); $this->ampCustomCssByteCount = 0; $this->ampCustomStyleElement = null; / * Within the loop we apply the layout to the custom tags (amp-foo...) where possible, but while we're at this * we also look for reasons not to remove the boilerplate. / $canRemoveBoilerplate = true; foreach ($document->ampElements as $ampElement) { // Make sure we only deal with valid elements. if (! $ampElement instanceof DOMElement) { continue; } // Skip tags inside a template tag. if ($this->isWithinTemplate($ampElement)) { continue; } / * amp-experiment is a render delaying extension iff the tag is used in the doc. We check for that here * rather than checking for the existence of the amp-experiment script in IsRenderDelayingExtension below. / if ($ampElement->tagName === Extension::EXPERIMENT && $this->isAmpExperimentUsed($ampElement)) { $errors->add(Error\CannotRemoveBoilerplate::fromAmpExperiment($ampElement)); $canRemoveBoilerplate = false; } / * amp-audio requires knowing the dimensions of the browser. Do not remove the boilerplate or apply layout * if amp-audio is present in the document. / if ($ampElement->tagName === Extension::AUDIO) { $errors->add(Error\CannotRemoveBoilerplate::fromAmpAudio($ampElement)); $canRemoveBoilerplate = false; } / * Try to adapt 'sizes', 'heights' and 'media' attribute to turn them from blocking attributes into * CSS styles we add to <style amp-custom>. / $attributesToRemove = $this->adaptBlockingAttributes($document, $ampElement, $errors); if ($attributesToRemove === false) { $canRemoveBoilerplate = false; } / * Now apply the layout to the custom elements. If we encounter any unsupported layout, the applyLayout() * method returns false and we can't remove the boilerplate. / if (! $this->applyLayout($document, $ampElement, $errors)) { $errors->add(Error\CannotRemoveBoilerplate::fromUnsupportedLayout($ampElement)); $canRemoveBoilerplate = false; } // Removal of attributes is deferred as layout application needs them. if (is_array($attributesToRemove)) { foreach ($attributesToRemove as $attributeToRemove) { $ampElement->removeAttribute($attributeToRemove); } } } $this->renderCustomCss($document); // Emit the amp-runtime marker to indicate that we're applying server side rendering in the document. $ampRuntimeMarker = $document->createElement(Tag::STYLE); $ampRuntimeMarker->setAttribute(Attribute::AMP_RUNTIME, ''); $document->head->insertBefore( $ampRuntimeMarker, $document->head->hasChildNodes() ? $document->head->firstChild : null ); foreach ($document->xpath->query('.//script[ @custom-element ]', $document->head) as $customElementScript) { /* @var DOMElement $customElementScript / // amp-experiment is a render delaying extension iff the tag is used in the doc, which we checked for above. if ( $customElementScript->getAttribute(Attribute::CUSTOM_ELEMENT) !== Extension::EXPERIMENT && Amp::isRenderDelayingExtension($customElementScript) ) { $errors->add(Error\CannotRemoveBoilerplate::fromRenderDelayingScript($customElementScript)); $canRemoveBoilerplate = false; } } / * Below, we're only concerned about removing the boilerplate. * If we've already determined that we can't, we're done here. / if (! $canRemoveBoilerplate) { return; } // The boilerplate can be removed, note it on the <html> tag. $document->html->setAttribute(Amp::NO_BOILERPLATE_ATTRIBUTE, ''); / * Find the boilerplate and remove it. * The following code assumes that the <noscript> tag in the head is only ever used for boilerplate. / foreach ($document->xpath->query('.//noscript', $document->head) as $noscriptTagInHead) { /* @var DOMElement $noscriptTagInHead / $noscriptTagInHead->parentNode->removeChild($noscriptTagInHead); } $boilerplateStyleTags = $document->xpath->query( './/style[ @amp-boilerplate or @amp4ads-boilerplate or @amp4email-boilerplate ]', $document->head ); foreach ($boilerplateStyleTags as $boilerplateStyleTag) { /* @var DOMElement $boilerplateStyleTag / $boilerplateStyleTag->parentNode->removeChild($boilerplateStyleTag); } } /* * Check whether the document was already transformed. * * We want to ensure we don't apply server-side rendering modifications more than once. * * @param Document $document DOM document to apply the transformations to. * @return bool Whether the document was already transformed. / private function isAlreadyTransformed(Document $document) { if ($document->html->hasAttribute(Amp::LAYOUT_ATTRIBUTE)) { return true; } // Mark the document as "already transformed". $document->html->setAttribute(Amp::LAYOUT_ATTRIBUTE, ''); return false; } /* * Apply the adequate layout to a custom element. * * @param DOMElement $element Element to apply the layout to. * @param Document $document DOM document to apply the transformations to. * @param ErrorCollection $errors Collection of errors that are collected during transformation. * @return boolean Whether applying the layout was successful or not. / private function applyLayout(Document $document, DOMElement $element, ErrorCollection $errors) { $ampLayout = $this->parseLayout($element->getAttribute(Attribute::LAYOUT)); $attrWidth = $element->hasAttribute(Attribute::WIDTH) ? $element->getAttribute(Attribute::WIDTH) : null; $inputWidth = new CssLength($attrWidth); $inputWidth->validate(/ $allowAuto / true, / $allowFluid / false); if (! $inputWidth->isValid()) { $errors->add(Error\CannotPerformServerSideRendering::fromInvalidInputWidth($element)); return false; } $attrHeight = $element->hasAttribute(Attribute::HEIGHT) ? $element->getAttribute(Attribute::HEIGHT) : null; $inputHeight = new CssLength($attrHeight); $inputHeight->validate(/ $allowAuto / true, / $allowFluid / $ampLayout === Layout::FLUID); if (! $inputHeight->isValid()) { $errors->add(Error\CannotPerformServerSideRendering::fromInvalidInputHeight($element)); return false; } // Calculate effective width, height and layout. $width = $this->calculateWidth($ampLayout, $inputWidth, $element->tagName); $height = $this->calculateHeight($ampLayout, $inputHeight, $element->tagName); $layout = $this->calculateLayout( $ampLayout, $width, $height, $element->getAttribute(Attribute::SIZES), $element->getAttribute(Attribute::HEIGHTS) ); if (! $this->isSupportedLayout($layout)) { $errors->add(Error\CannotPerformServerSideRendering::fromUnsupportedLayout($element, $layout)); return false; } $this->applyLayoutAttributes($element, $layout, $width, $height); $this->maybeAddSizerInto($document, $element, $layout, $width, $height); return true; } /* * Parse the layout attribute value. * * @param string $layout Layout attribute value. * @return string Validated AMP layout, or empty string if none. / private function parseLayout($layout) { if (empty($layout)) { return ''; } $layout = strtolower($layout); if (array_key_exists($layout, Layout::TO_SPEC)) { return $layout; } return ''; } /* * Calculate the width of an element for its requested layout. * * @param string $inputLayout Requested layout. * @param CssLength $inputWidth Input value for the width. * @param string $tagName Tag name of the element. * @return CssLength Calculated Width. / private function calculateWidth($inputLayout, CssLength $inputWidth, $tagName) { if ((empty($inputLayout) \|\| $inputLayout === Layout::FIXED) && ! $inputWidth->isDefined()) { // These values come from AMP's runtime and can be found in // https://github.com/ampproject/amphtml/blob/292dc66b8c0bb078bbe3a1bca960e8f494f7fc8f/src/layout.js#L70-L86 switch ($tagName) { case Extension::ANALYTICS: case Extension::PIXEL: $width = new CssLength('1px'); $width->validate(/ $allowAuto / false, / $allowFluid / false); return $width; case Extension::AUDIO: $width = new CssLength(CssLength::AUTO); $width->validate(/ $allowAuto / true, / $allowFluid / false); return $width; case Extension::SOCIAL_SHARE: $width = new CssLength('60px'); $width->validate(/ $allowAuto / false, / $allowFluid / false); return $width; } } return $inputWidth; } /* * Calculate the height of an element for its requested layout. * * @param string $inputLayout Requested layout. * @param CssLength $inputHeight Input value for the height. * @param string $tagName Tag name of the element. * @return CssLength Calculated Height. / private function calculateHeight($inputLayout, CssLength $inputHeight, $tagName) { if ( ( empty($inputLayout) \|\| $inputLayout === Layout::FIXED \|\| $inputLayout === Layout::FIXED_HEIGHT ) && ! $inputHeight->isDefined() ) { // These values come from AMP's runtime and can be found in // https://github.com/ampproject/amphtml/blob/292dc66b8c0bb078bbe3a1bca960e8f494f7fc8f/src/layout.js#L70-L86 switch ($tagName) { case Extension::ANALYTICS: case Extension::PIXEL: $height = new CssLength('1px'); $height->validate(/ $allowAuto / false, / $allowFluid / false); return $height; case Extension::AUDIO: $height = new CssLength(CssLength::AUTO); $height->validate(/ $allowAuto / true, / $allowFluid / false); return $height; case Extension::SOCIAL_SHARE: $height = new CssLength('44px'); $height->validate(/ $allowAuto / false, / $allowFluid / false); return $height; } } return $inputHeight; } /* * Calculate the final AMP layout attribute for an element. * * @param string $inputLayout Requested layout. * @param CssLength $width Calculated width. * @param CssLength $height Calculated height. * @param string $sizesAttr Sizes attribute value. * @param string $heightsAttr Heights attribute value. * @return string Calculated layout. / private function calculateLayout( $inputLayout, CssLength $width, CssLength $height, $sizesAttr, $heightsAttr ) { if (! empty($inputLayout)) { return $inputLayout; } if (! $width->isDefined() && ! $height->isDefined()) { return Layout::CONTAINER; } if ($height->isDefined() && (! $width->isDefined() \|\| $width->isAuto())) { return Layout::FIXED_HEIGHT; } if ($height->isDefined() && $width->isDefined() && (! empty($sizesAttr) \|\| ! empty($heightsAttr))) { return Layout::RESPONSIVE; } return Layout::FIXED; } /* * Check whether a layout is support for SSR. * * @param string $layout Layout to check. * @return bool Whether the layout is supported for SSR. / private function isSupportedLayout($layout) { return in_array($layout, self::SUPPORTED_LAYOUTS, true); } /* * Apply the calculated layout attributes to an element. * * @param DOMElement $element Element to apply the layout attributes to. * @param string $layout Final layout. * @param CssLength $width Calculated width. * @param CssLength $height Calculated height. / private function applyLayoutAttributes(DOMElement $element, $layout, CssLength $width, CssLength $height) { if ($this->isExcludedElement($element)) { return; } $this->addClass($element, $this->getLayoutClass($layout)); if ($this->isLayoutSizeDefined($layout)) { $this->addClass($element, Amp::LAYOUT_SIZE_DEFINED_CLASS); } $styles = ''; switch ($layout) { case Layout::NODISPLAY: $element->setAttribute(Attribute::HIDDEN, Attribute::HIDDEN); break; case Layout::FIXED: $styles = "width:{$width->getNumeral()}{$width->getUnit()};" . "height:{$height->getNumeral()}{$height->getUnit()};"; break; case Layout::FIXED_HEIGHT: $styles = "height:{$height->getNumeral()}{$height->getUnit()};"; break; case Layout::RESPONSIVE: case Layout::INTRINSIC: // Do nothing here but emit <i-amphtml-sizer> later. break; case Layout::FILL: case Layout::CONTAINER: // Do nothing here. break; case Layout::FLEX_ITEM: if ($width->isDefined()) { $styles = "width:{$width->getNumeral()}{$width->getUnit()};"; } if ($height->isDefined()) { $styles .= "height:{$height->getNumeral()}{$height->getUnit()};"; } break; } // We prepend just in case an existing value (which shouldn't be there for valid docs) doesn't end with ';'. if ($element->hasAttribute(Tag::STYLE)) { $styles .= $element->getAttribute(Tag::STYLE); } if (! empty($styles)) { $element->setAttribute(Tag::STYLE, $styles); } $element->setAttribute(Amp::LAYOUT_ATTRIBUTE, $layout); } /* * Get the class to use for a given layout. * * @param string $layout Layout to get the class for. * @return string Class name to use for the layout. / private function getLayoutClass($layout) { if (empty($layout)) { return ''; } return Amp::LAYOUT_CLASS_PREFIX . $layout; } /* * Add a class to an element. * * This makes sure we keep existing classes on the element. * * @param DOMElement $element Element to add a class to. * @param string $class Class to add. / private function addClass(DOMElement $element, $class) { if ($element->hasAttribute(Attribute::CLASS_) && ! empty($element->getAttribute(Attribute::CLASS_))) { $class = "{$element->getAttribute(Attribute::CLASS_)} {$class}"; } $element->setAttribute(Attribute::CLASS_, $class); } /* * Check whether the provided layout is a layout with a defined size. * * @param string $layout Layout to check. * @return bool Whether the layout has a defined size. / private function isLayoutSizeDefined($layout) { return in_array($layout, Layout::SIZE_DEFINED_LAYOUTS, true); } /* * Insert a sizer element if one is required. * * @param Document $document DOM document to add a sizer to. * @param DOMElement $element Element to add a sizer to. * @param string $layout Calculated layout of the element. * @param CssLength $width Calculated width of the element. * @param CssLength $height Calculated height of the element. / private function maybeAddSizerInto( Document $document, DOMElement $element, $layout, CssLength $width, CssLength $height ) { if ( ! $width->isDefined() \|\| $this->isZero($width->getNumeral()) \|\| ! $height->isDefined() \|\| $width->getUnit() !== $height->getUnit() ) { return; } $sizer = null; if ($layout === Layout::RESPONSIVE) { $elementId = $element->getAttribute(Attribute::ID); if (!empty($elementId) && array_key_exists($elementId, $this->customSizerStyles)) { $sizer = $this->createResponsiveSizer($document, $width, $height, $this->customSizerStyles[$elementId]); } else { $sizer = $this->createResponsiveSizer($document, $width, $height); } } elseif ($layout === Layout::INTRINSIC) { $sizer = $this->createIntrinsicSizer($document, $width, $height); } if ($sizer) { $element->insertBefore($sizer, $element->firstChild); } } /* * Create a sizer element for a responsive layout. * * @param Document $document DOM document to create the sizer for. * @param CssLength $width Calculated width of the element. * @param CssLength $height Calculated height of the element. * @param string $style Style to use for the sizer. Defaults to padding-top in percentage. * @return DOMElement / private function createResponsiveSizer( Document $document, CssLength $width, CssLength $height, $style = 'padding-top:%1.4F%%;' ) { $padding = $height->getNumeral() / $width->getNumeral() 100; $sizer = $document->createElement(Amp::SIZER_ELEMENT); $style = empty($style) ? 'display:block' : "display:block;{$style}"; $sizer->setAttribute(Tag::STYLE, sprintf($style, $padding)); return $sizer; } /** * Create a sizer element for an intrinsic layout. * * Intrinsic uses an svg inside the sizer element rather than the padding trick. * Note: a naked svg won't work because other things expect the i-amphtml-sizer element. * * @param Document $document DOM document to create the sizer for. * @param CssLength $width Calculated width of the element. * @param CssLength $height Calculated height of the element. * @return DOMElement / private function createIntrinsicSizer(Document $document, CssLength $width, CssLength $height) { $sizer = $document->createElement(Amp::SIZER_ELEMENT); $sizer->setAttribute(Attribute::CLASS_, Amp::SIZER_ELEMENT); $sizer_img = $document->createElement(Tag::IMG); $sizer_img->setAttribute(Attribute::ALT, ''); $sizer_img->setAttribute(Attribute::ARIA_HIDDEN, 'true'); $sizer_img->setAttribute(Attribute::CLASS_, Amp::INTRINSIC_SIZER_ELEMENT); $sizer_img->setAttribute(Attribute::ROLE, Role::PRESENTATION); $sizer_img->setAttribute( Attribute::SRC, sprintf( 'data:image/svg+xml;base64,%s', base64_encode("<svg height='{$height->getNumeral()}' width='{$width->getNumeral()}' " . "xmlns='http://www.w3.org/2000/svg' version='1.1'/>") ) ); $sizer->appendChild($sizer_img); return $sizer; } /* * Check whether the element is within a template. * * @param DOMElement $element Element to check. * @return bool Whether the element is within a template. / private function isWithinTemplate(DOMElement $element) { $parent = $element->parentNode; while ($parent !== null) { if ($parent instanceof DOMElement) { if ($parent->tagName === Tag::TEMPLATE) { return true; } if ($parent->tagName === Tag::SCRIPT && $parent->hasAttribute(Attribute::TEMPLATE)) { return true; } } $parent = $parent->parentNode; } return false; } /* * Check if the amp-experiment element is actually used. * * This checks if amp-experiment has one child that is a script/json tag with a textnode that is parsable JSON and * not empty. The validator ensures that the script/json is parsable but since transformers may be used outside of * validation it is checked here as well. * * @param DOMElement $element Element to check. * @return bool Whether the amp-experiment element is actually used. / private function isAmpExperimentUsed(DOMElement $element) { $script = null; $child = $element->firstChild; while ($child) { if ( $child instanceof DOMElement && $child->tagName === Tag::SCRIPT && strtolower($child->getAttribute(Attribute::TYPE)) === Attribute::TYPE_JSON ) { $script = $child; break; } $child = $child->nextSibling; } // If not script/json tag, then not used. if ($script === null) { return false; } // If not exactly one child is present, then not used. if ($script->childNodes->length !== 1) { return false; } $child = $script->firstChild; // If child is not a text node or CDATA section, then not used. if ($child->nodeType !== XML_TEXT_NODE && $child->nodeType !== XML_CDATA_SECTION_NODE) { return false; } $json = $child->textContent; // If textnode is not JSON parsable, then not used. $experiment = json_decode($json, /$assoc/ true); if ($experiment === null) { return false; } // If JSON is empty, then not used. if (empty($experiment)) { return false; } // Otherwise, used. return true; } /* * Adapt blocking attributes so that they allow for boilerplate removal. * * Blocking attributes that need special attention are `sizes`, `heights` and `media`. * * @see https://github.com/ampproject/amp-wp/issues/4439 * * @param Document $document DOM document to apply the transformations to. * @param DOMElement $ampElement Element to adapt. * @param ErrorCollection $errors Collection of errors that are collected during transformation. * @return string[]\|false Attribute names to remove, or false if attributes could not be adapted. / private function adaptBlockingAttributes(Document $document, DOMElement $ampElement, ErrorCollection $errors) { $attributes = $ampElement->attributes; $customCss = []; $attributesToRemove = []; foreach ($attributes as $attribute) { /* * Attribute to check. * * @var DOMAttr $attribute / $normalizedAttributeName = strtolower($attribute->name); try { switch ($normalizedAttributeName) { case Attribute::SIZES: if ($ampElement->hasAttribute(Attribute::DISABLE_INLINE_WIDTH)) { // Don't remove sizes when disable-inline-width is set. // @see https://github.com/ampproject/amphtml/pull/27083 break; } $customCss = array_merge( $customCss, $this->extractSizesAttributeCss($document, $ampElement, $attribute) ); $attributesToRemove[] = $attribute->name; break; case Attribute::HEIGHTS: $customCss = array_merge( $customCss, $this->extractHeightsAttributeCss($document, $ampElement, $attribute) ); $attributesToRemove[] = $attribute->name; break; case Attribute::MEDIA: $customCss = array_merge( $customCss, $this->extractMediaAttributeCss($document, $ampElement, $attribute) ); $attributesToRemove[] = $attribute->name; break; } } catch (Exception $exception) { $errors->add(Error\CannotRemoveBoilerplate::fromAttributeThrowingException($exception)); return false; } } if (!empty($customCss) && ! $this->checkCustomCssSize($document, $customCss)) { $errors->add(Error\CannotRemoveBoilerplate::fromAttributesRequiringBoilerplate($ampElement)); return false; } // The custom CSS seems to fit within the byte count limit, so let's add it to the document. foreach ($customCss as $cssRule) { $this->customCss = $this->customCss->add($cssRule); } return $attributesToRemove; } /* * Check whether adding a custom CSS rule still fits within the CSS byte limit of the document. * * @param Document $document Document to check the custom CSS size of. * @param CssRule[] $cssRules CSS rules that are meant to be added. * @return bool Whether the custom CSS rule still fits within the byte limits. / private function checkCustomCssSize(Document $document, $cssRules) { $additionalBytes = $this->customCss->getByteCount(); foreach ($cssRules as $cssRule) { $additionalBytes += $cssRule->getByteCount(); } if ($this->ampCustomCssByteCount + $additionalBytes > self::MAX_CSS_BYTE_COUNT) { return false; } if (empty($this->ampCustomStyleElement)) { $ampCustomStyleElement = $document->xpath->query(self::STYLE_AMP_CUSTOM_XPATH, $document->head)->item(0); if ($ampCustomStyleElement instanceof DOMElement) { $this->ampCustomStyleElement = $ampCustomStyleElement; $this->ampCustomCssByteCount = (new CssByteCountCalculator($document))->calculate(); if (($this->ampCustomCssByteCount + $additionalBytes) > self::MAX_CSS_BYTE_COUNT) { return false; } } else { $ampCustomStyleElement = $document->createElement(Tag::STYLE); $ampCustomStyleElement->setAttribute(Attribute::AMP_CUSTOM, null); $this->ampCustomStyleElement = $ampCustomStyleElement; $document->head->appendChild($this->ampCustomStyleElement); } } return true; } /* * Render the custom CSS styling into the document. * * @param Document $document Document to add the custom CSS styling to. / private function renderCustomCss(Document $document) { $customCss = $this->customCss->getCss(); if (empty($customCss)) { return; } // Inject new styles before any potential source map annotation comment like: /# sourceURL=amp-custom.css /. // If not present, then just put it at the end of the stylesheet. This isn't strictly required, but putting the // source map comments at the end is the convention. $this->ampCustomStyleElement->textContent = preg_replace( ':(?=\s+/\#[^]+?\/\s$\|$):s', $customCss, $this->ampCustomStyleElement->textContent, 1 ); $this->ampCustomCssByteCount += $this->customCss->getByteCount(); } /* * Extract the custom CSS styling from a 'sizes' attribute. * * __sizes__ * "One or more strings separated by commas, indicating a set of source sizes. Each source size consists of: * - A media condition. This must be omitted for the last item in the list. * - A source size value." * * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/img#attr-sizes * * @param Document $document Document containing the element to adapt. * @param DOMElement $element Element to adapt. * @param DOMAttr $attribute Attribute to be extracted. * @return CssRule[] Extract custom CSS styling. / private function extractSizesAttributeCss(Document $document, DOMElement $element, DOMAttr $attribute) { if (!$element->hasAttribute(Attribute::SRCSET) \|\| empty($element->getAttribute(Attribute::SRCSET))) { // According to the Mozilla docs, a sizes attribute without a valid srcset attribute should have no effect. // Therefore, it should simply be stripped, without producing media queries. // @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/img#attr-sizes return []; } return $this->extractAttributeCss( $document, $element, $attribute, ['#__ID__', 'width:%s'], ['@media %s', '#__ID__', 'width:%s'] ); } /* * Extract the custom CSS styling from a 'heights' attribute. * * __heights__ (AMP-specific) * "The value of this attribute is a sizes expression based on media expressions, similar to the sizes attribute on * img tags but with two key differences: * - The value applies to the height, not the width of the element. * - Percent values are allowed. A percent value indicates the percent of the element's width. For example, a value * of 80% indicates that the height of the element will be 80% of the element's width." * * @see https://amp.dev/documentation/guides-and-tutorials/learn/common_attributes/#heights * * @param Document $document Document containing the element to adapt. * @param DOMElement $element Element to adapt. * @param DOMAttr $attribute Attribute to be extracted. * @return CssRule[] Extract custom CSS styling. / private function extractHeightsAttributeCss(Document $document, DOMElement $element, DOMAttr $attribute) { $this->customSizerStyles[$document->getElementId($element)] = ''; return $this->extractAttributeCss( $document, $element, $attribute, ['#__ID__>:first-child', 'padding-top:%s'], ['@media %s', '#__ID__>:first-child', 'padding-top:%s'] ); } /* * Extract the custom CSS styling from an attribute and turn into a templated CSS style string. * * @param Document $document Document containing the element to adapt. * @param DOMElement $element Element to adapt. * @param DOMAttr $attribute Attribute to be extracted. * @param string[] $mainStyle CSS rule template for the main style. * @param string[] $mediaQueryStyle CSS rule template for a media query style. * @return CssRule[] Array of CSS rules to use. / private function extractAttributeCss( Document $document, DOMElement $element, DOMAttr $attribute, $mainStyle, $mediaQueryStyle ) { if (empty($attribute->nodeValue)) { return []; } $sourceSizes = explode(',', $attribute->nodeValue); $lastItem = trim(array_pop($sourceSizes), self::CSS_TRIM_CHARACTERS); if (empty($lastItem)) { throw InvalidHtmlAttribute::fromAttribute($attribute->nodeName, $element); } $cssRules = []; $cssRules[] = new CssRule($mainStyle[0], sprintf($mainStyle[1], $lastItem)); foreach (array_reverse($sourceSizes) as $sourceSize) { $matches = []; if (!preg_match(self::CSS_DIMENSION_WITH_MEDIA_CONDITION_REGEX_PATTERN, $sourceSize, $matches)) { throw InvalidHtmlAttribute::fromAttribute($attribute->nodeName, $element); } $mediaCondition = trim($matches['media_condition'], self::CSS_TRIM_CHARACTERS); if (empty($mediaCondition)) { throw InvalidHtmlAttribute::fromAttribute($attribute->nodeName, $element); } $dimension = trim($matches['dimension'], self::CSS_TRIM_CHARACTERS); if (empty($dimension)) { throw InvalidHtmlAttribute::fromAttribute($attribute->nodeName, $element); } $cssRules[] = CssRule::withMediaQuery( sprintf($mediaQueryStyle[0], $mediaCondition), $mediaQueryStyle[1], sprintf($mediaQueryStyle[2], $dimension) ); } $elementId = $document->getElementId($element); $cssRules = array_map( static function (CssRule $cssRule) use ($elementId) { return $cssRule->applyID($elementId); }, $cssRules ); return $cssRules; } /* * Extract the custom CSS styling from a 'media' attribute. * * __media__ * "The value of media is a media query. If the query does not match, the element is not rendered and its resources * and potentially its child resources will not be fetched. If the browser window changes size or orientation, the * media queries are re-evaluated and elements are hidden and shown based on the new results." * * @param Document $document Document containing the element to adapt. * @param DOMElement $element Element to adapt. * @param DOMAttr $attribute Attribute to be extracted. * @return CssRule[] Extract custom CSS styling. / private function extractMediaAttributeCss(Document $document, DOMElement $element, DOMAttr $attribute) { $attributeValue = trim($attribute->nodeValue, self::CSS_TRIM_CHARACTERS); if (empty($attributeValue)) { return []; } $notFound = 0; $attributeValue = preg_replace('/^not\s+/i', '', $attributeValue, 1, $notFound); $not = $notFound ? '' : 'not '; if ($attributeValue[0] === '(' && ! $notFound) { // 'not' can only be used with a media type, so we use 'all' as media type if it is missing. // See quirksmode.org/blog/archives/2012/11/what_the_hells.html#c15586 $attributeValue = 'all and ' . $attributeValue; } return [ CssRule::withMediaQuery("@media {$not}{$attributeValue}", '#__ID__', 'display:none') ->applyID($document->getElementId($element)), ]; } /* * Check whether a given element should be excluded from applying its layout on the server. * * @param DOMElement $element Element to check. * @return bool Whether to exclude the element or not. / private function isExcludedElement(DOMElement $element) { return in_array($element->tagName, self::EXCLUDED_ELEMENTS, true); } /* * Check if a number is zero. * * This works correctly with both integer and float values. * * @param int\|float $number Number to check for zero. * @return bool Whether the provided number is zero. * @throws InvalidArgument When an unsupported number type is provided. */ private function isZero($number) { if (is_int($number)) { return $number === 0; } if (!is_float($number)) { throw InvalidArgument::forNumericComparison($number); } return abs($number) < self::FLOATING_POINT_EPSILON; } }

| ver. 1.4 | Github | . | PHP 7.3.33 | Generation time: 0.07 | proxy | phpinfo | Settings