@ckeditor/ckeditor5-ui 34.1.0 → 35.0.1

package/lang/translations/ur.po

@@ -16,17 +16,17 @@ msgstr ""
 "Language: ur\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-msgctxt "Title of the CKEditor5 editor."
-msgid "Rich Text Editor, %0"
-msgstr ""
-
 msgctxt "Title of the CKEditor5 editor."
 msgid "Rich Text Editor"
-msgstr ""
+msgstr "خانۂ ترمیم"
+
+msgctxt "Accessible label of the specific editing area belonging to a container with an ARIA application role."
+msgid "Editor editing area: %0"
+msgstr "رقبہ خانۂ ترمیم: 0%"
 
 msgctxt "Label of the block toolbar icon (a block toolbar is displayed next to each paragraph, heading, list item, etc. and contains e.g. block formatting options)"
 msgid "Edit block"
-msgstr ""
+msgstr "خانہ کی تدوین"
 
 msgctxt "Label for a button showing the next thing (tab, page, etc.)."
 msgid "Next"
@@ -38,7 +38,7 @@ msgstr "پچھلا"
 
 msgctxt "Label used by assistive technologies describing a generic editor toolbar."
 msgid "Editor toolbar"
-msgstr ""
+msgstr "ایڈیٹر آلہ جات"
 
 msgctxt "Label used by assistive technologies describing a toolbar displayed inside a dropdown."
 msgid "Dropdown toolbar"
@@ -46,60 +46,60 @@ msgstr "آلہ جات برائے فہرست "
 
 msgctxt "Label of a button that applies a black color in color pickers."
 msgid "Black"
-msgstr ""
+msgstr "سیاہ"
 
 msgctxt "Label of a button that applies a dim grey color in color pickers."
 msgid "Dim grey"
-msgstr ""
+msgstr "پھیکا سرمئی"
 
 msgctxt "Label of a button that applies a grey color in color pickers."
 msgid "Grey"
-msgstr ""
+msgstr "سرمئی"
 
 msgctxt "Label of a button that applies a light grey color in color pickers."
 msgid "Light grey"
-msgstr ""
+msgstr "ہلکا سرمئی"
 
 msgctxt "Label of a button that applies a white color in color pickers."
 msgid "White"
-msgstr ""
+msgstr "سفید"
 
 msgctxt "Label of a button that applies a red color in color pickers."
 msgid "Red"
-msgstr ""
+msgstr "سرخ"
 
 msgctxt "Label of a button that applies a orange color in color pickers."
 msgid "Orange"
-msgstr ""
+msgstr "نارنجی"
 
 msgctxt "Label of a button that applies a yellow color in color pickers."
 msgid "Yellow"
-msgstr ""
+msgstr "پیلا"
 
 msgctxt "Label of a button that applies a light green color in color pickers."
 msgid "Light green"
-msgstr ""
+msgstr "ہلکا سبز"
 
 msgctxt "Label of a button that applies a green color in color pickers."
 msgid "Green"
-msgstr ""
+msgstr "سبز"
 
 msgctxt "Label of a button that applies a aquamarine color in color pickers."
 msgid "Aquamarine"
-msgstr ""
+msgstr "نیلگوں بلور"
 
 msgctxt "Label of a button that applies a turquoise color in color pickers."
 msgid "Turquoise"
-msgstr ""
+msgstr "فیروزی"
 
 msgctxt "Label of a button that applies a light blue color in color pickers."
 msgid "Light blue"
-msgstr ""
+msgstr "ہلکا نیلا"
 
 msgctxt "Label of a button that applies a blue color in color pickers."
 msgid "Blue"
-msgstr ""
+msgstr "نیلا"
 
 msgctxt "Label of a button that applies a purple color in color pickers."
 msgid "Purple"
-msgstr ""
+msgstr "ارغوانی"

package/lang/translations/uz.po

@@ -16,14 +16,14 @@ msgstr ""
 "Language: uz\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
 
-msgctxt "Title of the CKEditor5 editor."
-msgid "Rich Text Editor, %0"
-msgstr "Tahrirlovchi, %0"
-
 msgctxt "Title of the CKEditor5 editor."
 msgid "Rich Text Editor"
 msgstr "Tahrirlovchi"
 
