function DrupalAspectsOfCKEditor5Plugin::__construct

Same name in other branches
  1. 10 core/modules/ckeditor5/src/Attribute/DrupalAspectsOfCKEditor5Plugin.php \Drupal\ckeditor5\Attribute\DrupalAspectsOfCKEditor5Plugin::__construct()

Constructs a DrupalAspectsOfCKEditor5Plugin attribute.

Parameters

string|\Drupal\Core\StringTranslation\TranslatableMarkup|null $label: (optional) The human-readable name of the CKEditor plugin. Required unless set by deriver.

class-string $class: (optional) The CKEditor 5 plugin class.If not specified, the CKEditor5PluginDefault class is used.

string|false $library: (optional) The library this plugin requires.

string|false $admin_library: (optional) The admin library this plugin provides.

string[]|false|null $elements: (optional) List of elements and attributes provided. An array of strings, or false if no elements are provided. Required unless set by deriver. Syntax for each array value:

  • <element> only allows that HTML element with no attributes
  • <element attrA attrB> only allows that HTML element with attributes attrA and attrB, and any value for those attributes.
  • <element attrA="foo bar baz" attrB="qux-*"> only allows that HTML element with attributes attrA (if attrA contains one of the three listed values) and attrB (if its value has the provided prefix).
  • <element data-*> only allows that HTML element with any attribute that has the given prefix.

Note that <element> means such an element (tag) can be created, whereas <element attrA attrB> means that `attrA` and `attrB` can be created on the tag. If a plugin supports both creating the element as well as setting some attributes or attribute values on it, it should have distinct entries in the list. For example, for a link plugin: `<a>` and `<a href>`. The first indicates the plugin can create such tags, the second indicates it can set the `href` attribute on it. If the first were omitted, the Drupal CKEditor 5 module would interpret that as "this plugin cannot create `<a>`, it can only set the `href` attribute on it".

array $toolbar_items: (optional) List of toolbar items the plugin provides.

array|false $conditions: (optional) List of conditions to enable this plugin.

class-string|null $deriver: (optional) The deriver class.

Overrides Plugin::__construct

See also

\Drupal\ckeditor5\Plugin\CKEditor5PluginDefinition::getCreatableElements()

File

core/modules/ckeditor5/src/Attribute/DrupalAspectsOfCKEditor5Plugin.php, line 58

Class

DrupalAspectsOfCKEditor5Plugin

Namespace

Drupal\ckeditor5\Attribute

Code

public function __construct(string|TranslatableMarkup|null $label = NULL, string $class = CKEditor5PluginDefault::class, string|false $library = FALSE, string|false $admin_library = FALSE, array|false|null $elements = NULL, array $toolbar_items = [], array|false $conditions = FALSE, ?string $deriver = NULL) {
}

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