@ckeditor/ckeditor5-ui 47.6.1 → 48.0.0-alpha.1

package/src/colorselector/colorgridsfragmentview.js

@@ -1,368 +0,0 @@
-/**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
-/**
- * @module ui/colorselector/colorgridsfragmentview
- */
-import { View } from '../view.js';
-import { ButtonView } from '../button/buttonview.js';
-import { ColorGridView } from '../colorgrid/colorgridview.js';
-import { ColorTileView } from '../colorgrid/colortileview.js';
-import { Template } from '../template.js';
-import { DocumentColorCollection } from './documentcolorcollection.js';
-import { IconEraser, IconColorPalette } from '@ckeditor/ckeditor5-icons';
-/**
- * One of the fragments of {@link module:ui/colorselector/colorselectorview~ColorSelectorView}.
- *
- * It provides a UI that allows users to select colors from the a predefined set and from existing document colors.
- *
- * It consists of the following sub–components:
- *
- * * A "Remove color" button,
- * * A static {@link module:ui/colorgrid/colorgridview~ColorGridView} of colors defined in the configuration,
- * * A dynamic {@link module:ui/colorgrid/colorgridview~ColorGridView} of colors used in the document.
- * * If color picker is configured, the "Color Picker" button is visible too.
- */
-export class ColorGridsFragmentView extends View {
-    /**
-     * A collection of the children of the table.
-     */
-    items;
-    /**
-     * An array with objects representing colors to be displayed in the grid.
-     */
-    colorDefinitions;
-    /**
-     * Tracks information about the DOM focus in the list.
-     */
-    focusTracker;
-    /**
-     * The number of columns in the color grid.
-     */
-    columns;
-    /**
-     * Preserves the reference to {@link module:ui/colorselector/documentcolorcollection~DocumentColorCollection} used to collect
-     * definitions that store the document colors.
-     *
-     * @readonly
-     */
-    documentColors;
-    /**
-     * The maximum number of colors in the document colors section.
-     * If it equals 0, the document colors section is not added.
-     *
-     * @readonly
-     */
-    documentColorsCount;
-    /**
-     * Preserves the reference to {@link module:ui/colorgrid/colorgridview~ColorGridView} used to create
-     * the default (static) color set.
-     *
-     * The property is loaded once the the parent dropdown is opened the first time.
-     *
-     * @readonly
-     */
-    staticColorsGrid;
-    /**
-     * Preserves the reference to {@link module:ui/colorgrid/colorgridview~ColorGridView} used to create
-     * the document colors. It remains undefined if the document colors feature is disabled.
-     *
-     * The property is loaded once the the parent dropdown is opened the first time.
-     *
-     * @readonly
-     */
-    documentColorsGrid;
-    /**
-     * The "Color picker" button view.
-     */
-    colorPickerButtonView;
-    /**
-     * The "Remove color" button view.
-     */
-    removeColorButtonView;
-    /**
-     * A collection of views that can be focused in the view.
-     *
-     * @readonly
-     */
-    _focusables;
-    /**
-     * Document color section's label.
-     *
-     * @readonly
-     */
-    _documentColorsLabel;
-    /**
-     * The label of the button responsible for removing color attributes.
-     */
-    _removeButtonLabel;
-    /**
-     * The label of the button responsible for switching to the color picker component.
-     */
-    _colorPickerLabel;
-    /**
-     * Creates an instance of the view.
-     *
-     * @param locale The localization services instance.
-     * @param options Constructor options.
-     * @param options.colors An array with definitions of colors to be displayed in the table.
-     * @param options.columns The number of columns in the color grid.
-     * @param options.removeButtonLabel The label of the button responsible for removing the color.
-     * @param options.colorPickerLabel The label of the button responsible for color picker appearing.
-     * @param options.documentColorsLabel The label for the section with the document colors.
-     * @param options.documentColorsCount The number of colors in the document colors section inside the color dropdown.
-     * @param options.focusTracker Tracks information about the DOM focus in the list.
-     * @param options.focusables A collection of views that can be focused in the view.
-     */
-    constructor(locale, { colors, columns, removeButtonLabel, documentColorsLabel, documentColorsCount, colorPickerLabel, focusTracker, focusables }) {
-        super(locale);
-        const bind = this.bindTemplate;
-        this.set('isVisible', true);
-        this.focusTracker = focusTracker;
-        this.items = this.createCollection();
-        this.colorDefinitions = colors;
-        this.columns = columns;
-        this.documentColors = new DocumentColorCollection();
-        this.documentColorsCount = documentColorsCount;
-        this._focusables = focusables;
-        this._removeButtonLabel = removeButtonLabel;
-        this._colorPickerLabel = colorPickerLabel;
-        this._documentColorsLabel = documentColorsLabel;
-        this.setTemplate({
-            tag: 'div',
-            attributes: {
-                class: [
-                    'ck-color-grids-fragment',
-                    bind.if('isVisible', 'ck-hidden', value => !value)
-                ]
-            },
-            children: this.items
-        });
-        this.removeColorButtonView = this._createRemoveColorButton();
-        this.items.add(this.removeColorButtonView);
-    }
-    /**
-     * Scans through the editor model and searches for text node attributes with the given attribute name.
-     * Found entries are set as document colors.
-     *
-     * All the previously stored document colors will be lost in the process.
-     *
-     * @param model The model used as a source to obtain the document colors.
-     * @param attributeName Determines the name of the related model's attribute for a given dropdown.
-     */
-    updateDocumentColors(model, attributeName) {
-        const document = model.document;
-        const maxCount = this.documentColorsCount;
-        this.documentColors.clear();
-        for (const root of document.getRoots()) {
-            const range = model.createRangeIn(root);
-            for (const node of range.getItems()) {
-                if (node.is('$textProxy') && node.hasAttribute(attributeName)) {
-                    this._addColorToDocumentColors(node.getAttribute(attributeName));
-                    if (this.documentColors.length >= maxCount) {
-                        return;
-                    }
-                }
-            }
-        }
-    }
-    /**
-     * Refreshes the state of the selected color in one or both {@link module:ui/colorgrid/colorgridview~ColorGridView}s
-     * available in the {@link module:ui/colorselector/colorselectorview~ColorSelectorView}. It guarantees that the selection will
-     * occur only in one of them.
-     */
-    updateSelectedColors() {
-        const documentColorsGrid = this.documentColorsGrid;
-        const staticColorsGrid = this.staticColorsGrid;
-        const selectedColor = this.selectedColor;
-        staticColorsGrid.selectedColor = selectedColor;
-        if (documentColorsGrid) {
-            documentColorsGrid.selectedColor = selectedColor;
-        }
-    }
-    /**
-     * @inheritDoc
-     */
-    render() {
-        super.render();
-        this.staticColorsGrid = this._createStaticColorsGrid();
-        this.items.add(this.staticColorsGrid);
-        if (this.documentColorsCount) {
-            // Create a label for document colors.
-            const bind = Template.bind(this.documentColors, this.documentColors);
-            const label = new View(this.locale);
-            label.setTemplate({
-                tag: 'span',
-                attributes: {
-                    class: [
-                        'ck',
-                        'ck-color-grid__label',
-                        bind.if('isEmpty', 'ck-hidden')
-                    ]
-                },
-                children: [
-                    {
-                        text: this._documentColorsLabel
-                    }
-                ]
-            });
-            this.items.add(label);
-            this.documentColorsGrid = this._createDocumentColorsGrid();
-            this.items.add(this.documentColorsGrid);
-        }
-        this._createColorPickerButton();
-        this._addColorSelectorElementsToFocusTracker();
-    }
-    /**
-     * Focuses the component.
-     */
-    focus() {
-        this.removeColorButtonView.focus();
-    }
-    /**
-     * @inheritDoc
-     */
-    destroy() {
-        super.destroy();
-    }
-    /**
-     * Handles displaying the color picker button (if it was previously created) and making it focusable.
-     */
-    addColorPickerButton() {
-        if (this.colorPickerButtonView) {
-            this.items.add(this.colorPickerButtonView);
-            this.focusTracker.add(this.colorPickerButtonView.element);
-            this._focusables.add(this.colorPickerButtonView);
-        }
-    }
-    /**
-     * Adds color selector elements to focus tracker.
-     */
-    _addColorSelectorElementsToFocusTracker() {
-        this.focusTracker.add(this.removeColorButtonView.element);
-        this._focusables.add(this.removeColorButtonView);
-        if (this.staticColorsGrid) {
-            this.focusTracker.add(this.staticColorsGrid.element);
-            this._focusables.add(this.staticColorsGrid);
-        }
-        if (this.documentColorsGrid) {
-            this.focusTracker.add(this.documentColorsGrid.element);
-            this._focusables.add(this.documentColorsGrid);
-        }
-    }
-    /**
-     * Creates the button responsible for displaying the color picker component.
-     */
-    _createColorPickerButton() {
-        this.colorPickerButtonView = new ButtonView();
-        this.colorPickerButtonView.set({
-            label: this._colorPickerLabel,
-            withText: true,
-            icon: IconColorPalette,
-            class: 'ck-color-selector__color-picker'
-        });
-        this.colorPickerButtonView.on('execute', () => {
-            this.fire('colorPicker:show');
-        });
-    }
-    /**
-     * Adds the remove color button as a child of the current view.
-     */
-    _createRemoveColorButton() {
-        const buttonView = new ButtonView();
-        buttonView.set({
-            withText: true,
-            icon: IconEraser,
-            label: this._removeButtonLabel
-        });
-        buttonView.class = 'ck-color-selector__remove-color';
-        buttonView.on('execute', () => {
-            this.fire('execute', {
-                value: null,
-                source: 'removeColorButton'
-            });
-        });
-        buttonView.render();
-        return buttonView;
-    }
-    /**
-     * Creates a static color grid based on the editor configuration.
-     */
-    _createStaticColorsGrid() {
-        const colorGrid = new ColorGridView(this.locale, {
-            colorDefinitions: this.colorDefinitions,
-            columns: this.columns
-        });
-        colorGrid.on('execute', (evt, data) => {
-            this.fire('execute', {
-                value: data.value,
-                source: 'staticColorsGrid'
-            });
-        });
-        return colorGrid;
-    }
-    /**
-     * Creates the document colors section view and binds it to {@link #documentColors}.
-     */
-    _createDocumentColorsGrid() {
-        const bind = Template.bind(this.documentColors, this.documentColors);
-        const documentColorsGrid = new ColorGridView(this.locale, {
-            columns: this.columns
-        });
-        documentColorsGrid.extendTemplate({
-            attributes: {
-                class: bind.if('isEmpty', 'ck-hidden')
-            }
-        });
-        documentColorsGrid.items.bindTo(this.documentColors).using(colorObj => {
-            const colorTile = new ColorTileView();
-            colorTile.set({
-                color: colorObj.color,
-                hasBorder: colorObj.options?.hasBorder
-            });
-            if (colorObj.label) {
-                colorTile.set({
-                    label: colorObj.label,
-                    tooltip: true
-                });
-            }
-            colorTile.on('execute', () => {
-                this.fire('execute', {
-                    value: colorObj.color,
-                    source: 'documentColorsGrid'
-                });
-            });
-            return colorTile;
-        });
-        // Selected color should be cleared when document colors became empty.
-        this.documentColors.on('change:isEmpty', (evt, name, val) => {
-            if (val) {
-                documentColorsGrid.selectedColor = null;
-            }
-        });
-        return documentColorsGrid;
-    }
-    /**
-     * Adds a given color to the document colors list. If possible, the method will attempt to use
-     * data from the {@link #colorDefinitions} (label, color options).
-     *
-     * @param color A string that stores the value of the recently applied color.
-     */
-    _addColorToDocumentColors(color) {
-        const predefinedColor = this.colorDefinitions
-            .find(definition => definition.color === color);
-        if (!predefinedColor) {
-            this.documentColors.add({
-                color,
-                label: color,
-                options: {
-                    hasBorder: false
-                }
-            });
-        }
-        else {
-            this.documentColors.add(Object.assign({}, predefinedColor));
-        }
-    }
-}