+msgctxt "Accessible label of the specific editing area belonging to a container with an ARIA application role."
+msgid "Editor editing area: %0"
+msgstr ""
+
 msgctxt "Label of the block toolbar icon (a block toolbar is displayed next to each paragraph, heading, list item, etc. and contains e.g. block formatting options)"
 msgid "Edit block"
 msgstr "Blokni tahrirlash"

package/lang/translations/vi.po

@@ -16,14 +16,14 @@ msgstr ""
 "Language: vi\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
 
-msgctxt "Title of the CKEditor5 editor."
-msgid "Rich Text Editor, %0"
-msgstr "Trình soạn thảo văn bản, %0"
-
 msgctxt "Title of the CKEditor5 editor."
 msgid "Rich Text Editor"
 msgstr "Trình soạn thảo văn bản"
 
+msgctxt "Accessible label of the specific editing area belonging to a container with an ARIA application role."
+msgid "Editor editing area: %0"
+msgstr "Vùng chỉnh sửa của trình chỉnh sửa: %0"
+
 msgctxt "Label of the block toolbar icon (a block toolbar is displayed next to each paragraph, heading, list item, etc. and contains e.g. block formatting options)"
 msgid "Edit block"
 msgstr "Chỉnh sửa đoạn"

package/lang/translations/zh-cn.po

@@ -16,14 +16,14 @@ msgstr ""
 "Language: zh_CN\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
 
-msgctxt "Title of the CKEditor5 editor."
-msgid "Rich Text Editor, %0"
-msgstr "富文本编辑器， %0"
-
 msgctxt "Title of the CKEditor5 editor."
 msgid "Rich Text Editor"
 msgstr "富文本编辑器"
 
+msgctxt "Accessible label of the specific editing area belonging to a container with an ARIA application role."
+msgid "Editor editing area: %0"
+msgstr "编辑器编辑区域：%0"
+
 msgctxt "Label of the block toolbar icon (a block toolbar is displayed next to each paragraph, heading, list item, etc. and contains e.g. block formatting options)"
 msgid "Edit block"
 msgstr "编辑框"

package/lang/translations/zh.po

@@ -16,14 +16,14 @@ msgstr ""
 "Language: zh_TW\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
 
-msgctxt "Title of the CKEditor5 editor."
-msgid "Rich Text Editor, %0"
-msgstr "豐富文字編輯器，%0"
-
 msgctxt "Title of the CKEditor5 editor."
 msgid "Rich Text Editor"
 msgstr "豐富文字編輯器"
 
+msgctxt "Accessible label of the specific editing area belonging to a container with an ARIA application role."
+msgid "Editor editing area: %0"
+msgstr "編輯器編輯區：%0"
+
 msgctxt "Label of the block toolbar icon (a block toolbar is displayed next to each paragraph, heading, list item, etc. and contains e.g. block formatting options)"
 msgid "Edit block"
 msgstr "編輯區塊"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-ui",
