ListPlugin.php

Same filename in other branches
  1. 9 core/modules/ckeditor5/src/Plugin/CKEditor5Plugin/ListPlugin.php
  2. 11.x core/modules/ckeditor5/src/Plugin/CKEditor5Plugin/ListPlugin.php

Namespace

Drupal\ckeditor5\Plugin\CKEditor5Plugin

File

core/modules/ckeditor5/src/Plugin/CKEditor5Plugin/ListPlugin.php

View source
<?php

declare (strict_types=1);
namespace Drupal\ckeditor5\Plugin\CKEditor5Plugin;

use Drupal\ckeditor5\Plugin\CKEditor5PluginConfigurableInterface;
use Drupal\ckeditor5\Plugin\CKEditor5PluginConfigurableTrait;
use Drupal\ckeditor5\Plugin\CKEditor5PluginDefault;
use Drupal\ckeditor5\Plugin\CKEditor5PluginElementsSubsetInterface;
use Drupal\Core\Form\FormStateInterface;
use Drupal\editor\EditorInterface;

/**
 * CKEditor 5 List plugin.
 *
 * @internal
 *   Plugin classes are internal.
 */
class ListPlugin extends CKEditor5PluginDefault implements CKEditor5PluginConfigurableInterface, CKEditor5PluginElementsSubsetInterface {
    use CKEditor5PluginConfigurableTrait;
    
    /**
     * {@inheritdoc}
     */
    public function defaultConfiguration() {
        return [
            'properties' => [
                'reversed' => TRUE,
                'startIndex' => TRUE,
            ],
            'multiBlock' => TRUE,
        ];
    }
    
    /**
     * {@inheritdoc}
     */
    public function buildConfigurationForm(array $form, FormStateInterface $form_state) {
        $form['reversed'] = [
            '#type' => 'checkbox',
            '#title' => $this->t('Allow the user to reverse an ordered list'),
            '#default_value' => $this->configuration['properties']['reversed'],
        ];
        $form['startIndex'] = [
            '#type' => 'checkbox',
            '#title' => $this->t('Allow the user to specify the start index of an ordered list'),
            '#default_value' => $this->configuration['properties']['startIndex'],
        ];
        $form['multiBlock'] = [
            '#type' => 'checkbox',
            '#title' => $this->t('Allow the user to create paragraphs in list items (or other block elements)'),
            '#default_value' => $this->configuration['multiBlock'],
        ];
        return $form;
    }
    
    /**
     * {@inheritdoc}
     */
    public function validateConfigurationForm(array &$form, FormStateInterface $form_state) {
        $form_value = $form_state->getValue('reversed');
        $form_state->setValue('reversed', (bool) $form_value);
        $form_value = $form_state->getValue('startIndex');
        $form_state->setValue('startIndex', (bool) $form_value);
        $form_value = $form_state->getValue('multiBlock');
        $form_state->setValue('multiBlock', (bool) $form_value);
    }
    
    /**
     * {@inheritdoc}
     */
    public function submitConfigurationForm(array &$form, FormStateInterface $form_state) {
        $this->configuration['properties']['reversed'] = $form_state->getValue('reversed');
        $this->configuration['properties']['startIndex'] = $form_state->getValue('startIndex');
        $this->configuration['multiBlock'] = $form_state->getValue('multiBlock');
    }
    
    /**
     * {@inheritdoc}
     */
    public function getDynamicPluginConfig(array $static_plugin_config, EditorInterface $editor) : array {
        $static_plugin_config['list']['properties'] = $this->getConfiguration()['properties'] + $static_plugin_config['list']['properties'];
        $static_plugin_config['list']['multiBlock'] = $this->getConfiguration()['multiBlock'];
        return $static_plugin_config;
    }
    
    /**
     * {@inheritdoc}
     */
    public function getElementsSubset() : array {
        $subset = $this->getPluginDefinition()
            ->getElements();
        $subset = array_diff($subset, [
            '<ol reversed start>',
        ]);
        $reversed_enabled = $this->getConfiguration()['properties']['reversed'];
        $start_index_enabled = $this->getConfiguration()['properties']['startIndex'];
        $subset[] = "<ol" . ($reversed_enabled ? ' reversed' : '') . ($start_index_enabled ? ' start' : '') . '>';
        return $subset;
    }

}

Classes

Title Deprecated Summary
ListPlugin CKEditor 5 List plugin.

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