@ckeditor/ckeditor5-ui 35.2.1 → 35.3.0

package/src/componentfactory.js

@@ -2,13 +2,10 @@
  * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /**
  * @module ui/componentfactory
  */
-
 import CKEditorError from '@ckeditor/ckeditor5-utils/src/ckeditorerror';
-
 /**
  * A helper class implementing the UI component ({@link module:ui/view~View view}) factory.
  *
@@ -32,101 +29,90 @@ import CKEditorError from '@ckeditor/ckeditor5-utils/src/ckeditorerror';
  * function when {@link module:ui/componentfactory~ComponentFactory#create} is called.
  */
 export default class ComponentFactory {
-	/**
-	 * Creates an instance of the factory.
-	 *
-	 * @constructor
-	 * @param {module:core/editor/editor~Editor} editor The editor instance.
-	 */
-	constructor( editor ) {
-		/**
-		 * The editor instance that the factory belongs to.
-		 *
-		 * @readonly
-		 * @member {module:core/editor/editor~Editor}
-		 */
-		this.editor = editor;
-
-		/**
-		 * Registered component factories.
-		 *
-		 * @private
-		 * @member {Map}
-		 */
-		this._components = new Map();
-	}
-
-	/**
-	 * Returns an iterator of registered component names. Names are returned in lower case.
-	 *
-	 * @returns {Iterable.<String>}
-	 */
-	* names() {
-		for ( const value of this._components.values() ) {
-			yield value.originalName;
-		}
-	}
-
-	/**
-	 * Registers a component factory function that will be used by the
-	 * {@link #create create} method and called with the
-	 * {@link module:core/editor/editor~Editor#locale editor locale} as an argument,
-	 * allowing localization of the {@link module:ui/view~View view}.
-	 *
-	 * @param {String} name The name of the component.
-	 * @param {Function} callback The callback that returns the component.
-	 */
-	add( name, callback ) {
-		this._components.set( getNormalized( name ), { callback, originalName: name } );
-	}
-
-	/**
-	 * Creates an instance of a component registered in the factory under a specific name.
-	 *
-	 * When called, the {@link module:core/editor/editor~Editor#locale editor locale} is passed to
-	 * the previously {@link #add added} factory function, allowing localization of the
-	 * {@link module:ui/view~View view}.
-	 *
-	 * @param {String} name The name of the component.
-	 * @returns {module:ui/view~View} The instantiated component view.
-	 */
-	create( name ) {
-		if ( !this.has( name ) ) {
-			/**
-			 * The required component is not registered in the component factory. Please make sure
-			 * the provided name is correct and the component has been correctly
-			 * {@link #add added} to the factory.
-			 *
-			 * @error componentfactory-item-missing
-			 * @param {String} name The name of the missing component.
-			 */
-			throw new CKEditorError(
-				'componentfactory-item-missing',
-				this,
-				{ name }
-			);
-		}
-
-		return this._components.get( getNormalized( name ) ).callback( this.editor.locale );
-	}
-
-	/**
-	 * Checks if a component of a given name is registered in the factory.
-	 *
-	 * @param {String} name The name of the component.
-	 * @returns {Boolean}
-	 */
-	has( name ) {
-		return this._components.has( getNormalized( name ) );
-	}
+    /**
+     * Creates an instance of the factory.
+     *
+     * @constructor
+     * @param {module:core/editor/editor~Editor} editor The editor instance.
+     */
+    constructor(editor) {
+        /**
+         * The editor instance that the factory belongs to.
+         *
+         * @readonly
+         * @member {module:core/editor/editor~Editor}
+         */
+        this.editor = editor;
+        /**
+         * Registered component factories.
+         *
+         * @private
+         * @member {Map}
+         */
+        this._components = new Map();
+    }
+    /**
+     * Returns an iterator of registered component names. Names are returned in lower case.
+     *
+     * @returns {Iterable.<String>}
+     */
+    *names() {
+        for (const value of this._components.values()) {
+            yield value.originalName;
+        }
+    }
+    /**
+     * Registers a component factory function that will be used by the
+     * {@link #create create} method and called with the
+     * {@link module:core/editor/editor~Editor#locale editor locale} as an argument,
+     * allowing localization of the {@link module:ui/view~View view}.
+     *
+     * @param {String} name The name of the component.
+     * @param {Function} callback The callback that returns the component.
+     */
+    add(name, callback) {
+        this._components.set(getNormalized(name), { callback, originalName: name });
+    }
+    /**
+     * Creates an instance of a component registered in the factory under a specific name.
+     *
+     * When called, the {@link module:core/editor/editor~Editor#locale editor locale} is passed to
+     * the previously {@link #add added} factory function, allowing localization of the
+     * {@link module:ui/view~View view}.
+     *
+     * @param {String} name The name of the component.
+     * @returns {module:ui/view~View} The instantiated component view.
+     */
+    create(name) {
+        if (!this.has(name)) {
+            /**
+             * The required component is not registered in the component factory. Please make sure
+             * the provided name is correct and the component has been correctly
+             * {@link #add added} to the factory.
+             *
+             * @error componentfactory-item-missing
+             * @param {String} name The name of the missing component.
+             */
+            throw new CKEditorError('componentfactory-item-missing', this, { name });
+        }
+        return this._components.get(getNormalized(name)).callback(this.editor.locale);
+    }
+    /**
+     * Checks if a component of a given name is registered in the factory.
+     *
+     * @param {String} name The name of the component.
+     * @returns {Boolean}
+     */
+    has(name) {
+        return this._components.has(getNormalized(name));
+    }
 }