-  "version": "34.1.0",
+  "version": "35.0.1",
   "description": "The UI framework and standard UI library of CKEditor 5.",
   "keywords": [
     "ckeditor",
@@ -11,27 +11,27 @@
   ],
   "main": "src/index.js",
   "dependencies": {
-    "@ckeditor/ckeditor5-utils": "^34.1.0",
-    "@ckeditor/ckeditor5-core": "^34.1.0",
+    "@ckeditor/ckeditor5-utils": "^35.0.1",
+    "@ckeditor/ckeditor5-core": "^35.0.1",
     "lodash-es": "^4.17.15"
   },
   "devDependencies": {
-    "@ckeditor/ckeditor5-basic-styles": "^34.1.0",
-    "@ckeditor/ckeditor5-block-quote": "^34.1.0",
-    "@ckeditor/ckeditor5-editor-balloon": "^34.1.0",
-    "@ckeditor/ckeditor5-editor-classic": "^34.1.0",
-    "@ckeditor/ckeditor5-engine": "^34.1.0",
-    "@ckeditor/ckeditor5-enter": "^34.1.0",
-    "@ckeditor/ckeditor5-essentials": "^34.1.0",
-    "@ckeditor/ckeditor5-heading": "^34.1.0",
-    "@ckeditor/ckeditor5-image": "^34.1.0",
-    "@ckeditor/ckeditor5-link": "^34.1.0",
-    "@ckeditor/ckeditor5-list": "^34.1.0",
-    "@ckeditor/ckeditor5-mention": "^34.1.0",
-    "@ckeditor/ckeditor5-paragraph": "^34.1.0",
-    "@ckeditor/ckeditor5-horizontal-line": "^34.1.0",
-    "@ckeditor/ckeditor5-table": "^34.1.0",
-    "@ckeditor/ckeditor5-typing": "^34.1.0"
+    "@ckeditor/ckeditor5-basic-styles": "^35.0.1",
+    "@ckeditor/ckeditor5-block-quote": "^35.0.1",
+    "@ckeditor/ckeditor5-editor-balloon": "^35.0.1",
+    "@ckeditor/ckeditor5-editor-classic": "^35.0.1",
+    "@ckeditor/ckeditor5-engine": "^35.0.1",
+    "@ckeditor/ckeditor5-enter": "^35.0.1",
+    "@ckeditor/ckeditor5-essentials": "^35.0.1",
+    "@ckeditor/ckeditor5-heading": "^35.0.1",
+    "@ckeditor/ckeditor5-image": "^35.0.1",
+    "@ckeditor/ckeditor5-link": "^35.0.1",
+    "@ckeditor/ckeditor5-list": "^35.0.1",
+    "@ckeditor/ckeditor5-mention": "^35.0.1",
+    "@ckeditor/ckeditor5-paragraph": "^35.0.1",
+    "@ckeditor/ckeditor5-horizontal-line": "^35.0.1",
+    "@ckeditor/ckeditor5-table": "^35.0.1",
+    "@ckeditor/ckeditor5-typing": "^35.0.1"
   },
   "engines": {
     "node": ">=14.0.0",
@@ -50,6 +50,7 @@
     "lang",
     "src",
     "theme",
-    "ckeditor5-metadata.json"
+    "ckeditor5-metadata.json",
+    "CHANGELOG.md"
   ]
 }

package/src/button/buttonview.js

@@ -13,6 +13,7 @@ import TooltipView from '../tooltip/tooltipview';
 
 import uid from '@ckeditor/ckeditor5-utils/src/uid';
 import { getEnvKeystrokeText } from '@ckeditor/ckeditor5-utils/src/keyboard';
+import env from '@ckeditor/ckeditor5-utils/src/env';
 
 import '../../theme/components/button/button.css';
 
@@ -127,7 +128,7 @@ export default class ButtonView extends View {
 			this._getTooltipString.bind( this )
 		);
 
-		this.setTemplate( {
+		const template = {
 			tag: 'button',
 
 			attributes: {
@@ -145,16 +146,12 @@ export default class ButtonView extends View {
 				tabindex: bind.to( 'tabindex' ),
 				'aria-labelledby': `ck-editor__aria-label_${ ariaLabelUid }`,
 				'aria-disabled': bind.if( 'isEnabled', true, value => !value ),
-				'aria-pressed': bind.to( 'isOn', value => this.isToggleable ? String( value ) : false )
+				'aria-pressed': bind.to( 'isOn', value => this.isToggleable ? String( !!value ) : false )
 			},
 
 			children: this.children,
 
 			on: {
-				mousedown: bind.to( evt => {
-					evt.preventDefault();
-				} ),
-
 				click: bind.to( evt => {
 					// We can't make the button disabled using the disabled attribute, because it won't be focusable.
 					// Though, shouldn't this condition be moved to the button controller?
@@ -167,7 +164,18 @@ export default class ButtonView extends View {
 					}
 				} )
 			}
-		} );
+		};
+
+		// On Safari we have to force the focus on a button on click as it's the only browser
+		// that doesn't do that automatically. See #12115.
+		if ( env.isSafari ) {
+			template.on.mousedown = bind.to( evt => {
+				this.focus();
+				evt.preventDefault();
+			} );
+		}
+
+		this.setTemplate( template );
 	}
 
 	/**

package/src/dropdown/button/splitbuttonview.js

@@ -229,6 +229,8 @@ export default class SplitButtonView extends View {
 		} );
 
 		arrowView.bind( 'isEnabled' ).to( this );
+		arrowView.bind( 'label' ).to( this );
+		arrowView.bind( 'tooltip' ).to( this );
 
 		arrowView.delegate( 'execute' ).to( this, 'open' );
 

package/src/dropdown/dropdownpanelview.js

@@ -8,6 +8,7 @@
  */
 
 import View from '../view';
