function HTMLRestrictions::applyOperation
Same name in other branches
- 9 core/modules/ckeditor5/src/HTMLRestrictions.php \Drupal\ckeditor5\HTMLRestrictions::applyOperation()
- 10 core/modules/ckeditor5/src/HTMLRestrictions.php \Drupal\ckeditor5\HTMLRestrictions::applyOperation()
Applies an operation (difference/intersection/union) with wildcard support.
Parameters
\Drupal\ckeditor5\HTMLRestrictions $a: The first operand.
\Drupal\ckeditor5\HTMLRestrictions $b: The second operand.
string $operation_method_name: The name of the private method on this class to use as the operation.
Return value
\Drupal\ckeditor5\HTMLRestrictions The result of the operation.
2 calls to HTMLRestrictions::applyOperation()
- HTMLRestrictions::diff in core/
modules/ ckeditor5/ src/ HTMLRestrictions.php - Computes difference of two HTML restrictions, with wildcard support.
- HTMLRestrictions::intersect in core/
modules/ ckeditor5/ src/ HTMLRestrictions.php - Computes intersection of two HTML restrictions, with wildcard support.
File
-
core/
modules/ ckeditor5/ src/ HTMLRestrictions.php, line 1001
Class
- HTMLRestrictions
- Represents a set of HTML restrictions.
Namespace
Drupal\ckeditor5Code
private static function applyOperation(HTMLRestrictions $a, HTMLRestrictions $b, string $operation_method_name) : HTMLRestrictions {
// 1. Operation applied to wildcard tags that exist in both operands.
// For example: <$text-container id> in both operands.
$a_wildcard = $a->getWildcardSubset();
$b_wildcard = $b->getWildcardSubset();
$wildcard_op_result = $a_wildcard->{$operation_method_name}($b_wildcard);
// Early return if both operands contain only wildcard tags.
if (count($a_wildcard->elements) === count($a->elements) && count($b_wildcard->elements) === count($b->elements)) {
return $wildcard_op_result;
}
// 2. Operation applied with wildcard tags resolved into concrete tags.
// For example: <p class="text-align-center"> in the first operand and
// <$text-container class="text-align-center"> in the second
// operand.
$a_concrete = self::resolveWildcards($a);
$b_concrete = self::resolveWildcards($b);
$concrete_op_result = $a_concrete->{$operation_method_name}($b_concrete);
// Using the PHP array union operator is safe because the two operation
// result arrays ensure there is no overlap between the array keys.
// @codingStandardsIgnoreStart
assert(Inspector::assertAll(function ($t) {
return self::isWildcardTag($t);
}, array_keys($wildcard_op_result->elements)));
assert(Inspector::assertAll(function ($t) {
return !self::isWildcardTag($t);
}, array_keys($concrete_op_result->elements)));
// @codingStandardsIgnoreEnd
return new self($concrete_op_result->elements + $wildcard_op_result->elements);
}
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.