-
 //
 // Ensures that the component name used as the key in the internal map is in lower case.
 //
 // @private
 // @param {String} name
 // @returns {String}
-function getNormalized( name ) {
-	return String( name ).toLowerCase();
+function getNormalized(name) {
+    return String(name).toLowerCase();
 }

package/src/dropdown/button/dropdownbutton.js

@@ -0,0 +1,5 @@
+/**
+ * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+export {};

package/src/dropdown/button/dropdownbuttonview.js

@@ -2,16 +2,12 @@
  * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /**
  * @module ui/dropdown/button/dropdownbuttonview
  */
-
 import ButtonView from '../../button/buttonview';
-
 import dropdownArrowIcon from '../../../theme/icons/dropdown-arrow.svg';
 import IconView from '../../icon/iconview';
-
 /**
  * The default dropdown button view class.
  *
@@ -33,57 +29,48 @@ import IconView from '../../icon/iconview';
  * @extends module:ui/button/buttonview~ButtonView
  */
 export default class DropdownButtonView extends ButtonView {
-	/**
-	 * @inheritDoc
-	 */
-	constructor( locale ) {
-		super( locale );
-
-		/**
-		 * An icon that displays arrow to indicate a dropdown button.
-		 *
-		 * @readonly
-		 * @member {module:ui/icon/iconview~IconView}
-		 */
-		this.arrowView = this._createArrowView();
-
-		this.extendTemplate( {
-			attributes: {
-				'aria-haspopup': true,
-				'aria-expanded': this.bindTemplate.to( 'isOn', value => String( value ) )
-			}
-		} );
-
-		// The DropdownButton interface expects the open event upon which will open the dropdown.
-		this.delegate( 'execute' ).to( this, 'open' );
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	render() {
-		super.render();
-
-		this.children.add( this.arrowView );
-	}
-
-	/**
-	 * Creates a {@link module:ui/icon/iconview~IconView} instance as {@link #arrowView}.
-	 *
-	 * @private
-	 * @returns {module:ui/icon/iconview~IconView}
-	 */
-	_createArrowView() {
-		const arrowView = new IconView();
-
-		arrowView.content = dropdownArrowIcon;
-
-		arrowView.extendTemplate( {
-			attributes: {
-				class: 'ck-dropdown__arrow'
-			}
-		} );
-
-		return arrowView;
-	}
+    /**
+     * @inheritDoc
+     */
+    constructor(locale) {
+        super(locale);
+        /**
+         * An icon that displays arrow to indicate a dropdown button.
+         *
+         * @readonly
+         * @member {module:ui/icon/iconview~IconView}
+         */
+        this.arrowView = this._createArrowView();
+        this.extendTemplate({
+            attributes: {
+                'aria-haspopup': true,
+                'aria-expanded': this.bindTemplate.to('isOn', value => String(value))
+            }
+        });
+        // The DropdownButton interface expects the open event upon which will open the dropdown.
+        this.delegate('execute').to(this, 'open');
+    }
+    /**
+     * @inheritDoc
+     */
+    render() {
+        super.render();
+        this.children.add(this.arrowView);
+    }
+    /**
+     * Creates a {@link module:ui/icon/iconview~IconView} instance as {@link #arrowView}.
+     *
+     * @private
+     * @returns {module:ui/icon/iconview~IconView}
+     */
+    _createArrowView() {
+        const arrowView = new IconView();
+        arrowView.content = dropdownArrowIcon;
+        arrowView.extendTemplate({
+            attributes: {
+                class: 'ck-dropdown__arrow'
+            }
+        });
+        return arrowView;
+    }
 }