function CKEditor5::buildConfigurationForm

Same name in other branches
  1. 9 core/modules/ckeditor5/src/Plugin/Editor/CKEditor5.php \Drupal\ckeditor5\Plugin\Editor\CKEditor5::buildConfigurationForm()
  2. 11.x core/modules/ckeditor5/src/Plugin/Editor/CKEditor5.php \Drupal\ckeditor5\Plugin\Editor\CKEditor5::buildConfigurationForm()

Overrides EditorBase::buildConfigurationForm

File

core/modules/ckeditor5/src/Plugin/Editor/CKEditor5.php, line 262

Class

CKEditor5
Defines a CKEditor 5-based text editor for Drupal.

Namespace

Drupal\ckeditor5\Plugin\Editor

Code

public function buildConfigurationForm(array $form, FormStateInterface $form_state) {
    $editor = $form_state->get('editor');
    assert($editor instanceof EditorEntity);
    $language = $this->languageManager
        ->getCurrentLanguage();
    // When enabling CKEditor 5, generate sensible settings from the
    // pre-existing text editor/format rather than the hardcoded defaults
    // whenever possible.
    // @todo Remove after https://www.drupal.org/project/drupal/issues/3226673.
    $format = $form_state->getFormObject()
        ->getEntity();
    assert($format instanceof FilterFormatInterface);
    if ($editor->isNew() && !$form_state->get('ckeditor5_is_active') && $form_state->get('ckeditor5_is_selected')) {
        assert($editor->getSettings() === $this->getDefaultSettings());
        if (!$format->isNew()) {
            [
                $editor,
                $messages,
            ] = $this->smartDefaultSettings
                ->computeSmartDefaultSettings($editor, $format);
            $form_state->set('used_smart_default_settings', TRUE);
            foreach ($messages as $type => $messages_per_type) {
                foreach ($messages_per_type as $message) {
                    $this->messenger()
                        ->addMessage($message, $type);
                }
            }
            if (isset($messages[MessengerInterface::TYPE_WARNING]) || isset($messages[MessengerInterface::TYPE_ERROR])) {
                $this->messenger()
                    ->addMessage($this->t('Check <a href=":handbook">this handbook page</a> for details about compatibility issues of contrib modules.', [
                    ':handbook' => 'https://www.drupal.org/node/3273985',
                ]), MessengerInterface::TYPE_WARNING);
            }
        }
        $eventual_editor_and_format = $this->getEventualEditorWithPrimedFilterFormat($form_state, $editor);
        // Provide the validated eventual pair in form state to
        // ::getGeneratedAllowedHtmlValue(), to update filter_html's
        // "allowed_html".
        $form_state->set('ckeditor5_validated_pair', $eventual_editor_and_format);
        // Ensure that CKEditor 5 plugins that need to interact with the Editor
        // config entity are able to access the computed Editor, which was cloned
        // from $form_state->get('editor').
        // @see \Drupal\ckeditor5\Plugin\CKEditor5Plugin\Image::buildConfigurationForm
        $form_state->set('editor', $editor);
    }
    if ($css_warning = $this->stylesheetsMessage
        ->getWarning()) {
        // Explicitly render this single warning message visually close to the
        // text editor since this is a very long form. Otherwise, it may be
        // interpreted as a text format problem, or ignored entirely.
        // All other messages will be rendered in the default location.
        // @see \Drupal\Core\Render\Element\StatusMessages
        $form['css_warning'] = [
            '#theme' => 'status_messages',
            '#message_list' => [
                'warning' => [
                    $css_warning,
                ],
            ],
            '#status_headings' => [
                'warning' => $this->t('Warning message'),
            ],
        ];
    }
    // AJAX validation errors should appear visually close to the text editor
    // since this is a very long form: otherwise they would not be noticed.
    $form['real_time_validation_errors_location'] = [
        '#type' => 'container',
        '#id' => 'ckeditor5-realtime-validation-messages-container',
    ];
    $form['toolbar'] = [
        '#type' => 'container',
        '#title' => $this->t('CKEditor 5 toolbar configuration'),
        '#theme' => 'ckeditor5_settings_toolbar',
        '#attached' => [
            'library' => $this->ckeditor5PluginManager
                ->getAdminLibraries(),
            'drupalSettings' => [
                'ckeditor5' => [
                    'language' => [
                        'dir' => $language->getDirection(),
                        'langcode' => $language->getId(),
                    ],
                ],
            ],
        ],
    ];
    $form['available_items_description'] = [
        '#type' => 'container',
        '#markup' => $this->t('Press the down arrow key to add to the toolbar.'),
        '#id' => 'available-button-description',
        '#attributes' => [
            'class' => [
                'visually-hidden',
            ],
        ],
    ];
    $form['active_items_description'] = [
        '#type' => 'container',
        '#markup' => $this->t('Move this button in the toolbar by pressing the left or right arrow keys. Press the up arrow key to remove from the toolbar.'),
        '#id' => 'active-button-description',
        '#attributes' => [
            'class' => [
                'visually-hidden',
            ],
        ],
    ];
    // The items are encoded in markup to provide a no-JS fallback.
    // Although CKEditor 5 is useless without JS it would still be possible
    // to see all the available toolbar items provided by plugins in the format
    // that needs to be entered in the textarea. The UI app parses this list.
    $form['toolbar']['available'] = [
        '#type' => 'container',
        '#title' => 'Available items',
        '#id' => 'ckeditor5-toolbar-buttons-available',
        'available_items' => [
            '#markup' => Json::encode($this->ckeditor5PluginManager
                ->getToolbarItems()),
        ],
    ];
    $editor_settings = $editor->getSettings();
    // This form field requires a JSON-style array of valid toolbar items.
    // e.g. ["bold","italic","|","drupalInsertImage"].
    // CKEditor 5 config for toolbar items takes an array of strings which
    // correspond to the keys under toolbar_items in a plugin yml or annotation.
    // @see https://ckeditor.com/docs/ckeditor5/latest/features/toolbar/toolbar.html
    $form['toolbar']['items'] = [
        '#type' => 'textarea',
        '#title' => $this->t('Toolbar items'),
        '#rows' => 1,
        '#default_value' => Json::encode($editor_settings['toolbar']['items']),
        '#id' => 'ckeditor5-toolbar-buttons-selected',
        '#attributes' => [
            'tabindex' => '-1',
            'aria-hidden' => 'true',
        ],
    ];
    $form['plugin_settings'] = [
        '#type' => 'vertical_tabs',
        '#title' => $this->t('CKEditor 5 plugin settings'),
        // Add an ID to the editor settings vertical tabs wrapper so it can be
        // easily targeted by JavaScript.
'#wrapper_attributes' => [
            'id' => 'plugin-settings-wrapper',
        ],
    ];
    $this->injectPluginSettingsForm($form, $form_state, $editor);
    // Allow reliable detection of switching to CKEditor 5 from another text
    // editor (or none at all).
    $form['is_already_using_ckeditor5'] = [
        '#type' => 'hidden',
        '#default_value' => TRUE,
    ];
    return $form;
}

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