+import { logWarning } from '@ckeditor/ckeditor5-utils/src/ckeditorerror';
 
 /**
  * The dropdown panel view class.
@@ -81,13 +82,32 @@ export default class DropdownPanelView extends View {
 	}
 
 	/**
-	 * Focuses the view element or first item in view collection on opening dropdown's panel.
+	 * Focuses the first view in the {@link #children} collection.
 	 *
 	 * See also {@link module:ui/dropdown/dropdownpanelfocusable~DropdownPanelFocusable}.
 	 */
 	focus() {
 		if ( this.children.length ) {
-			this.children.first.focus();
+			if ( typeof this.children.first.focus === 'function' ) {
+				this.children.first.focus();
+			} else {
+				/**
+				 * The child view of a dropdown could not be focused because it is missing the `focus()` method.
+				 *
+				 * This warning appears when a dropdown {@link module:ui/dropdown/dropdownview~DropdownView#isOpen gets open} and it
+				 * attempts to focus the {@link module:ui/dropdown/dropdownpanelview~DropdownPanelView#children first child} of its panel
+				 * but the child does not implement the
+				 * {@link module:ui/dropdown/dropdownpanelfocusable~DropdownPanelFocusable focusable interface}.
+				 *
+				 * Focusing the content of a dropdown on open greatly improves the accessibility. Please make sure the view instance
+				 * provides the `focus()` method for the best user experience.
+				 *
+				 * @error ui-dropdown-panel-focus-child-missing-focus
+				 * @param {module:ui/view~View} childView
+				 * @param {module:ui/dropdown/dropdownpanelview~DropdownPanelView} dropdownPanel
+				 */
+				logWarning( 'ui-dropdown-panel-focus-child-missing-focus', { childView: this.children.first, dropdownPanel: this } );
+			}
 		}
 	}
 

package/src/dropdown/dropdownview.js

