class ColorButton in CKEditor Color Button 8
Defines the "colorbutton" plugin.
Plugin annotation
@CKEditorPlugin(
id = "colorbutton",
label = @Translation("CKEditor Color Button")
)
Hierarchy
- class \Drupal\Component\Plugin\PluginBase implements DerivativeInspectionInterface, PluginInspectionInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
- class \Drupal\ckeditor\CKEditorPluginBase implements CKEditorPluginButtonsInterface, CKEditorPluginInterface
- class \Drupal\colorbutton\Plugin\CKEditorPlugin\ColorButton implements CKEditorPluginConfigurableInterface
- class \Drupal\ckeditor\CKEditorPluginBase implements CKEditorPluginButtonsInterface, CKEditorPluginInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
Expanded class hierarchy of ColorButton
File
- src/
Plugin/ CKEditorPlugin/ ColorButton.php, line 18
Namespace
Drupal\colorbutton\Plugin\CKEditorPluginView source
class ColorButton extends CKEditorPluginBase implements CKEditorPluginConfigurableInterface {
/**
* Get path to library folder.
*/
public function getLibraryPath() {
// @todo Remove backward compatibility conditions when we bump Drupal
// requirement to 8.9.0. See https://www.drupal.org/node/3099614
if (\Drupal::hasService('library.libraries_directory_file_finder')) {
/** @var \Drupal\Core\Asset\LibrariesDirectoryFileFinder $library_file_finder */
$path = \Drupal::service('library.libraries_directory_file_finder')
->find('colorbutton');
}
elseif (\Drupal::moduleHandler()
->moduleExists('libraries')) {
$path = libraries_get_path('colorbutton');
}
else {
$path = 'libraries/colorbutton';
}
return $path;
}
/**
* {@inheritdoc}
*/
public function getDependencies(Editor $editor) {
return [
'panelbutton',
];
}
/**
* {@inheritdoc}
*/
public function getFile() {
return $this
->getLibraryPath() . '/plugin.js';
}
/**
* {@inheritdoc}
*/
public function getConfig(Editor $editor) {
$settings = $editor
->getSettings();
// enableMore can only be supported if the Color Dialog plugin is present.
$config = [
'colorButton_enableMore' => FALSE,
'colorButton_enableAutomatic' => TRUE,
];
if (!empty($settings['plugins']['colorbutton']['colors'])) {
$config['colorButton_colors'] = $settings['plugins']['colorbutton']['colors'];
}
return $config;
}
/**
* {@inheritdoc}
*/
public function getButtons() {
$path = $this
->getLibraryPath();
return [
'TextColor' => [
'label' => $this
->t('Text Color'),
'image' => $path . '/icons/textcolor.png',
],
'BGColor' => [
'label' => $this
->t('Background Color'),
'image' => $path . '/icons/bgcolor.png',
],
];
}
/**
* {@inheritdoc}
*/
public function settingsForm(array $form, FormStateInterface $form_state, Editor $editor) {
$settings = $editor
->getSettings();
$form['colors'] = [
'#type' => 'textarea',
'#title' => $this
->t('Text Colors'),
'#description' => $this
->t('Enter the hex values of all colors you would like to support (without the # symbol) separated by a comma. Leave blank to use the default colors for Color Button.'),
'#default_value' => !empty($settings['plugins']['colorbutton']['colors']) ? $settings['plugins']['colorbutton']['colors'] : '',
];
$form['colors']['#element_validate'][] = [
$this,
'validateInput',
];
return $form;
}
/**
* Ensure values entered for color hex values contain no unsafe characters.
* @param $element
* @param \Drupal\Core\Form\FormStateInterface $form_state
*/
public function validateInput(array $element, FormStateInterface $form_state) {
$input = $form_state
->getValue([
'editor',
'settings',
'plugins',
'colorbutton',
'colors',
]);
if (preg_match('/([^A-F0-9,])/i', $input)) {
$form_state
->setError($element, 'Only valid hex values are allowed (A-F, 0-9). No other symbols or letters are allowed. Please check your settings and try again.');
}
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
CKEditorPluginBase:: |
public | function |
Returns a list of libraries this plugin requires. Overrides CKEditorPluginInterface:: |
4 |
CKEditorPluginBase:: |
public | function |
Indicates if this plugin is part of the optimized CKEditor build. Overrides CKEditorPluginInterface:: |
4 |
ColorButton:: |
public | function |
Returns the buttons that this plugin provides, along with metadata. Overrides CKEditorPluginButtonsInterface:: |
|
ColorButton:: |
public | function |
Returns the additions to CKEDITOR.config for a specific CKEditor instance. Overrides CKEditorPluginInterface:: |
|
ColorButton:: |
public | function |
Returns a list of plugins this plugin requires. Overrides CKEditorPluginBase:: |
|
ColorButton:: |
public | function |
Returns the Drupal root-relative file path to the plugin JavaScript file. Overrides CKEditorPluginInterface:: |
|
ColorButton:: |
public | function | Get path to library folder. | |
ColorButton:: |
public | function |
Returns a settings form to configure this CKEditor plugin. Overrides CKEditorPluginConfigurableInterface:: |
|
ColorButton:: |
public | function | Ensure values entered for color hex values contain no unsafe characters. | |
DependencySerializationTrait:: |
protected | property | An array of entity type IDs keyed by the property name of their storages. | |
DependencySerializationTrait:: |
protected | property | An array of service IDs keyed by property name used for serialization. | |
DependencySerializationTrait:: |
public | function | 1 | |
DependencySerializationTrait:: |
public | function | 2 | |
MessengerTrait:: |
protected | property | The messenger. | 29 |
MessengerTrait:: |
public | function | Gets the messenger. | 29 |
MessengerTrait:: |
public | function | Sets the messenger. | |
PluginBase:: |
protected | property | Configuration information passed into the plugin. | 1 |
PluginBase:: |
protected | property | The plugin implementation definition. | 1 |
PluginBase:: |
protected | property | The plugin_id. | |
PluginBase:: |
constant | A string which is used to separate base plugin IDs from the derivative ID. | ||
PluginBase:: |
public | function |
Gets the base_plugin_id of the plugin instance. Overrides DerivativeInspectionInterface:: |
|
PluginBase:: |
public | function |
Gets the derivative_id of the plugin instance. Overrides DerivativeInspectionInterface:: |
|
PluginBase:: |
public | function |
Gets the definition of the plugin implementation. Overrides PluginInspectionInterface:: |
3 |
PluginBase:: |
public | function |
Gets the plugin_id of the plugin instance. Overrides PluginInspectionInterface:: |
|
PluginBase:: |
public | function | Determines if the plugin is configurable. | |
PluginBase:: |
public | function | Constructs a \Drupal\Component\Plugin\PluginBase object. | 92 |
StringTranslationTrait:: |
protected | property | The string translation service. | 1 |
StringTranslationTrait:: |
protected | function | Formats a string containing a count of items. | |
StringTranslationTrait:: |
protected | function | Returns the number of plurals supported by a given language. | |
StringTranslationTrait:: |
protected | function | Gets the string translation service. | |
StringTranslationTrait:: |
public | function | Sets the string translation service to use. | 2 |
StringTranslationTrait:: |
protected | function | Translates a string to the current language or to a given language. |