Changeset 63600 for trunk/src/js/_enqueues/lib/admin-bar.js

Timestamp:

09/11/2026 10:50:50 AM (12 hours ago)

Author:

afercia

Message:

General: Fix indentation and alignments in JavaScript inline documentation blocks.

Enables the following JSDoc rules:

• jsdoc/check-alignment
• jsdoc/check-indentation
• jsdoc/check-line-alignment
• jsdoc/require-hyphen-before-param-description -> never

Fixes all the reported violations. Also removes hyphens before descriptions.

Part of the effort to improve JS inline documentation for 7.2.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/13490

Props afercia, mukesh27.
See #66033.

File:

• trunk/src/js/_enqueues/lib/admin-bar.js (modified) (5 diffs)

trunk/src/js/_enqueues/lib/admin-bar.js

@@ -175 +175 @@
          *
          * @param {NodeList} topMenuItems All menu items.
-         * @param {Event} event The click event.
+         * @param {Event}    event        The click event.
          */
         function mobileHover( topMenuItems, event ) {
@@ -261 +261 @@
          * @since 5.3.1
          *
-         * @param {HTMLElement} element The HTML element.
+         * @param {HTMLElement} element   The HTML element.
          * @param {string}      className The class name.
          * @return {boolean} Whether the element has the className.
@@ -287 +287 @@
          * @since 5.3.1
          *
-         * @param {HTMLElement} element The HTML element.
+         * @param {HTMLElement} element   The HTML element.
          * @param {string}      className The class name.
          */
@@ -316 +316 @@
          * @since 5.3.1
          *
-         * @param {HTMLElement} element The HTML element.
+         * @param {HTMLElement} element   The HTML element.
          * @param {string}      className The class name.
          */
@@ -396 +396 @@
          * @since 5.3.1
          *
-         * @param {HTMLElement} el Element to get parent.
-         * @param {string} selector CSS selector to match.
+         * @param {HTMLElement} el       Element to get parent.
+         * @param {string}      selector CSS selector to match.
          *
          * @return {HTMLElement|null} The closest matching element or null if not found.