@@ -106,6 +106,10 @@ export default class DropdownView extends View {
 		/**
 		 * Controls whether the dropdown view is open, i.e. shows or hides the {@link #panelView panel}.
 		 *
+		 * **Note**: When the dropdown gets open, it will attempt to call `focus()` on the first child of its {@link #panelView}.
+		 * See {@link module:ui/dropdown/utils~addToolbarToDropdown}, {@link module:ui/dropdown/utils~addListToDropdown}, and
+		 * {@link module:ui/dropdown/utils~focusChildOnDropdownOpen} to learn more about focus management in dropdowns.
+		 *
 		 * @observable
 		 * @member {Boolean} #isOpen
 		 */
@@ -248,6 +252,9 @@ export default class DropdownView extends View {
 		// be updated every time the dropdown is open.
 		this.on( 'change:isOpen', () => {
 			if ( !this.isOpen ) {
+				// If the dropdown was closed, move the focus back to the button (#12125).
+				this.focus();
+
 				return;
 			}
 
@@ -263,6 +270,9 @@ export default class DropdownView extends View {
 			} else {
 				this.panelView.position = this.panelPosition;
 			}
+
+			// Focus the first item in the dropdown when the dropdown opened
+			this.panelView.focus();
 		} );
 
 		// Listen for keystrokes coming from within #element.
@@ -270,7 +280,6 @@ export default class DropdownView extends View {
 
 		const closeDropdown = ( data, cancel ) => {
 			if ( this.isOpen ) {
-				this.buttonView.focus();
 				this.isOpen = false;
 				cancel();
 			}

package/src/dropdown/utils.js

@@ -19,6 +19,8 @@ import SwitchButtonView from '../button/switchbuttonview';
 
 import clickOutsideHandler from '../bindings/clickoutsidehandler';
 
+import { logWarning } from '@ckeditor/ckeditor5-utils/src/ckeditorerror';
+
 import '../../theme/components/dropdown/toolbardropdown.css';
 import '../../theme/components/dropdown/listdropdown.css';
 
@@ -123,12 +125,22 @@ export function createDropdown( locale, ButtonClass = DropdownButtonView ) {
  *		dropdown.render()
  *		document.body.appendChild( dropdown.element );
  *
+ * **Note:** To improve the accessibility, you can tell the dropdown to focus the first active button of the toolbar when the dropdown
+ * {@link module:ui/dropdown/dropdownview~DropdownView#isOpen gets open}. See the documentation of `options` to learn more.
+ *
  * See {@link module:ui/dropdown/utils~createDropdown} and {@link module:ui/toolbar/toolbarview~ToolbarView}.
  *
  * @param {module:ui/dropdown/dropdownview~DropdownView} dropdownView A dropdown instance to which `ToolbarView` will be added.
  * @param {Iterable.<module:ui/button/buttonview~ButtonView>} buttons
+ * @param {Object} [options]
+ * @param {Boolean} [options.enableActiveItemFocusOnDropdownOpen=false] When set `true`, the focus will automatically move to the first
+ * active {@link module:ui/toolbar/toolbarview~ToolbarView#items item} of the toolbar upon
+ * {@link module:ui/dropdown/dropdownview~DropdownView#isOpen opening} the dropdown. Active items are those with the `isOn` property set
+ * `true` (for instance {@link module:ui/button/buttonview~ButtonView buttons}). If no active items is found, the toolbar will be focused
+ * as a whole resulting in the focus moving to its first focusable item (default behavior of
+ * {@link module:ui/dropdown/dropdownview~DropdownView}).
  */
-export function addToolbarToDropdown( dropdownView, buttons ) {
+export function addToolbarToDropdown( dropdownView, buttons, options = {} ) {
 	const locale = dropdownView.locale;
 	const t = locale.t;
 	const toolbarView = dropdownView.toolbarView = new ToolbarView( locale );
@@ -143,6 +155,11 @@ export function addToolbarToDropdown( dropdownView, buttons ) {
 
 	buttons.map( view => toolbarView.items.add( view ) );
 
+	if ( options.enableActiveItemFocusOnDropdownOpen ) {
+		// Accessibility: Focus the first active button in the toolbar when the dropdown gets open.
+		focusChildOnDropdownOpen( dropdownView, () => toolbarView.items.find( item => item.isOn ) );
+	}
+
 	dropdownView.panelView.children.add( toolbarView );
 	toolbarView.items.delegate( 'execute' ).to( dropdownView );
 }
@@ -182,6 +199,9 @@ export function addToolbarToDropdown( dropdownView, buttons ) {
  * The `items` collection passed to this methods controls the presence and attributes of respective
  * {@link module:ui/list/listitemview~ListItemView list items}.
  *
+ * **Note:** To improve the accessibility, when a list is added to the dropdown using this helper the dropdown will automatically attempt
+ * to focus the first active item (a host to a {@link module:ui/button/buttonview~ButtonView} with
+ * {@link module:ui/button/buttonview~ButtonView#isOn} set `true`) or the very first item when none are active.
  *
  * See {@link module:ui/dropdown/utils~createDropdown} and {@link module:list/list~List}.
  *
@@ -219,6 +239,56 @@ export function addListToDropdown( dropdownView, items ) {
 	dropdownView.panelView.children.add( listView );
 
 	listView.items.delegate( 'execute' ).to( dropdownView );
+
+	// Accessibility: Focus the first active button in the list when the dropdown gets open.
+	focusChildOnDropdownOpen( dropdownView, () => listView.items.find( item => {
+		if ( item instanceof ListItemView ) {
+			return item.children.first.isOn;
+		}
+
+		return false;
+	} ) );
+}
+
+/**
+ * A helper to be used on an existing {@link module:ui/dropdown/dropdownview~DropdownView} that focuses
+ * a specific child in DOM when the dropdown {@link module:ui/dropdown/dropdownview~DropdownView#isOpen gets open}.
+ *
+ * @param {module:ui/dropdown/dropdownview~DropdownView} dropdownView A dropdown instance to which the focus behavior will be added.
+ * @param {Function} childSelectorCallback A callback executed when the dropdown gets open. It should return a {@link module:ui/view~View}
+ * instance (child of {@link module:ui/dropdown/dropdownview~DropdownView#panelView}) that will get focused or a falsy value.
+ * If falsy value is returned, a default behavior of the dropdown will engage focusing the first focusable child in
+ * the {@link module:ui/dropdown/dropdownview~DropdownView#panelView}.
+ */
+export function focusChildOnDropdownOpen( dropdownView, childSelectorCallback ) {
+	dropdownView.on( 'change:isOpen', () => {
+		if ( !dropdownView.isOpen ) {
+			return;
+		}
+
+		const childToFocus = childSelectorCallback();
+
+		if ( !childToFocus ) {
+			return;
+		}
+
+		if ( typeof childToFocus.focus === 'function' ) {
+			childToFocus.focus();
+		} else {
+			/**
+			 * The child view of a {@link module:ui/dropdown/dropdownview~DropdownView dropdown} is missing the `focus()` method
+			 * and could not be focused when the dropdown got {@link module:ui/dropdown/dropdownview~DropdownView#isOpen open}.
+			 *
+			 * Making the content of a dropdown focusable in this case greatly improves the accessibility. Please make the view instance
+			 * implements the {@link module:ui/dropdown/dropdownpanelfocusable~DropdownPanelFocusable focusable interface} for the best user
+			 * experience.
+			 *
+			 * @error ui-dropdown-focus-child-on-open-child-missing-focus
+			 * @param {module:ui/view~View} view
+			 */
+			logWarning( 'ui-dropdown-focus-child-on-open-child-missing-focus', { view: childToFocus } );
+		}
+	}, { priority: 'low' } );
 }
 
 // Add a set of default behaviors to dropdown view.

package/src/editableui/inline/inlineeditableuiview.js

@@ -23,16 +23,32 @@ export default class InlineEditableUIView extends EditableUIView {
 	 * @param {HTMLElement} [editableElement] The editable element. If not specified, the
 	 * {@link module:ui/editableui/editableuiview~EditableUIView}
 	 * will create it. Otherwise, the existing element will be used.
+	 * @param {Object} [options] Additional configuration of the view.
+	 * @param {Function} [options.label] A function that gets called with the instance of this view as an argument
+	 * and should return a string that represents the label of the editable for assistive technologies. If not provided,
+	 * a default label generator is used.
 	 */
-	constructor( locale, editingView, editableElement ) {
+	constructor( locale, editingView, editableElement, options = {} ) {
 		super( locale, editingView, editableElement );
 
+		const t = locale.t;
+
 		this.extendTemplate( {
 			attributes: {
 				role: 'textbox',
 				class: 'ck-editor__editable_inline'
 			}
 		} );
+
+		/**
+		 * A function that gets called with the instance of this view as an argument and should return a string that
+		 * represents the label of the editable for assistive technologies.
+		 *
+		 * @private
+		 * @readonly
+		 * @param {Function}
+		 */
+		this._generateLabel = options.label || ( () => t( 'Editor editing area: %0', this.name ) );
 	}
 
 	/**
@@ -42,12 +58,11 @@ export default class InlineEditableUIView extends EditableUIView {
 		super.render();
 
 		const editingView = this._editingView;
-		const t = this.t;
 
 		editingView.change( writer => {
 			const viewRoot = editingView.document.getRoot( this.name );
 
-			writer.setAttribute( 'aria-label', t( 'Rich Text Editor, %0', this.name ), viewRoot );
+			writer.setAttribute( 'aria-label', this._generateLabel( this ), viewRoot );
 		} );
 	}
 }

package/src/panel/balloon/balloonpanelview.js

@@ -756,14 +756,14 @@ BalloonPanelView._getOptimalPosition = getOptimalPosition;
  * The name that the position function returns will be reflected in the balloon panel's class that
  * controls the placement of the "arrow". See {@link #position} to learn more.
  *
- * @member {Object.<String,module:utils/dom/position~positioningFunction>}
+ * @member {Object.<String,module:utils/dom/position~PositioningFunction>}
  * module:ui/panel/balloon/balloonpanelview~BalloonPanelView.defaultPositions
  */
 BalloonPanelView.defaultPositions = generatePositions();
 
 /**
  * Returns available {@link module:ui/panel/balloon/balloonpanelview~BalloonPanelView}
- * {@link module:utils/dom/position~positioningFunction positioning functions} adjusted by the specific offsets.
+ * {@link module:utils/dom/position~PositioningFunction positioning functions} adjusted by the specific offsets.
  *
  * @protected
  * @param {Object} [options] Options to generate positions. If not specified, this helper will simply return
@@ -779,8 +779,8 @@ BalloonPanelView.defaultPositions = generatePositions();
  * will be used.
  * @param {Object} [options.config] Additional configuration of the balloon balloon panel view.
  * Currently only {@link module:ui/panel/balloon/balloonpanelview~BalloonPanelView#withArrow} is supported. Learn more
- * about {@link module:utils/dom/position~positioningFunction positioning functions}.
- * @returns {Object.<String,module:utils/dom/position~positioningFunction>}
+ * about {@link module:utils/dom/position~PositioningFunction positioning functions}.
+ * @returns {Object.<String,module:utils/dom/position~PositioningFunction>}
  */
 export function generatePositions( {
 	horizontalOffset = BalloonPanelView.arrowHorizontalOffset,