package/src/colorselector/colorpickerfragmentview.js

@@ -1,254 +0,0 @@
-/**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
-/**
- * @module ui/colorselector/colorpickerfragmentview
- */
-import { View } from '../view.js';
-import { ButtonView } from '../button/buttonview.js';
-import { ColorPickerView } from '../colorpicker/colorpickerview.js';
-import { IconCancel, IconCheck } from '@ckeditor/ckeditor5-icons';
-/**
- * One of the fragments of {@link module:ui/colorselector/colorselectorview~ColorSelectorView}.
- *
- * It allows users to select a color from a color picker.
- *
- * It consists of the following sub–components:
- *
- * * A color picker saturation and hue sliders,
- * * A text input accepting colors in HEX format,
- * * "Save" and "Cancel" action buttons.
- */
-export class ColorPickerFragmentView extends View {
-    /**
-     * A collection of component's children.
-     */
-    items;
-    /**
-     * A view with saturation and hue sliders and color input.
-     */
-    colorPickerView;
-    /**
-     * The "Save" button view.
-     */
-    saveButtonView;
-    /**
-     * The "Cancel" button view.
-     */
-    cancelButtonView;
-    /**
-     * The action bar where are "Save" button and "Cancel" button.
-     */
-    actionBarView;
-    /**
-     * Tracks information about the DOM focus in the list.
-     */
-    focusTracker;
-    /**
-     * An instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
-     */
-    keystrokes;
-    /**
-     * A collection of views that can be focused in the view.
-     *
-     * @readonly
-     */
-    _focusables;
-    /**
-     * A reference to the configuration of {@link #colorPickerView}. `false` when the view was
-     * configured without a color picker.
-     *
-     * @readonly
-     */
-    _colorPickerViewConfig;
-    /**
-     * Creates an instance of the view.
-     *
-     * @param locale The localization services instance.
-     * @param options Constructor options.
-     * @param options.focusTracker Tracks information about the DOM focus in the list.
-     * @param options.focusables A collection of views that can be focused in the view.
-     * @param options.keystrokes An instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
-     * @param options.colorPickerViewConfig The configuration of color picker feature. If set to `false`, the color picker
-     * will not be rendered.
-     */
-    constructor(locale, { focusTracker, focusables, keystrokes, colorPickerViewConfig }) {
-        super(locale);
-        this.items = this.createCollection();
-        this.focusTracker = focusTracker;
-        this.keystrokes = keystrokes;
-        this.set('isVisible', false);
-        this.set('selectedColor', undefined);
-        this._focusables = focusables;
-        this._colorPickerViewConfig = colorPickerViewConfig;
-        const bind = this.bindTemplate;
-        const { saveButtonView, cancelButtonView } = this._createActionButtons();
-        this.saveButtonView = saveButtonView;
-        this.cancelButtonView = cancelButtonView;
-        this.actionBarView = this._createActionBarView({ saveButtonView, cancelButtonView });
-        this.setTemplate({
-            tag: 'div',
-            attributes: {
-                class: [
-                    'ck-color-picker-fragment',
-                    bind.if('isVisible', 'ck-hidden', value => !value)
-                ]
-            },
-            children: this.items
-        });
-    }
-    /**
-     * @inheritDoc
-     */
-    render() {
-        super.render();
-        const colorPickerView = new ColorPickerView(this.locale, {
-            ...this._colorPickerViewConfig
-        });
-        this.colorPickerView = colorPickerView;
-        this.colorPickerView.render();
-        if (this.selectedColor) {
-            colorPickerView.color = this.selectedColor;
-        }
-        this.listenTo(this, 'change:selectedColor', (evt, name, value) => {
-            colorPickerView.color = value;
-        });
-        this.items.add(this.colorPickerView);
-        this.items.add(this.actionBarView);
-        this._addColorPickersElementsToFocusTracker();
-        this._stopPropagationOnArrowsKeys();
-        this._executeOnEnterPress();
-        this._executeUponColorChange();
-    }
-    /**
-     * @inheritDoc
-     */
-    destroy() {
-        super.destroy();
-    }
-    /**
-     * Focuses the color picker.
-     */
-    focus() {
-        this.colorPickerView.focus();
-    }
-    /**
-     * Reset validation messages.
-     */
-    resetValidationStatus() {
-        this.colorPickerView.resetValidationStatus();
-    }
-    /**
-     * When color picker is focused and "enter" is pressed it executes command.
-     */
-    _executeOnEnterPress() {
-        this.keystrokes.set('enter', evt => {
-            if (this.isVisible && this.focusTracker.focusedElement !== this.cancelButtonView.element && this.colorPickerView.isValid()) {
-                this.fire('execute', {
-                    value: this.selectedColor
-                });
-                evt.stopPropagation();
-                evt.preventDefault();
-            }
-        });
-    }
-    /**
-     * Removes default behavior of arrow keys in dropdown.
-     */
-    _stopPropagationOnArrowsKeys() {
-        const stopPropagation = (data) => data.stopPropagation();
-        this.keystrokes.set('arrowright', stopPropagation);
-        this.keystrokes.set('arrowleft', stopPropagation);
-        this.keystrokes.set('arrowup', stopPropagation);
-        this.keystrokes.set('arrowdown', stopPropagation);
-    }
-    /**
-     * Adds color picker elements to focus tracker.
-     */
-    _addColorPickersElementsToFocusTracker() {
-        for (const slider of this.colorPickerView.slidersView) {
-            this.focusTracker.add(slider.element);
-            this._focusables.add(slider);
-        }
-        const input = this.colorPickerView.hexInputRow.children.get(1);
-        if (input.element) {
-            this.focusTracker.add(input.element);
-            this._focusables.add(input);
-        }
-        this.focusTracker.add(this.saveButtonView.element);
-        this._focusables.add(this.saveButtonView);
-        this.focusTracker.add(this.cancelButtonView.element);
-        this._focusables.add(this.cancelButtonView);
-    }
-    /**
-     * Creates bar containing "Save" and "Cancel" buttons.
-     */
-    _createActionBarView({ saveButtonView, cancelButtonView }) {
-        const actionBarRow = new View();
-        const children = this.createCollection();
-        children.add(saveButtonView);
-        children.add(cancelButtonView);
-        actionBarRow.setTemplate({
-            tag: 'div',
-            attributes: {
-                class: [
-                    'ck',
-                    'ck-color-selector_action-bar'
-                ]
-            },
-            children
-        });
-        return actionBarRow;
-    }
-    /**
-     * Creates "Save" and "Cancel" buttons.
-     */
-    _createActionButtons() {
-        const locale = this.locale;
-        const t = locale.t;
-        const saveButtonView = new ButtonView(locale);
-        const cancelButtonView = new ButtonView(locale);
-        saveButtonView.set({
-            icon: IconCheck,
-            class: 'ck-button-save',
-            type: 'button',
-            withText: false,
-            label: t('Accept')
-        });
-        cancelButtonView.set({
-            icon: IconCancel,
-            class: 'ck-button-cancel',
-            type: 'button',
-            withText: false,
-            label: t('Cancel')
-        });
-        saveButtonView.on('execute', () => {
-            if (this.colorPickerView.isValid()) {
-                this.fire('execute', {
-                    source: 'colorPickerSaveButton',
-                    value: this.selectedColor
-                });
-            }
-        });
-        cancelButtonView.on('execute', () => {
-            this.fire('colorPicker:cancel');
-        });
-        return {
-            saveButtonView, cancelButtonView
-        };
-    }
-    /**
-     * Fires the `execute` event if color in color picker has been changed
-     * by the user.
-     */
-    _executeUponColorChange() {
-        this.colorPickerView.on('colorSelected', (evt, data) => {
-            this.fire('execute', {
-                value: data.color,
-                source: 'colorPicker'
-            });
-            this.set('selectedColor', data.color);
-        });
-    }
-}